Jenkins声明式流水线when条件中字符串变量对比异常排查

核心问题原因 #

1. 局部变量跨阶段不可访问：在Check if image has changed阶段的script块中直接定义的OLD_DIGEST和NEW_DIGEST是局部变量，无法被后续Release阶段的when条件读取。此时使用env.OLD_DIGEST会获取到null，导致对比逻辑失效；直接引用变量名时，when条件评估阶段变量尚未定义，Jenkins会将其视为未初始化值，对比结果不符合预期。

2. 字符串格式不一致（潜在隐患）：jq默认输出带双引号的字符串（如"sha256:xxx"），而podman inspect输出的是无引号的原始字符串，若未处理引号，会导致实际digest相同但字符串对比结果不相等。

修复后的流水线代码 #

stages {
    stage('Check if image has changed') {
        steps {
            script {
                // 将变量赋值给环境变量，实现跨阶段共享
                // 给jq添加-r参数，输出原始无引号的digest值，保证格式一致
                env.OLD_DIGEST = sh(returnStdout: true, script: "podman manifest inspect registry/myimage:11 2>/dev/null | jq -r .config.digest").trim()
                env.NEW_DIGEST = sh(returnStdout: true, script: "podman inspect --format='sha256:{{.Id}}' myimage:11-tmp").trim()
            }
            sh "echo previous digest:${env.OLD_DIGEST}, new digest:${env.NEW_DIGEST}"
        }
    }
    stage('Release') {
        when {
            allOf {
                expression { env.RELEASE != null && env.RELEASE == "true" }
                // 使用环境变量进行对比，确保能获取到正确的digest值
                expression { env.OLD_DIGEST != env.NEW_DIGEST }
            }
        }
        steps {
            sh "echo Releasing image..."
            sh "podman image push myimage:11-tmp registry/myimage:11.${DATE_TIME}"
            sh "podman image push myimage:11-tmp registry/myimage:11"
        }
    }
}

关键修改说明 #

• 将变量转为环境变量：通过env.OLD_DIGEST = ...的方式赋值，使变量能在流水线的所有阶段中被访问，保证when条件能读取到正确的digest值。
• 统一字符串格式：给jq命令添加-r参数，输出无引号的原始字符串，确保OLD_DIGEST和NEW_DIGEST的格式完全一致，避免因引号导致的对比错误。
• 保留trim()处理：去除字符串前后的空白字符（如换行符、空格），避免因多余空白导致的对比失效。

内容的提问来源于stack exchange，提问作者Gaël J