CI/CD / 系统课时

用 stage 划分流水线阶段

用 stage 划分流水线阶段

当构建流程同时包含检出、测试和打包时,把所有命令塞进一个步骤会让日志和失败位置难以辨认。本节使用 Declarative Pipeline 的 pipeline、stages、stage 与 steps 建立清晰执行层级,让 Jenkins 能按阶段展示构建过程。

学习目标

  • 理解 pipeline、stages、stage 和 steps 的层级关系
  • 能按构建职责拆分多个 stage
  • 能根据阶段状态快速定位失败位置

四层结构分别负责什么

Declarative Pipeline 最外层是 pipeline,它定义整条流水线。stages 是阶段集合,其中包含一个或多个 stage;每个 stage 表示一个有业务含义的构建阶段,而真正要执行的步骤放在 steps 中。

Declarative Pipeline执行层级

这种层级不是为了排版。Jenkins 会以 stage 为单位呈现执行状态和耗时,因此阶段名称应该表达构建职责,例如 Checkout、Test、Package,而不是使用 Run command 1 之类无法帮助定位问题的名称。

写一条分阶段流水线

下面的 Jenkinsfile 使用三个阶段模拟典型构建流程。示例只依赖 Shell,因此适合在具有 sh 步骤执行环境的 Jenkins Agent 上观察阶段顺序。

groovy
pipeline {
    agent any

    stages {
        stage('Checkout') {
            steps {
                echo 'Source ready'
            }
        }
        stage('Test') {
            steps {
                sh 'echo "Tests passed"'
            }
        }
        stage('Package') {
            steps {
                sh 'echo "Package created"'
            }
        }
    }
}

预期输出

text
Source ready
Tests passed
Package created

Jenkins 的完整控制台日志还会包含阶段进入、节点分配等运行信息,具体文本随 Jenkins 与插件版本而变化;这里列出的三行是示例步骤自身产生的稳定输出。

stage 应该按职责划分

阶段粒度应让失败信息具有诊断价值。如果编译、测试和打包都放进 Build 一个阶段,Jenkins 只能告诉你 Build 失败;拆成 Compile、Test、Package 后,失败位置会直接落在对应阶段。

但 stage 也不是越多越好。单纯为了执行两条连续且属于同一职责的 Shell 命令,没有必要拆成两个阶段。判断标准是:这个边界是否代表一个值得单独观察、控制或诊断的构建职责。

steps 则负责承载具体动作,例如 echo、sh、checkout 等 Pipeline Step。不要把 stage 理解为一条命令的包装器,它更接近构建流程中的可观察边界。

用失败观察执行边界

为了理解阶段的价值,可以把 Test 中的命令临时改成返回非零退出码的测试命令。该步骤失败后,Test 会被标记为失败,后续依赖正常执行路径的阶段不会像成功构建那样继续完成。

实际项目通常可以从“检出 → 构建或编译 → 测试 → 打包”开始划分,再根据发布流程增加镜像构建、制品上传或部署阶段。先让每个 stage 对应一个明确职责,再考虑并行、条件执行和后置处理,Jenkinsfile 会更容易阅读和排错。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 stage 划分流水线阶段

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

登录哪都通