Jenkins流水线环境变量在If-Else语句中不更新的问题排查

问题原因 #

你遇到的核心问题是：Jenkins的sh步骤会启动独立的子Shell进程，子Shell内修改的环境变量无法传递回Jenkins主进程。

你在Check if file already exists阶段的sh脚本里设置的ALREADY_EXISTS，只是子Shell的局部变量，和流水线environment块中定义的env.ALREADY_EXISTS完全是两个独立的变量。因此即使子Shell里echo显示ALREADY_EXISTS=true，Jenkins主进程的env.ALREADY_EXISTS依然保持初始值false，导致后续分支判断逻辑失效。

解决方案 #

要在流水线的不同阶段共享状态，需要在Jenkins的Groovy上下文（而非子Shell）中处理变量赋值，以下是两种可靠的实现方式：

方法1：利用sh的returnStatus直接判断文件存在性 #

通过sh步骤的returnStatus参数获取命令执行结果（0表示成功，即文件存在；非0表示失败，即文件不存在），直接在Groovy脚本中设置env变量：

pipeline {
    agent any
    environment {
        APPLICATION_NAME="myapp"
        REPOSITORY_NAME="myrepo"
        FILENAME="${APPLICATION_NAME}-app.yaml"
        ALREADY_EXISTS="false"
    }
    stages {
        stage("Clone Git Repository") {
            steps {
                git(
                    url: "https://github.com/myid/${REPOSITORY_NAME}.git",
                    branch: "main",
                    changelog: true,
                    credentialsId: 'mycreds',
                    poll: true
                )
            }
        }
        stage("Check if file already exists") {
            steps {
                script {
                    // 检查目标文件是否存在，returnStatus返回0表示存在
                    def fileExists = sh(
                        script: "cd ./apps && [ -f \"${FILENAME}\" ]",
                        returnStatus: true
                    ) == 0
                    // 将结果写入Jenkins全局环境变量
                    env.ALREADY_EXISTS = fileExists ? "true" : "false"
                    echo "ALREADY_EXISTS = ${env.ALREADY_EXISTS}"
                }
            }
        }
        stage("Rollout or create app") {
            steps {
                script {
                    if (env.ALREADY_EXISTS == "true") {
                        withKubeConfig([namespace: "${APPLICATION_NAME}-${CLIENT_ID}"]) {
                            sh 'curl -LO https://dl.k8s.io/release/v1.26.3/bin/linux/amd64/kubectl'
                            sh 'chmod u+x ./kubectl'
                            sh './kubectl rollout restart deployment ${APPLICATION_NAME}'
                        }
                    } else {
                        sh '''
                            # 执行创建新应用的逻辑
                        '''
                    }
                }
            }
        }
    }
}

方法2：通过文件传递状态（适合复杂场景） #

如果需要传递更多复杂状态，可以在子Shell中将结果写入临时文件，再在Groovy中读取文件内容设置环境变量：

stage("Check if file already exists") {
    steps {
        sh '''
            cd ./apps
            if [ -f "${FILENAME}" ]; then
                echo "true" > /tmp/file_exists_flag
            else
                echo "false" > /tmp/file_exists_flag
            fi
        '''
        script {
            env.ALREADY_EXISTS = readFile("/tmp/file_exists_flag").trim()
            echo "ALREADY_EXISTS = ${env.ALREADY_EXISTS}"
        }
    }
}

额外优化建议 #

• 避免在每个stage重复下载kubectl，可以将kubectl安装放在agent的pre阶段，或者使用Jenkins的tool功能预安装kubectl；
• 若CLIENT_ID是动态变量，确保它已在流水线环境中正确定义。

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