CI/CD / 系统课时
看懂一次持续交付的执行链路
看懂一次持续交付的执行链路
持续交付不是 Jenkins 单独完成的一次“构建”。代码提交后,代码仓库、Jenkins、构建节点和目标环境会依次参与。本节先把这条执行链路串起来,让你能判断每个阶段由谁负责,以及失败时应该从哪里开始定位。
学习目标
- 说清代码仓库、Jenkins、构建节点和目标环境各自的职责
- 理解从代码提交到部署结果返回的主要执行阶段
- 根据失败位置判断应该优先检查哪个组件
四个核心角色
代码仓库保存版本化源码和流水线定义,是持续交付的输入来源。Jenkins Controller 负责接收触发、解析 Pipeline、调度任务和记录结果,但实际的编译、测试等工作可以交给独立构建节点执行。
构建节点准备工作区并执行 Git、Maven、Gradle、Docker 等工具。目标环境则接收最终制品,例如测试服务器、Kubernetes 集群或生产环境。构建节点负责产生和交付制品,目标环境负责运行制品,两者不应混为一谈。

一次执行是怎样流动的
典型链路可以拆成五个阶段:代码仓库出现新的提交;Webhook 或轮询使 Jenkins 获知变化;Jenkins 创建一次 Pipeline 执行并选择合适的构建节点;节点检出源码并完成构建、测试和制品生成;部署阶段把通过验证的制品交付到目标环境,最后把成功或失败状态记录回 Jenkins。
这里有两个重要边界。首先,代码仓库只负责保存和提供代码,并不会替 Jenkins 执行流水线。其次,Jenkins 显示 SUCCESS 只能说明 Pipeline 定义的步骤成功完成;如果流水线没有健康检查或业务验证步骤,它并不能自动证明业务已经可用。
用最小 Pipeline 对照链路
下面的 Declarative Pipeline 用三个阶段模拟检出之后的构建、测试和部署过程。agent any 表示 Jenkins 可以选择任一满足条件的可用节点执行任务。
pipeline {
agent any
stages {
stage('Build') {
steps {
echo 'Building application'
}
}
stage('Test') {
steps {
echo 'Running tests'
}
}
stage('Deploy') {
steps {
echo 'Deploying application'
}
}
}
}预期输出
Building application
Running tests
Deploying application
Finished: SUCCESS实际 Jenkins 日志还会包含阶段、节点、工作目录和时间等信息,因此输出不会只有以上四行。这里关注的是三个阶段按顺序执行,并最终得到成功状态。
失败时沿链路定位
排障时不要一看到红色构建就先重启 Jenkins,而应确认执行停在哪一段。如果 Jenkins 没有创建任务,先检查仓库触发方式和 Jenkins Job;如果任务一直等待节点,检查节点在线状态、标签和执行器;如果编译或测试失败,查看构建节点上的阶段日志;如果制品已经产生但部署失败,再检查目标环境的网络、凭据和部署命令。
一条可维护的持续交付链路,关键不是把所有工作都塞进 Jenkins,而是让代码来源、调度、执行、制品和部署结果都有清晰边界。后续增加测试、审批、制品仓库或生产发布时,也可以继续沿这条链路扩展。