如何用指定GitLab仓库镜像动态填充Jenkins Choice Parameter

1. 安装必要插件 #

先确保Jenkins已安装以下插件：

• Active Choices Plugin：用于创建动态更新的下拉参数
• Credentials Binding Plugin：安全存储GitLab访问令牌
• GitLab Plugin（可选）：简化GitLab相关集成流程

2. 创建GitLab访问凭证 #

进入Jenkins后台「凭证管理」，添加Secret text类型的凭证，内容为你的GitLab个人访问令牌（需勾选read_registry权限，确保能拉取镜像仓库信息），记录该凭证的ID后续使用。

3. 配置动态下拉参数 #

打开目标Jenkins任务的配置页面，找到「参数化构建过程」，点击「添加参数」选择「Active Choices Reactive Parameter」：

• 参数名称：例如IMAGE_TAG
• 选择「Choice Type」为「Single Select」（单选）或「Multi Select」（多选）
• 在「Script」区域选择「Groovy Script」，粘贴下方脚本并替换对应变量：

// 替换为你的GitLab实例地址（如https://gitlab.com）
def gitlabUrl = "https://your-gitlab-instance.com"
// 替换为目标项目的ID（GitLab项目主页可查看）
def projectId = "12345"
// 替换为你创建的GitLab令牌凭证ID
def credentialId = "gitlab-registry-token"

// 从Jenkins凭证中获取GitLab令牌
def token = com.cloudbees.plugins.credentials.CredentialsProvider.lookupCredentials(
    com.cloudbees.plugins.credentials.common.StandardCredentials.class,
    Jenkins.instance,
    null,
    null
).find { it.id == credentialId }.secret.toString()

// 调用GitLab API获取镜像标签列表
def apiUrl = "${gitlabUrl}/api/v4/projects/${projectId}/registry/repositories/0/tags"
def connection = new URL(apiUrl).openConnection()
connection.setRequestProperty("PRIVATE-TOKEN", token)
connection.setRequestMethod("GET")

def response = new InputStreamReader(connection.getInputStream()).text
def tags = new groovy.json.JsonSlurper().parseText(response).collect { it.name }

// 可选：按版本号倒序排序标签（可根据自身标签格式调整逻辑）
tags.sort { a, b ->
    def aParts = a.split("\\.").collect { it.toInteger() }
    def bParts = b.split("\\.").collect { it.toInteger() }
    bParts <=> aParts
}

return tags

4. 在任务中使用选中的镜像 #

配置完成后，任务后续步骤（如部署脚本、Docker命令）可直接通过${IMAGE_TAG}引用用户选择的镜像标签，示例：

docker pull your-registry-path/your-image:${IMAGE_TAG}

注意事项 #

• 若镜像仓库不是项目默认的第一个仓库（API路径中repositories/0对应第一个仓库），可通过GitLab API /projects/${projectId}/registry/repositories查询所有仓库ID并替换
• 若镜像标签数量较多，可在API URL后追加?per_page=100调整每页返回数量，或添加分页逻辑处理
• 确保GitLab令牌权限足够，私有项目还需额外勾选read_repository权限

内容的提问来源于stack exchange，提问作者Assia Khateeb