Uploaded image for project: 'Jenkins'
  1. Jenkins
  2. JENKINS-27018

Provide either 'branch' or 'tag' in git step



    • Improvement
    • Status: Resolved (View Workflow)
    • Minor
    • Resolution: Won't Fix
    • pipeline
    • None



      the 'git' step is one of the most important steps implemented for workflow.

      However, there are many cases where I need to checkout the particular git tag, instead of the branch.

      currently I have to do something like:

      checkout scm: [$class: 'GitSCM', 
            userRemoteConfigs: [[url: 'git@github.com:MYCOMPANY/cd-workflow.git']], 
            branches: [[name: 'refs/tags/workflow-1.0']]], changelog: false, poll: false

      the main reason is I want to keep versioned workflow scripts on my repo and load a specific version of it. But I have also several other use cases when I need a tag from the git repository.

      The notation above is actually too long and overcomplicated. Instead, I would expect to use the code like:

      git url: 'git@github.com:MYCOMPANY/cd-workflow.git', tag: 'workflow-1.0', changelog: false, poll: false

      which is much shorter and similar to a typical git usage.

      By other words, the step might support either 'branch' or 'tag' parameter. In some rare cases it would be nice also to have possibility to checkout a particular commit.

      Would it be possible to add such a feature?


        Issue Links


            ykryshchuk Yuriy Kryshchuk created issue -
            jglick Jesse Glick made changes -
            Field Original Value New Value
            Resolution Won't Fix [ 2 ]
            Status Open [ 1 ] Resolved [ 5 ]
            jglick Jesse Glick made changes -
            Link This issue is related to JENKINS-26100 [ JENKINS-26100 ]
            rtyler R. Tyler Croy made changes -
            Workflow JNJira [ 161209 ] JNJira + In-Review [ 196683 ]
            abayer Andrew Bayer made changes -
            Component/s pipeline-general [ 21692 ]
            abayer Andrew Bayer made changes -
            Component/s workflow-plugin [ 18820 ]
            jglick Jesse Glick made changes -
            Link This issue relates to JENKINS-37227 [ JENKINS-37227 ]


              jglick Jesse Glick
              ykryshchuk Yuriy Kryshchuk
              0 Vote for this issue
              4 Start watching this issue