CI/CD / 系统课时
用 stage 划分流水线阶段
用 stage 划分流水线阶段
当构建流程同时包含检出、测试和打包时,把所有命令塞进一个步骤会让日志和失败位置难以辨认。本节使用 Declarative Pipeline 的 pipeline、stages、stage 与 steps 建立清晰执行层级,让 Jenkins 能按阶段展示构建过程。
学习目标
- 理解
pipeline、stages、stage和steps的层级关系 - 能按构建职责拆分多个 stage
- 能根据阶段状态快速定位失败位置
四层结构分别负责什么
Declarative Pipeline 最外层是 pipeline,它定义整条流水线。stages 是阶段集合,其中包含一个或多个 stage;每个 stage 表示一个有业务含义的构建阶段,而真正要执行的步骤放在 steps 中。

这种层级不是为了排版。Jenkins 会以 stage 为单位呈现执行状态和耗时,因此阶段名称应该表达构建职责,例如 Checkout、Test、Package,而不是使用 Run command 1 之类无法帮助定位问题的名称。
写一条分阶段流水线
下面的 Jenkinsfile 使用三个阶段模拟典型构建流程。示例只依赖 Shell,因此适合在具有 sh 步骤执行环境的 Jenkins Agent 上观察阶段顺序。
pipeline {
agent any
stages {
stage('Checkout') {
steps {
echo 'Source ready'
}
}
stage('Test') {
steps {
sh 'echo "Tests passed"'
}
}
stage('Package') {
steps {
sh 'echo "Package created"'
}
}
}
}预期输出
Source ready
Tests passed
Package createdJenkins 的完整控制台日志还会包含阶段进入、节点分配等运行信息,具体文本随 Jenkins 与插件版本而变化;这里列出的三行是示例步骤自身产生的稳定输出。
stage 应该按职责划分
阶段粒度应让失败信息具有诊断价值。如果编译、测试和打包都放进 Build 一个阶段,Jenkins 只能告诉你 Build 失败;拆成 Compile、Test、Package 后,失败位置会直接落在对应阶段。
但 stage 也不是越多越好。单纯为了执行两条连续且属于同一职责的 Shell 命令,没有必要拆成两个阶段。判断标准是:这个边界是否代表一个值得单独观察、控制或诊断的构建职责。
steps 则负责承载具体动作,例如 echo、sh、checkout 等 Pipeline Step。不要把 stage 理解为一条命令的包装器,它更接近构建流程中的可观察边界。
用失败观察执行边界
为了理解阶段的价值,可以把 Test 中的命令临时改成返回非零退出码的测试命令。该步骤失败后,Test 会被标记为失败,后续依赖正常执行路径的阶段不会像成功构建那样继续完成。
实际项目通常可以从“检出 → 构建或编译 → 测试 → 打包”开始划分,再根据发布流程增加镜像构建、制品上传或部署阶段。先让每个 stage 对应一个明确职责,再考虑并行、条件执行和后置处理,Jenkinsfile 会更容易阅读和排错。