Jenkins pipeline how to change to another folder

Question

Currently i am using Jenkins pipeline script.

For running one command, I need to access a folder outside its workspace directory.

I tried sh "cd $workspace/", but it returned current workspace folder.

How I can change to root workspace directory and then cd to another folder. Please help.

score 248 · Answer 1 · answered Sep 17 '18 at 17:13

248

You can use the dir step, example:

dir("folder") {
    sh "pwd"
}

The folder can be relative or absolute path.

answered Sep 17 '18 at 17:13

tsl0922

but it will go inside that current job folder. I want to switch to jenkins workspace – wanderors Sep 17 '18 at 17:23
1

how do you go back upwards? – DanDan Jul 18 '19 at 13:57
3

@DanDan everything outside this `dir` step is 'back upwards', see also answer/example from Gonzalo Robert Diaz: https://stackoverflow.com/a/59776342/757308 – msa Mar 06 '20 at 06:50
Be aware that outside the dir the directory is resetted. It is not like `cd directory` in a shell. – kap May 26 '20 at 10:54
When I try and run sh 'git add .' inside the "folder", it throws me this error: + git add . fatal: Not a git repository (or any of the parent directories): .git – python_newbie Mar 06 '21 at 17:30

score 60 · Answer 2 · edited Feb 11 '21 at 15:10

60

The dir wrapper can wrap, any other step, and it all works inside a steps block, for example:

steps {
    sh "pwd"
    dir('your-sub-directory') {
      sh "pwd"
    }
    sh "pwd"
}

edited Feb 11 '21 at 15:10

Neuron

answered Jan 16 '20 at 19:12

score 34 · Answer 3 · edited Aug 07 '19 at 20:11

34

Use WORKSPACE environment variable to change workspace directory.

If doing using Jenkinsfile, use following code :

dir("${env.WORKSPACE}/aQA"){
    sh "pwd"
}

edited Aug 07 '19 at 20:11

Mazin Ibrahim

answered Aug 07 '19 at 17:40

Raj Bangarwa

18

`dir('aQA')` works the same way. No need for that complexity – Kirill Oct 22 '20 at 13:38
2

What if you want to make sure to run the command in the root directory of the workspace? – Mattia Rasulo Jul 29 '22 at 17:24

3 Answers3