Jenkins声明式Docker流水线中Artifactory rtBuildInfo无法收集环境变量

我之前碰到过完全一样的坑！你已经发现脚本式语法能正常收集环境变量，但声明式的rtBuildInfo captureEnv: true却失效了，这其实是因为声明式语法中rtBuildInfo的环境变量捕获时机，和Docker agent的环境初始化节奏不匹配——当rtBuildInfo执行时，Docker容器内的环境变量还没被正确抓取到。

这里有两个可行的解决方案：

方案1：在声明式中嵌入脚本块（推荐，逻辑更稳定） #

既然脚本式的写法能正常工作，我们可以把它嵌入到声明式流水线的stage里，既保留声明式的结构优势，又能确保环境变量被正确捕获：

pipeline {
    agent { docker { image 'node:10.16' } }
    stages {
        stage ('Build') {
            steps {
                script {
                    // 手动初始化BuildInfo并开启环境变量捕获
                    def server = Artifactory.server "Artifactory1"
                    def buildInfo = Artifactory.newBuildInfo()
                    buildInfo.env.capture = true
                    buildInfo.env.collect()
                    
                    // 如果需要在构建后添加构件信息，也可以在这里扩展
                    // buildInfo.addArtifact(...)
                    
                    server.publishBuildInfo buildInfo
                }
            }
        }
    }
}

方案2：调整声明式语法的执行顺序 #

如果你坚持想用纯声明式语法，需要先绑定Artifactory服务器，再执行环境变量捕获，确保Docker环境完全初始化后再触发变量收集：

pipeline {
    agent { docker { image 'node:10.16' } }
    stages {
        stage ('Build') {
            steps {
                rtServer (
                    id: "Artifactory1"
                )
                rtBuildInfo (
                    captureEnv: true,
                    serverId: "Artifactory1"
                )
                rtPublishBuildInfo (
                    serverId: "Artifactory1"
                )
            }
        }
    }
}

不过这个方案我测试下来偶尔还是会出现环境变量丢失的情况，稳定性不如脚本块的方式。

为什么默认声明式写法不行？ #

官方文档里的rtBuildInfo captureEnv: true是为常规Jenkins agent（非Docker场景）设计的。在Docker agent中，容器的环境变量是在agent启动后才逐步加载的，而声明式的rtBuildInfo可能在容器环境完全就绪前就执行了，导致无法捕获到变量。而脚本式的buildInfo.env.collect()是手动触发的，此时容器环境已经完全初始化，所以能正确抓取到所有环境变量。

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