Jenkins pipeline branch name returns null

Question

I'm trying to get the name of my branch for a jenkins groovy script. I cannot get the current branch name. I try the following:

stage('Check out code')
checkout scm
echo "My branch is: ${env.BRANCH_NAME}"

Here is the output - it always returns null.

 Checking out Revision 33b531b2f1caaf8b64d968e437306f39d2dba1da   (origin/pipeline)
  > git.exe config core.sparsecheckout # timeout=10
  > git.exe checkout -f 33b531b2f1caaf8b64d968e437306f39d2dba1da
 [Pipeline] echo
 My branch is: null

Am I missing something?

Het @pogorman - have you managed to get it worked? I am having the same issue (using normal pipeline)! — Tibin Paul, May 16 '18 at 08:00
This variable only works in a multibranch pipeline - see the answer below. I am only using multibranch pipelines now — pogorman, May 16 '18 at 20:44

score 55 · Accepted Answer · answered May 03 '17 at 22:09

This variable only works in a multibranch pipline:

BRANCH_NAME For a multibranch project, this will be set to the name of the branch being built, for example in case you wish to deploy to production from master but not from feature branches.

I was testing in a normal pipline

score 8 · Answer 2 · 2020-10-15T00:02:30.537

8

In Jenkins there is two pipeline options:

New Item -> Pipeline --> env.BRANCH_NAME return branch null
New Item -> Multibranch Pipeline --> env.BRANCH_NAME return branch master or branch name

edited Oct 15 '20 at 00:02

answered Jun 21 '20 at 13:41

score 6 · Answer 3 · edited May 23 '17 at 11:47

git.exe checkout -f 33b531b2f1caaf8b64d968e437306f39d2dba1da

That would make the git repo enter a detached HEAD mode, which, by its very nature, has no branch.

From Jenkinsfile:

The checkout step will checkout code from source control; scm is a special variable which instructs the checkout step to clone the specific revision which triggered this Pipeline run.

So the ${env.BRANCH_NAME} is null.

As mentioned in "Jenkins Workflow Checkout Accessing BRANCH_NAME and GIT_COMMIT", you can get the SHA1 you just checked out with the groovy syntax (to be adapted in a Jenkins pipeline DSL):

sh 'git rev-parse HEAD > commit'
def commit = readFile('commit').trim()

That means you could then try to guess which branch is involved from the checked out SHA1: http://stackoverflow.com/a/1419637/6309 — VonC, May 03 '17 at 21:48

score 6 · Answer 4 · answered Dec 31 '17 at 13:02

6

My workaround, Don't know if work for someone else..

def branchName = getCurrentBranch()
echo 'My branch is' + branchName

def getCurrentBranch () {
    return sh (
        script: 'git rev-parse --abbrev-ref HEAD',
        returnStdout: true
    ).trim()
}

answered Dec 31 '17 at 13:02

kitta

1,723
3
23
33

1

For me, that returns `HEAD` which is not helpful :( – M.Stramm Aug 08 '22 at 13:48

vvucetic · Answer 5 · 2020-12-11T19:59:17.657

6

In the pipeline job I'm using env.GIT_BRANCH which resolves to origin/{BRANCH}

In the case of a multibranch job, env.GIT_BRANCH resolves to {BRANCH} (no origin/).

edited Dec 11 '20 at 19:59

answered Sep 14 '20 at 12:01

vvucetic

479
7
15

score 0 · Answer 6 · answered Apr 24 '18 at 17:00

0

I had this same issue, but I resolved it by changing

println "${env.BRANCH_NAME}"

to

println "${BRANCH_NAME}"

Note my plugin is also checking out in detached mode:

git checkout -f e10a170e17fb5f9282f903a7b3cd17bd2e181dee

answered Apr 24 '18 at 17:00

sdc

2,603
1
27
40

score 0 · Answer 7 · answered Oct 28 '20 at 14:55

From a simple pipeline you can use the following script:

\\...
stage('Test') {
        steps {
            script {
                branchName = sh(label: 'getBranchName', returnStdout: true, script: 'git rev-parse --abbrev-ref HEAD').trim()
                println branchName
            }   
        }
      } 
\\...

score 0 · Answer 8 · answered Jun 10 '22 at 11:59

0

this code worked for me.

def BRANCH_NAME = getCurrentBranch()
echo 'Current branch is' + BRANCH_NAME
def getCurrentBranch () {
    return sh (
    script: 'git name-rev --name-only HEAD',
    returnStdout: true
    ).trim()
}

answered Jun 10 '22 at 11:59

Ashish Rajbanshi

13
2

This does not provide an answer to the question. Once you have sufficient [reputation](https://stackoverflow.com/help/whats-reputation) you will be able to [comment on any post](https://stackoverflow.com/help/privileges/comment); instead, [provide answers that don't require clarification from the asker](https://meta.stackexchange.com/questions/214173/why-do-i-need-50-reputation-to-comment-what-can-i-do-instead). - [From Review](/review/late-answers/31989005) – nvidot Jun 13 '22 at 00:46

score 0 · Answer 9 · answered Dec 27 '22 at 08:44

0

The following worked for me:

env.BRANCH_NAME = scm.branches[0].name

I have found this answer on Get git branch name in Jenkins Pipeline/Jenkinsfile.

answered Dec 27 '22 at 08:44

Olli

1,621
15
18

Jenkins pipeline branch name returns null

9 Answers9

Linked