Jenkinsfile中如何为Docker镜像打多标签并推送至自建镜像仓库

你之前配置报错是因为参数用错了位置：dockerfile agent块里的args字段是传给容器启动阶段的运行参数，不是传给docker build的构建参数。你把打标签的-t参数写到这里，会直接覆盖容器默认启动命令，导致Jenkins等不到容器内进程启动，才会抛出tmp目录下进程未启动的报错。

方案1：用dockerfile agent原生构建参数（配置最简单） #

dockerfile agent专门提供了additionalBuildArgs字段用来传递docker构建阶段的自定义参数，直接在这里配置多标签即可，不需要额外写shell命令，示例配置：

agent {
    dockerfile {
        filename 'Dockerfile'
        dir 'build/images'
        // 直接传入构建打标参数，同时打构建号、develop两个标签
        additionalBuildArgs "-t artifactory.lab.watchtower:5050/lab/rocky:${BUILD_NUMBER} -t artifactory.lab.watchtower:5050/lab/rocky:develop"
    }
}

${BUILD_NUMBER}是Jenkins内置全局环境变量，直接调用即可拿到当前任务的构建序号，不需要额外赋值。

方案2：手动控制构建全流程（灵活度最高） #

如果后续要加镜像扫描、多架构构建、条件推送之类的逻辑，不要依赖dockerfile agent的自动构建逻辑，直接指定安装了docker的构建节点，手动写命令控制构建、打标、推送全流程，示例流水线：

pipeline {
    agent { label 'docker-build-node' } // 绑定已安装docker的构建节点
    environment {
        REGISTRY = 'artifactory.lab.watchtower:5050'
        IMAGE_PATH = 'lab/rocky'
    }
    stages {
        stage('构建镜像') {
            steps {
                dir('build/images') {
                    sh """
                        docker build \
                        -t ${REGISTRY}/${IMAGE_PATH}:${BUILD_NUMBER} \
                        -t ${REGISTRY}/${IMAGE_PATH}:develop .
                    """
                }
            }
        }
        stage('推送镜像到私有仓库') {
            steps {
                // 从Jenkins凭据库拉取仓库账号密码，不要硬编码在流水线里
                withCredentials([usernamePassword(
                    credentialsId: 'private-registry-cred',
                    usernameVariable: 'REG_USER',
                    passwordVariable: 'REG_PWD'
                )]) {
                    sh 'docker login ${REGISTRY} -u ${REG_USER} -p ${REG_PWD}'
                }
                // 批量推送所有标签
                sh 'docker push ${REGISTRY}/${IMAGE_PATH}:${BUILD_NUMBER}'
                sh 'docker push ${REGISTRY}/${IMAGE_PATH}:develop'
            }
        }
    }
}

• 仓库访问凭据统一存在Jenkins凭据管理模块，通过withCredentials调用，禁止硬编码在流水线脚本里，避免账号密码泄露
• 如果私有仓库没有配置公网可信CA证书，需要在构建节点的docker配置文件/etc/docker/daemon.json里添加insecure-registries配置，把你的仓库地址加进去，重启docker后再执行构建，否则会报证书校验失败
• 建议给镜像保留不可变的构建号标签，不要只使用develop、latest这类浮动标签，方便线上出问题时快速回滚到指定版本
• 推送完成后可以增加本地镜像清理步骤，删除构建节点上的临时镜像缓存，避免长期运行占满磁盘空间
• 提前确认仓库账号对目标镜像路径有推送权限，避免推送时报403权限错误

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