CI/CD / 系统课时

添加人工审批节点

添加人工审批节点

人工审批节点的价值不是让所有发布都“多点一次确认”,而是在生产等高风险环境前设置一个不可绕过的权限边界。审批人应基于固定制品、测试证据和变更说明做决定,批准后流水线继续,拒绝时生产环境保持不变。

学习目标

  • 判断哪些环境跃迁值得增加人工审批
  • 把审批权限绑定到受保护环境,而不是普通脚本变量
  • 让审批记录同时包含制品身份、变更说明和可审计结果

把审批放在风险跃迁之前

开发和测试环境通常适合全自动发布,因为失败影响有限且需要快速反馈。人工审批更适合放在“预发布到生产”“普通区域到核心区域”或其他风险明显上升的跃迁前。审批之前应完成自动测试、扫描和制品校验,让人只判断自动化难以替代的业务风险与变更时机。

高风险环境前的人工审批门禁与批准拒绝分支

审批节点不应放在构建之前,因为那会让审批对象在批准后继续变化;也不应让审批人手工输入一个全新的版本号。最安全的对象是已经通过前置验证、具有不可变摘要的候选制品。

把权限绑定到受保护环境

下面以 GitHub Actions 为具体例子。片段示例:假设仓库已经有 scripts/deploy-production.sh,且名为 production 的 Environment 已配置 required reviewers。environment: production 让部署作业受环境保护规则控制;change_note 和 artifact_digest 则把变更说明与本次候选制品带入发布记录。

yaml
name: promote-production
run-name: "Promote ${{ inputs.artifact_digest }}"

on:
  workflow_dispatch:
    inputs:
      artifact_digest:
        description: "Approved image digest"
        required: true
        type: string
      change_note:
        description: "Change reason and risk note"
        required: true
        type: string

permissions:
  contents: read

jobs:
  deploy:
    runs-on: ubuntu-latest
    # 审批发生在作业获得 production 环境权限之前
    environment: production
    concurrency:
      group: production
      cancel-in-progress: false
    steps:
      - uses: actions/checkout@v4

      # 在进入实际部署脚本前拒绝明显无效的审批请求
      - name: Validate request
        shell: bash
        run: |
          test -n "${{ inputs.change_note }}"
          case "${{ inputs.artifact_digest }}" in
            sha256:*) ;;
            *) echo "artifact_digest must be sha256"; exit 1 ;;
          esac

      # 部署脚本只接收已经被审批的不可变摘要
      - name: Deploy approved artifact
        shell: bash
        env:
          DIGEST: ${{ inputs.artifact_digest }}
        run: ./scripts/deploy-production.sh "${DIGEST}"

这是工作流配置片段,不是独立可运行脚本。生效行为应通过一次测试发布验证:触发工作流后,deploy 作业在进入 production 环境前等待 required reviewer;批准后才执行部署步骤,拒绝则不执行生产部署。审批规则本身应由环境保护配置维护,而不是在 YAML 里用普通布尔变量模拟。

让审批人看到完整变更包

审批页面至少应能回答四个问题:要发布的不可变制品是什么、它已经通过哪些验证、这次变更为什么现在发布、失败时回退到哪个已知稳定版本。若这些信息需要审批人临时去多个系统拼凑,审批就容易退化成机械点击。

变更说明应简短但可追溯,包含影响范围、风险点和回退动作。高风险发布还可以附上关联工单或变更记录,但不要把生产密钥、令牌等敏感值放进说明文本。生产凭证应由受保护环境在审批通过后提供给作业。

验证审批确实不可绕过

上线前至少做一次拒绝路径和一次越权测试。使用无审批权限的账号触发发布时,应该只能发起请求而不能批准;审批拒绝后,生产版本应保持原摘要;审批通过后,部署结果应与被批准的 artifact_digest 一致,并留下审批人、时间和流水线运行记录。

还要保护工作流文件和部署脚本本身,避免发布人通过修改 CI 配置删除 environment: production 或替换部署逻辑来绕过门禁。人工审批只有与代码评审、受保护分支、环境权限和审计记录共同生效时,才真正构成发布控制,而不是一段可以随意改掉的流程装饰。

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

目录与阅读设置

阅读设置

17

记录一个想法

添加人工审批节点

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

登录哪都通