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 条件之后执行。

在 Jenkinsfile 中处理结果
下面的 Jenkinsfile 用 Shell 创建一个构建产物,并在 post 中归档文件。示例假设 Agent 提供 POSIX Shell,且 Jenkins 已具备 Pipeline 基础能力。
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()
}
}
}预期结果
Pipeline finished; collecting results.
Build succeeded.
Finished: SUCCESS控制台还会包含 Jenkins 自动产生的阶段和步骤日志,具体文本与时间可能不同。成功时产物会在工作区被清理前完成归档;如果前面的构建步骤失败,则不会执行 success,而会进入 failure,之后仍执行 cleanup。
流水线级和阶段级怎样选择
阶段级 post 适合处理只属于某个阶段的结果。例如测试阶段可以在失败时保留诊断信息,而部署阶段可以单独处理部署失败。流水线级 post 更适合最终通知、全局归档和统一清理,因为它观察的是整条流水线的最终状态。
不要把关键清理只写在普通 steps 的最后。如果前面的命令抛出错误,后续普通步骤可能无法执行。需要尽可能在结束时执行的清理,应放到合适的 post 条件中,并根据插件和步骤的失败行为设计容错。
验证失败路径
可以临时把构建阶段中的 Shell 命令改为 exit 1,再次运行流水线。此时应观察到 always 与 failure 对应逻辑执行,而 success 不执行,最终 cleanup 仍负责清理工作区。
这种验证比只测试成功路径更重要:post 的主要价值正是在异常发生后仍能按照结果执行收尾逻辑。把归档、通知和清理分别放到与语义匹配的条件中,流水线失败时才不会丢失关键处理步骤。