如何在Jenkins声明式管道中将环境变量写入docker.env文件？

我来帮你搞定这个需求！要把Jenkins Stage里environment块的变量导出成docker.env格式，从而让docker run可以直接读取，有几种实用的方法，你可以根据自己的场景选择：

方法1：Shell命令直接写入（简单直接） #

如果你的环境变量数量不多，直接用Shell的Here Document语法把变量写入文件最方便，还能处理带特殊字符的值（记得给变量加双引号避免格式错误）：

pipeline {
    agent any
    stages {
        stage('Staging') {
            environment {
                KEY1_1=VALUE1_1
                KEY1_2="VALUE with spaces"
                KEY2_1=VALUE2_1
                KEY2_2=VALUE2_2
            }
            steps {
                // 生成docker.env文件
                sh '''
                    cat > docker.env << EOF
KEY1_1="$KEY1_1"
KEY1_2="$KEY1_2"
KEY2_1="$KEY2_1"
KEY2_2="$KEY2_2"
EOF
                '''
                // 执行docker run命令
                sh 'docker run -d --env-file=docker.env java'
            }
        }
    }
}

方法2：Jenkins Script块动态生成（灵活扩展） #

如果变量数量多，或者需要动态管理要导出的变量，用Jenkins的Script块来生成文件更合适，不用每次改变量都修改Shell脚本：

pipeline {
    agent any
    stages {
        stage('Staging') {
            environment {
                KEY1_1=VALUE1_1
                KEY1_2=VALUE1_2
                KEY2_1=VALUE2_1
                KEY2_2=VALUE2_2
            }
            steps {
                script {
                    // 指定文件路径（用WORKSPACE确保在当前工作目录）
                    def envFilePath = "${env.WORKSPACE}/docker.env"
                    def envFile = new File(envFilePath)
                    // 清空文件内容
                    envFile.text = ""
                    // 列出需要导出的变量名
                    def targetVariables = ['KEY1_1', 'KEY1_2', 'KEY2_1', 'KEY2_2']
                    // 逐个写入文件
                    targetVariables.each { varName ->
                        envFile.append("${varName}=${env[varName]}\n")
                    }
                }
                // 执行docker run命令
                sh 'docker run -d --env-file=docker.env java'
            }
        }
    }
}

方法3：批量过滤自定义变量（适合大量统一前缀的变量） #

如果你的自定义环境变量都有统一前缀（比如APP_），可以用printenv结合grep批量导出，不用手动列变量：

pipeline {
    agent any
    stages {
        stage('Staging') {
            environment {
                APP_KEY1=VALUE1
                APP_KEY2=VALUE2
                APP_KEY3=VALUE3
                // 其他系统变量不会被导出
            }
            steps {
                // 过滤所有以APP_开头的变量写入文件
                sh 'printenv | grep ^APP_ > docker.env'
                sh 'docker run -d --env-file=docker.env java'
            }
        }
    }
}

注意事项 #

• 确保docker.env生成在Jenkins工作目录下（上面的方法都默认在这个目录），不然docker run找不到文件；
• 如果变量值包含特殊字符（比如空格、引号），方法1里一定要给变量加双引号，避免格式错误；
• 方法2的Script块是Jenkins Groovy语法，跨平台性更好，不用依赖Shell工具。

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