Jenkins自由风格与流水线作业参数环境变量求值差异及适配问询

一、自由风格作业参数自动求值的官方文档说明 #

自由风格作业中，字符串参数的默认值支持引用环境变量（如${HOME}），Jenkins会在构建初始化阶段自动对参数值进行环境变量插值，将求值后的结果作为环境变量传递给后续构建步骤。这一行为属于Jenkins核心参数处理逻辑，官方文档在「构建参数」章节明确说明：字符串参数的默认值可以包含环境变量引用，Jenkins会在参数解析时完成变量替换，确保构建步骤拿到的是实际值而非原始字符串。

二、流水线作业复现自动求值行为的方法 #

流水线作业默认不会自动对参数中的环境变量进行插值，需要手动处理，以下两种方法可以实现相同效果：

方法1：Groovy层面提前插值（推荐） #

利用Jenkins Pipeline的env.expand()方法，在Groovy脚本中对参数进行环境变量插值，再将结果设置为环境变量供Shell脚本使用：

pipeline {
    agent any
    stages {
        stage('Resolve Params') {
            steps {
                script {
                    // 对参数avar2进行环境变量插值
                    def resolvedAvar2 = env.expand(params.avar2)
                    // 将插值后的结果覆盖原环境变量
                    env.avar2 = resolvedAvar2
                }
                sh '''#!/bin/bash -e
                env | sort
                '''
            }
        }
    }
}

这种方法在Groovy层面完成插值，避免Shell脚本中的转义问题，更安全可控。

方法2：Shell脚本内部求值 #

在Shell步骤中通过eval命令对参数进行动态求值，适用于需要在Shell内部处理的场景：

pipeline {
    agent any
    stages {
        stage('Evaluate Params') {
            steps {
                sh '''#!/bin/bash -e
                # 对avar2参数执行环境变量替换
                export avar2=$(eval echo "$avar2")
                env | sort
                '''
            }
        }
    }
}

注意：使用eval时要确保参数值安全，避免注入风险。

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