如何通过Jenkins手动构建传入的参数为Docker镜像添加标签

1. 配置Jenkins参数化构建 #

• 打开目标Jenkins任务，进入「配置」页面
• 勾选「参数化构建过程」选项
• 添加字符串参数，参数名设为VERSION，可设置默认值（比如latest），补充描述说明（例如「输入镜像版本号，如1.0.2」）
• 保存任务配置

2. 在构建步骤中引用参数构建镜像 #

根据你的Jenkins构建方式，选择对应方法：

方式一：Shell脚本构建

直接在Shell执行步骤中使用${VERSION}引用参数，执行Docker构建命令：

# 按你需要的标签格式构建，比如version=${VERSION}的格式
docker build -t your-image-name:version=${VERSION} .

# 如果你需要更简洁的标签格式（如your-image-name:2.0），可以写成：
# docker build -t your-image-name:${VERSION} .

Jenkins会自动将用户触发时输入的VERSION值注入到构建环境，直接调用即可。

方式二：Jenkins Pipeline（声明式）

在Pipeline脚本中先定义参数，再在构建阶段引用：

pipeline {
    agent any
    parameters {
        string(name: 'VERSION', defaultValue: 'latest', description: '镜像版本号')
    }
    stages {
        stage('Build Docker Image') {
            steps {
                sh 'docker build -t your-image-name:version=${VERSION} .'
            }
        }
    }
}

3. 验证效果 #

手动触发Jenkins任务时，输入指定的版本号（比如2.1.1），构建完成后执行docker images命令，就能看到带有对应标签的镜像了。

内容的提问来源于stack exchange，提问作者MD NASEEM