CI/CD / 系统课时

用 post 处理成功与失败结果

用 post 处理成功与失败结果

流水线执行结束后,测试报告、构建产物和临时文件仍需要处理。Declarative Pipeline 的 post 可以按最终结果执行清理、归档或失败处理,让这些动作不必散落在各个构建步骤中。

学习目标

  • 理解流水线级与阶段级 post 的执行时机
  • 使用 always、success 和 failure 组织结果处理
  • 确保清理动作在构建失败时仍有机会执行

post 在什么时候执行

post 是 Declarative Pipeline 的结果处理区块。放在顶层 pipeline 中时,它针对整条流水线;放在 stage 中时,则针对该阶段。常见条件包括 always、success、failure、unstable、changed 和 cleanup。

其中 always 适合无论结果如何都要执行的动作,例如收集测试结果;success 只在对应范围成功时执行;failure 用于失败后的日志、通知或诊断处理;cleanup 适合最终清理,并在其他 post 条件之后执行。

流水线执行结果进入不同 post 条件的处理流程

在 Jenkinsfile 中处理结果

下面的 Jenkinsfile 用 Shell 创建一个构建产物,并在 post 中归档文件。示例假设 Agent 提供 POSIX Shell,且 Jenkins 已具备 Pipeline 基础能力。

groovy
pipeline {
    agent any

    stages {
        stage('Build') {
            steps {
                sh '''
                    mkdir -p build
                    printf 'demo artifact\n' > build/app.txt
                '''
            }
        }
    }

    post {
        always {
            echo 'Pipeline finished; collecting results.'
        }
        success {
            archiveArtifacts artifacts: 'build/app.txt', fingerprint: true
            echo 'Build succeeded.'
        }
        failure {
            echo 'Build failed; inspect the console log.'
        }
        cleanup {
            deleteDir()
        }
    }
}

预期结果

text
Pipeline finished; collecting results.
Build succeeded.
Finished: SUCCESS

控制台还会包含 Jenkins 自动产生的阶段和步骤日志,具体文本与时间可能不同。成功时产物会在工作区被清理前完成归档;如果前面的构建步骤失败,则不会执行 success,而会进入 failure,之后仍执行 cleanup。

流水线级和阶段级怎样选择

阶段级 post 适合处理只属于某个阶段的结果。例如测试阶段可以在失败时保留诊断信息,而部署阶段可以单独处理部署失败。流水线级 post 更适合最终通知、全局归档和统一清理,因为它观察的是整条流水线的最终状态。

不要把关键清理只写在普通 steps 的最后。如果前面的命令抛出错误,后续普通步骤可能无法执行。需要尽可能在结束时执行的清理,应放到合适的 post 条件中,并根据插件和步骤的失败行为设计容错。

验证失败路径

可以临时把构建阶段中的 Shell 命令改为 exit 1,再次运行流水线。此时应观察到 always 与 failure 对应逻辑执行,而 success 不执行,最终 cleanup 仍负责清理工作区。

这种验证比只测试成功路径更重要:post 的主要价值正是在异常发生后仍能按照结果执行收尾逻辑。把归档、通知和清理分别放到与语义匹配的条件中,流水线失败时才不会丢失关键处理步骤。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 post 处理成功与失败结果

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通