如何将Jenkins Pipeline步骤（如docker.build）的控制台输出归档为文件？

我之前在维护微服务Jenkins Pipeline的时候，刚好碰到过和你一模一样的需求——就是不想让开发对着乱糟糟的控制台找日志，想把特定步骤的输出单独归档成文件。针对docker.build()这类Pipeline内置步骤，给你分享几个亲测好用的方案：

方法1：用日志标记+Build API精准提取目标内容 #

这种方法通用性极强，不管是docker.build()还是其他Pipeline内置步骤都能用。核心思路是给目标步骤的日志前后加个自定义标记，然后从完整构建日志里把标记之间的内容抠出来存成文件：

pipeline {
    agent any
    stages {
        stage('Build Docker Image') {
            steps {
                script {
                    // 给目标步骤加开始标记，方便后续定位
                    def startFlag = "=== DOCKER BUILD START ==="
                    echo startFlag
                    // 执行你的docker.build步骤
                    docker.build("my-microservice:${BUILD_NUMBER}")
                    // 加结束标记
                    def endFlag = "=== DOCKER BUILD END ==="
                    echo endFlag

                    // 从完整构建日志里提取标记之间的内容
                    def fullBuildLog = currentBuild.getRawBuild().getLog().join("\n")
                    def dockerBuildLog = fullBuildLog.substring(
                        fullBuildLog.indexOf(startFlag) + startFlag.length(),
                        fullBuildLog.indexOf(endFlag)
                    )
                    
                    // 把提取到的日志写入文件
                    writeFile file: "docker-build-${BUILD_NUMBER}.log", text: dockerBuildLog
                    // 归档这个文件，方便后续查看
                    archiveArtifacts artifacts: "docker-build-${BUILD_NUMBER}.log", fingerprint: true
                }
            }
        }
    }
}

⚠️ 注意：使用currentBuild.getRawBuild()需要在Jenkins全局安全配置里通过脚本审批，不然会报错。

方法2：用原生sh命令替代Pipeline内置步骤 #

如果你不需要docker.build()提供的高级特性（比如自动镜像推送、缓存管理这些），直接回到你熟悉的sh重定向方式反而更简单：

pipeline {
    agent any
    stages {
        stage('Build Docker Image') {
            steps {
                // 直接用docker build命令，把stdout和stderr都重定向到文件
                sh '''
                    docker build -t my-microservice:${BUILD_NUMBER} . > docker-build-output.log 2>&1
                '''
                // 归档生成的日志文件
                archiveArtifacts artifacts: 'docker-build-output.log', fingerprint: true
            }
        }
    }
}

这个方案完全不需要额外配置，上手零成本，适合追求简单直接的场景。

方法3：用第三方插件实现实时日志过滤归档 #

如果你的Pipeline里有大量需要单独归档的步骤，推荐试试Log File Filter Plugin。这个插件能让你在构建过程中实时过滤指定关键词的日志，自动输出到指定文件，不需要手动加标记或者写提取逻辑。配置好插件后，在Pipeline里就能一键把docker.build()相关的日志归档，非常省心。

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