这篇讲部署到生产之前,怎么让流水线停下来等人确认后再继续。看完你可以在 YAML 里给单个任务加 approval,或在控制台给整条流水线配审批策略,并知道审批人要到审批中心点 通过,触发这次运行的人不能批准自己的运行。
这里的审批管的是「这一次运行能不能继续往下走」,和拉取请求里的代码评审不是一回事。AngusGit 的流水线在团队版和企业版中提供;社区版没有 CI/CD 菜单,本文的操作不适用。
下文以仓库 xlliu/test-cicd-example 里的 .anguscicd/05-deploy-approval.yaml 为例。这份文件在控制台里显示的流水线名称是 test-cicd-example · 05 Deploy Approval,文件里的 name 写的是 deploy-with-approval。按 YAML 的写法,只有最后一个任务需要等人审批;不过这条流水线目前另外启用了一条审批策略,所以新的运行会在每个任务开始前都停下来等审批,具体见第 3 节。
1. 审批卡在哪里
审批加在任务上,生效时机是任务开始之前。轮到某个任务运行时,平台会先检查它是否需要审批。如果需要,平台会生成一条审批请求,让任务停下来等待。在审批结束之前,这个任务既不会分配运行器(Runner,即装在构建机上、负责执行命令的程序),也不会执行任何步骤。
审批结束时有三种结果:
- 通过:任务继续,开始分配运行器、执行步骤。
- 拒绝:任务失败,依赖它的后续任务也不会运行。
- 超时:在规定的等待时间内没有满足通过条件,任务失败。超时之后再点通过也不起作用。
因此,审批一般加在部署这类任务上,并让它依赖前面的构建和测试任务。这样只有前面的任务都成功了,才需要打扰审批人。
2. 在 YAML 里给某个任务加审批
以 .anguscicd/05-deploy-approval.yaml 为例,文件里有三个任务:build 运行示例程序;deploy-staging 在 build 成功后打印一行部署记录;deploy-production 在 deploy-staging 之后等待人工审批,审批通过后才执行它的两个 echo 步骤。推送到 main 或打标签都会触发这条流水线,但 deploy-production 还带有条件 if: ${{ branch == 'main' }},所以由标签触发的运行不会进入这一步。
version: "1"
name: deploy-with-approval
triggers:
- on: push
branches:
- main
- on: tag
env:
APP_NAME: hello-node
pipeline:
build:
runner:
mode: DOCKER
image: node:20-alpine
steps:
- name: Package
run: |
node apps/hello-node/src/index.js
echo "artifact=dist/${APP_NAME}.tgz"
timeout: 180
deploy-staging:
needs: ["build"]
environment: staging
runner:
mode: DOCKER
image: node:20-alpine
steps:
- name: Deploy to staging
run: echo "deploy staging ${APP_NAME} sha=${GIT_COMMIT_SHA:-local}"
timeout: 120
deploy-production:
needs: ["deploy-staging"]
environment: production
if: ${{ branch == 'main' }}
canaryWeight: 20
approval:
required: true
approvers: [376747068704423936, 1]
policy: any
timeout: 7200
runner:
mode: DOCKER
image: node:20-alpine
steps:
- name: Canary rollout 20%
run: echo "canary 20% for ${APP_NAME}"
timeout: 120
- name: Promote to 100%
run: echo "promote 100% for ${APP_NAME}"
timeout: 120
文件注释里写的审批人是柳小龙和 admin。在审批记录里,前者显示为 Angus,用户 ID 是 376747068704423936;admin 的用户 ID 是 1。policy: any 表示两人中任意一人通过即可,timeout: 7200 表示最多等 7200 秒,也就是 2 小时。
另外两个字段容易被误解。environment: production 只是给这次部署记下环境名称,写成 production 并不会自动触发审批;canaryWeight: 20 平台只校验它是否在 0 到 100 之间,不会按这个比例切分流量。示例里的两个步骤目前也只是 echo,并没有真正发布。
approval 里各字段的含义如下:
| 字段 | 类型与默认值 | 作用 |
|---|---|---|
required |
布尔值 | 是否需要人工审批,写 true 才会等待 |
approvers |
数字数组 | 审批人列表,填数字形式的用户 ID(不是登录名);列表为空时不会等待 |
policy |
默认 any
|
any 任一人通过即可,all 名单里的人全部通过,quorum 通过人数达到 requiredApprovals
|
requiredApprovals |
正整数 | 需要多少人通过,只在 policy: quorum 时生效 |
timeout |
默认 3600(秒) |
最多等待多少秒,到时间还没通过则任务失败 |
如果不知道用户 ID,可以改在流水线编辑器里配置:选中 deploy-production,在 人工审批 里打开 需要审批,点 选择审批人,按名称或用户名搜索并选中。超时输入框的标签是 超时(小时),旁边会提示保存后对应多少秒。如果没有选审批人,编辑器会提示「未指定审批人时运行将跳过审批门禁;需要门禁请先选择审批人。」这里的「门禁」指流水线上必须满足条件才能放行的关卡,在本文中就是人工审批。
用户 ID 是一长串数字,控制台会按原样保存,不会把它当成普通数字处理(当成普通数字时,末尾几位可能被改掉,第 3 节有一个实例)。因此,上面 YAML 里的 376747068704423936 会原样留在文件里。
如果想按团队指定审批人,或者不想改动 YAML,可以用下一节的审批策略。
3. 不改 YAML:给整条流水线配审批策略
审批策略在控制台里配置,不需要修改仓库里的 YAML。使用前要先了解它的两个特点:第一,一条启用的策略会作用于这条流水线的 全部任务;第二,它会 覆盖 YAML 里的 approval 配置。
- 打开审批策略 进入 CI/CD → 治理,切到 审批策略 页签,点 新建策略。
- 选流水线、起名字 流水线 选要管控的那条,名称 写一个能看懂的名字,例如「生产部署门禁」。
- 选审批人和通过条件 打开 需要人工审批。接着在 审批人 里搜索并选择用户,或者在 审批团队 里选择团队(团队成员都会成为审批人),两者加起来至少要选一个人或一个团队。审批策略 有四个选项:任一人通过、需全部通过、达到法定人数(通过人数达到设定值即可),以及 YAML 里没有的 分组法定人数(每组各 N)。最后一种要求每个分组各自达到组内规定的人数,整体才算通过,适合「开发组一人、运维组一人」这类要求。最后填写 超时时间(秒)。
- 启用 打开 启用 并保存。策略启用后立即生效,这条流水线之后的每次运行里,每个任务都会先等审批。
在流水线详情页的 审批 页签里,可以确认当前以哪份配置为准。页面会显示下面两句提示之一:「该流水线受审批策略「…」治理(已启用),运行时将覆盖 YAML 中的 approval 配置。」或者「未配置流水线级审批策略,运行时以 YAML job 级 approval 配置为准。」
使用审批策略时,还有两点要注意:
-
作用范围是全部任务。 如果只想让部署任务等审批,构建和测试照常自动运行,用 YAML 的
approval更合适。 - 禁用或删除策略,会取消正在等待的审批。 这些任务随后改按 YAML 处理:YAML 也要求审批的,重新生成一条审批请求;YAML 没有要求的,直接运行。另外,如果策略处于启用状态、却关闭了 需要人工审批,这条流水线的所有任务都不再等待,YAML 里的审批也不会生效。
回到示例。test-cicd-example · 05 Deploy Approval 目前已经有一条启用的策略,名称是 E2E Deploy Approval:它打开了 需要人工审批,策略是 任一人通过,超时 3600 秒(表单上显示为 1 小时),审批人芯片(表单里代表已选用户的小标签)是 Angus 和 admin。因此,这条流水线之后的新运行里,build、deploy-staging、deploy-production 三个任务都会先等审批,YAML 里只拦最后一个任务的写法不再生效。
这条策略现在保存的审批人是 admin(1)和 Angus(376747068704423936),和 YAML 里的两个 ID 一致。不过要留意一个历史问题:更早的一次保存曾把 Angus 的 ID 存成了 376747068704423940。这时旧页面上的芯片仍然显示 Angus,用新前端打开则显示成 #376747068704423940。遇到这种情况,要先删掉这枚芯片,按名字重新选择 Angus,再保存,库里的 ID 才会和 YAML 对齐;如果只点保存,已经存错的数字会被原样写回去。
上图是已经保存过的 编辑审批策略 表单:审批人是 admin 和 Angus,启用 和 需要人工审批 都已打开,名称框的占位提示仍是「例如:生产部署门禁」。只是查看策略时,不需要再点 保存。
4. 审批人在哪里处理
审批请求产生后,系统目前不会主动推送通知,审批人需要到下面几个地方查看:
- CI/CD → 审批:页面标题是 审批中心,说明文字是「处理流水线里等待人工确认的任务。」在 待审批 页签里,待我处理 只显示需要你处理的请求,全部待办 显示所有人的请求。
- CI/CD → 总览 的 需要关注 区域,以及流水线详情页的 审批 页签:这两处也能直接通过或拒绝,处理的是同一批请求。
- 首页的待办:这里也会出现 CI 审批 类的事项。
具体处理步骤如下:
- 打开详情 在 待审批 列表里,点一条请求的 详情。详情页上有 运行信息(哪条流水线、哪个任务、分支、提交、触发方式和触发人)和 审批进度。请求还在等待时,进度会显示「还差 1 票 · 0/1」这样的句子,旁边是策略说明,例如「任一人通过即可」。需要核对具体改动时,点 查看运行。
- 点通过或拒绝,再填备注 请求还在等待时,详情页上有 通过 和 拒绝 两个按钮。点任意一个都会打开确认框,框里的 备注 可以不填,占位文字是「填写审批意见(可选)」。备注只能在这个确认框里填写,详情页正文里没有输入框。
- 确认结果 提交后,页面会弹出短提示「已通过审批」或「已拒绝审批」。详情页上的结果说明则是另一句:通过时是「审批已通过,流水线继续执行。」拒绝时是「审批被拒绝,对应 Job 已失败。」超时时是「审批到期未达成,对应 Job 已失败。」处理过的请求会归入 已审批记录。对于已经结束的请求,详情页不再显示 通过 和 拒绝,只保留 查看运行 和 重跑。
如果列表里暂时没有待审批的请求,可以打开一条已经通过的记录来对照。以 2026-08-24 的这条记录为例:deploy-production 的审批详情。它由推送触发,分支是 main,提交是 98d2f2a,触发人是 Angus。等待窗口从 17:50 到 19:50,正好 7200 秒,和 YAML 里的 timeout: 7200 一致;后来启用的那条策略是 3600 秒,可见这次运行是按 YAML 审批的。admin 在 17:52 点了通过,Angus 显示为 未参与,进度显示「已满足 1/1 · 名单 2 人」。
图里没有 通过 和 拒绝,因为这条审批已经结束。想再跑一遍这个任务,请用运行详情里的 重跑;已结束的审批上不会再出现这两个按钮。
5. 谁能点通过
能点 通过 的人,必须同时满足下面三条:
- 在审批人名单里。 名单外的人点通过,会看到提示「您不在该审批请求的审批人名单中。」如果按团队指定审批人,名单在审批请求生成的那一刻按当时的团队成员确定。
- 不是这次运行的触发人。 推送代码触发的运行,推送的人就是触发人;手动运行时,点 触发 的人就是触发人。触发人点通过会看到提示「不能批准自己触发的运行,请等待其他审批人处理。」不过触发人可以点 拒绝,用来叫停自己发起的部署。
- 有处理审批的权限,并且能访问这个仓库。 角色里要包含 CI/CD → 审批 下的 处理审批 权限,这项权限由系统管理员在角色里分配。
另外,只要任何一位审批人点了 拒绝,这条请求就会结束,任务失败,其他人不需要再处理。
第 2 条最容易让审批卡死。假如名单里只有你自己,那么你推送触发的运行没有人能批准,只能等到超时失败。policy: all 也有同样的问题:只要触发人在名单里,「全部通过」就永远达不成。所以名单里至少要放一个不会触发这条流水线的人,或者把策略改成 any、quorum。前面那条记录正是这种情况:Angus 推送了 main,不能批准自己的运行,admin 通过之后任务才继续。
6. 审批一直卡住或没有出现
审批没有按预期出现,或者一直等不到结果时,按下表对照:
| 你看到的 | 原因 | 怎么处理 |
|---|---|---|
任务写了 required: true,却直接运行了 |
approvers 为空;或者启用了审批策略,但策略里关闭了 需要人工审批
|
在 approvers 里填用户 ID;到流水线详情的 审批 页签确认哪份配置在生效 |
| 构建和测试任务也在等审批 | 流水线启用了审批策略,策略作用于全部任务(05 Deploy Approval 目前就是这样) | 只想审 deploy-production 时,先禁用 E2E Deploy Approval,改用 YAML 里的 approval
|
| 点通过提示「不能批准自己触发的运行」 | 你是这次运行的触发人 | 请名单里的其他人处理;以后在名单里多放一个人 |
| 点通过提示「您不在该审批请求的审批人名单中」 | 你不在名单里,或者团队成员是在请求生成之后才加入的 | 请名单里的人处理,或者修改配置后重新运行 |
| 审批人说没看到请求 | 目前不会主动发送通知 | 让审批人打开 CI/CD → 审批,看 待我处理 |
| 「全部通过」一直达不成,最后超时 | 触发人也在名单里,而触发人不能批准自己的运行 | 把 policy 改为 any 或 quorum,或者把触发人移出名单 |
| 任务失败,已审批记录 里显示超时 | 在 timeout 时间内没有达到通过条件 |
调大 timeout,或者让审批人及时处理后重新运行 |
常见问题
审批和拉取请求里的代码评审有什么区别?
代码评审决定这段代码能不能合并,看的是改动本身;流水线审批决定这一次运行能不能继续,通常发生在代码合并之后、部署之前。两者可以配合使用:代码评审通过后合并,合并触发的构建跑完,再由负责人审批部署。
被拒绝或超时之后,怎么重新来一次?
审批结果只属于这一次运行,任务失败后不能再改成通过。要重来,可以在 已审批记录 里打开这条请求的详情,点 重跑:这会发起一次新的运行,到审批节点时生成新的审批请求。也可以重新推送代码,或者在流水线页面点 触发 手动运行一次。
审批记录能保留多久,能追溯谁批的吗?
通过、拒绝、超时的请求都会保留在 已审批记录 里。详情页的 审批进度 会列出每位审批人的状态(已通过、已拒绝 或 未参与),以及处理时间和备注。
小结
让流水线停下来等人确认,有两种配法:只拦某个任务时,在 YAML 里给它加 approval,approvers 填完整的用户 ID,policy 选 any、all 或 quorum;想不改 YAML、按姓名或团队选人时,到 CI/CD → 治理 → 审批策略 配置。要注意,策略启用后会作用于这条流水线的全部任务并覆盖 YAML,示例流水线 05 Deploy Approval 目前就被 E2E Deploy Approval 覆盖,超时变成了 3600 秒。审批人到 CI/CD → 审批 处理,他必须在名单里,而且不能批准自己触发的运行;任何一人拒绝或等待超时,任务都会失败。审批卡死最常见的原因,是名单里只有触发人自己。
结论: 只拦部署任务时,在 YAML 里给该任务写
approval并填上完整、未被截断的用户 ID,同时确认这条流水线没有启用审批策略(否则新运行会按策略来);审批人在 CI/CD → 审批 点 通过 后任务才继续,触发人不能批准自己发起的运行。



Top comments (0)