Jenkins声明式流水线如何为docker run传递额外参数？

问题背景 #

你当前的声明式Jenkins流水线配置基于项目根目录的Dockerfile构建容器运行测试：

pipeline {
    agent { dockerfile { additionalBuildArgs '--network host' } }
    stages {
        stage('Test') {
            steps {
                sh 'pytest --version'
            }
        }
    }
}

你希望实现和以下脚本式流水线等价的效果——为docker run命令传递--network=host参数：

node {
    def pytestImage = docker.build('pytest-image:latest', '--network host .')
    pytestImage.inside('--network=host') {
        sh 'pytest --version'
        // other commands ...
    }
}

想确认声明式流水线是否能实现该需求，还是必须切换到脚本式？

解决方案：无需切换脚本式，声明式可直接实现 #

完全不需要切换到脚本式流水线！声明式格式支持通过agent.dockerfile.args参数指定docker run的额外参数，刚好能满足你的需求。

修改后的完整声明式Jenkinsfile如下：

pipeline {
    agent {
        dockerfile {
            additionalBuildArgs '--network host' // 对应docker build的额外参数，保留你原有的配置
            args '--network=host' // 这里就是给docker run传递的参数，和脚本式inside方法的参数完全一致
        }
    }
    stages {
        stage('Test') {
            steps {
                sh 'pytest --version'
                // 在这里添加其他需要执行的命令
            }
        }
    }
}

参数说明 #

• additionalBuildArgs：负责传递docker build命令的额外参数，和你原来的配置保持一致即可；
• args：专门用于指定docker run启动容器时的额外参数，这里传入--network=host后，Jenkins启动容器的行为就和脚本式里inside('--network=host')的效果完全等价。

这样配置后，Jenkins会先通过指定的Dockerfile构建镜像（带--network host参数），再用docker run --network=host启动容器运行流水线步骤，完全匹配你想要的脚本式流水线行为。

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