CI/CD / 系统课时
加入生产审批与发布控制
加入生产审批与发布控制
生产发布需要同时解决“谁确认、等多久、发布哪个版本、能否重复发布”几个问题。本节使用 Jenkins Pipeline 的人工审批、超时、参数和并发保护,把生产变更从一次普通脚本执行变成有明确边界的受控操作。
学习目标
- 使用
input和timeout建立有限等待时间的人工审批 - 用版本参数明确本次生产发布对象
- 使用并发保护避免同一 Job 同时执行多个生产发布
把生产发布对象固定下来
生产审批必须针对一个确定版本,而不是批准后再决定部署什么。可以使用参数化流水线声明版本参数,让构建从开始时就拥有明确的发布对象。
下面是一条最小生产发布流水线。它禁用同一 Job 的并发构建,在审批阶段限制等待时间,并要求审批后才执行部署脚本。
pipeline {
agent any
options {
disableConcurrentBuilds()
}
parameters {
string(
name: 'RELEASE_VERSION',
defaultValue: '',
description: '已经通过测试环境验收的候选版本'
)
}
stages {
stage('Validate Release') {
steps {
script {
if (!params.RELEASE_VERSION?.trim()) {
error('RELEASE_VERSION must not be empty')
}
}
}
}
stage('Production Approval') {
steps {
timeout(time: 30, unit: 'MINUTES') {
input message: "Deploy ${params.RELEASE_VERSION} to production?",
ok: 'Deploy'
}
}
}
stage('Deploy Production') {
steps {
sh '''
set -eu
/opt/release/deploy-production.sh "${RELEASE_VERSION}"
'''
}
}
}
}预期结果:填写有效版本并批准后,Jenkins 才执行生产部署阶段;拒绝审批或 30 分钟内无人处理时,流水线不会执行生产部署。实际审批用户、时间和构建编号由 Jenkins 环境决定。
[Pipeline] stage
[Pipeline] { (Production Approval)
Input requested
Approved by <ID>
[Pipeline] stage
[Pipeline] { (Deploy Production)
[Pipeline] sh
[Pipeline] End of Pipeline
Finished: SUCCESS审批、超时和并发保护各解决什么
input 会暂停流水线并等待人工决定,适合把已经自动验收的候选版本交给授权人员确认。timeout 给这种等待设置上限,避免无人处理的发布长期占据执行状态。超时发生后,后续生产部署阶段不会正常执行。
disableConcurrentBuilds() 解决的是另一类风险:同一个 Job 的两个构建不能同时运行。例如版本 1.8.3 尚未部署结束时,版本 1.8.4 不应从同一发布 Job 并行修改生产环境。它保护的是当前 Job 的并发,不等价于整个组织范围的全局部署锁。

不要让审批变成版本替换入口
审批的对象应该是已经通过测试环境验收的候选版本。如果审批人在生产发布前把 RELEASE_VERSION 改成另一个未经验证的版本,测试门禁就失去了意义。因此实际流水线更适合由前序阶段产生不可变版本标识,再将它展示给审批人确认,而不是允许审批时任意输入新版本。
镜像交付场景还可以进一步使用不可变镜像 digest,而不仅是可能被覆盖的标签。无论采用版本号、Git Commit 还是镜像 digest,原则都相同:审批看到的对象必须与最终部署对象一致。
发布后验证控制是否真正生效
可以连续触发两次该 Job 验证并发保护,再用一次不审批的构建验证超时路径。生产部署脚本应记录实际版本,使发布完成后能够核对部署对象是否与 RELEASE_VERSION 一致。
最终应形成清晰的控制链:候选版本先被固定,流水线等待有时限的人工确认,同一 Job 不允许两个发布并行修改生产环境,审批通过后才把同一个版本交给生产部署脚本。这样生产发布的对象、时机和执行边界都能够从流水线定义中直接审查。