How to Retrieve Project Branches in Jenkins Pipelines

Hello everyone, I am Zeyang.

We present the practice titled "Jenkins Getting Project Branches".

In a Jenkins pipeline, the first step is usually to download the code. This article shows how the pipeline obtains the branch information of the code repository, which can be useful for future deployments.

First, we look at a repository that contains several branches; when releasing, we select one of these branches.

Jenkins has a plugin called git parameter插件. Search for the keyword git in the plugin manager, install it, and then restart Jenkins.

Next, obtain the project URL from GitLab and configure the branch in the Jenkins job (default is the master branch). Fill in the repository URL so Jenkins can retrieve the branch information, save the configuration, and click 参数化构建 (Parameterized Build) to see the fetched branches when everything works correctly.

If the project does not have a git checkout step configured, an error will appear (as shown in the screenshot). This occurs because the pipeline lacks the necessary Git checkout step.

To reproduce the error, remove the shared library configuration that provides Git information and save the pipeline without a Git checkout step; the error will be displayed.

The plugin conveniently retrieves project branches, but it depends on a get checkout step; without it, the parameters cannot be obtained.

Imagine a pipeline that does not download code but only needs project information for further processing. We will explore how to create a dynamic parameter to achieve the same effect in the next article.

Thank you for watching; if this was helpful, please follow, bookmark, like, and share.

About Us

DevOps Cloud Classroom is a learning platform full of new technology practices, offering open technical exchange and implementation sharing. Our courses are expanding to cover the entire DevOps workflow.

We provide open resources: DevOps open‑source practice documents, technical community, and FAQ library. Scan the QR code to follow the public account and reply "devops" to get resources for free.