CI/CD / 系统课时

实现环境晋级发布

实现环境晋级发布

这一课把一个已经构建完成的镜像按固定顺序晋级到测试、预发布和生产环境。核心不是重复构建三次,而是让同一个镜像摘要穿过自动部署、人工审批和并发控制,确保每次晋级都有明确门禁且不会被并行发布互相覆盖。

学习目标

  • 使用同一个不可变镜像摘要完成测试、预发布和生产部署
  • 用环境审批把高风险晋级变成显式门禁
  • 用并发组避免同一环境同时执行多个部署

用同一摘要贯穿三套环境

环境晋级必须围绕“同一制品”展开。测试环境通过后,不应重新构建一个“看起来相同”的生产镜像,而应继续使用同一个 sha256 摘要。这样测试验证的内容与最终上线内容完全一致,回滚时也能精确定位旧版本。

环境晋级与审批并发控制

编排顺序、审批和并发锁

下面继续以 GitHub Actions 为例。工作流只接收镜像摘要,不接收可变标签;三个部署作业通过 needs 严格串行。preproduction 和 production 环境需要在仓库的 Environment protection rule 中配置 Required reviewers,YAML 中的 environment 会把作业接入对应审批门禁。

yaml
name: promote

on:
  workflow_dispatch:
    inputs:
      image_digest:
        description: Immutable image digest
        required: true
        type: string

permissions:
  contents: read

env:
  # 三套环境始终复用这一不可变镜像引用
  IMAGE: ghcr.io/acme/app@${{ inputs.image_digest }}

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - name: Verify digest
        env:
          IMAGE_DIGEST: ${{ inputs.image_digest }}
        run: |
          [[ "$IMAGE_DIGEST" =~ ^sha256:[0-9a-f]{64}$ ]]

  # 每个环境使用独立并发组,避免同环境并行部署
  deploy-test:
    needs: validate
    runs-on: ubuntu-latest
    environment: test
    concurrency:
      group: deploy-test
      cancel-in-progress: false
    steps:
      - uses: azure/setup-kubectl@v4
      - name: Deploy test
        env:
          KUBECONFIG_DATA: ${{ secrets.KUBECONFIG_DATA }}
        run: |
          printf '%s' "$KUBECONFIG_DATA" > "$RUNNER_TEMP/kubeconfig"
          export KUBECONFIG="$RUNNER_TEMP/kubeconfig"
          kubectl -n app set image deployment/app app="$IMAGE"
          kubectl -n app rollout status deployment/app --timeout=180s

  # preproduction 环境保护规则负责人工审批
  deploy-preproduction:
    needs: deploy-test
    runs-on: ubuntu-latest
    environment: preproduction
    concurrency:
      group: deploy-preproduction
      cancel-in-progress: false
    steps:
      - uses: azure/setup-kubectl@v4
      - name: Deploy preproduction
        env:
          KUBECONFIG_DATA: ${{ secrets.KUBECONFIG_DATA }}
        run: |
          printf '%s' "$KUBECONFIG_DATA" > "$RUNNER_TEMP/kubeconfig"
          export KUBECONFIG="$RUNNER_TEMP/kubeconfig"
          kubectl -n app set image deployment/app app="$IMAGE"
          kubectl -n app rollout status deployment/app --timeout=180s

  # production 环境保护规则负责最终审批
  deploy-production:
    needs: deploy-preproduction
    runs-on: ubuntu-latest
    environment: production
    concurrency:
      group: deploy-production
      cancel-in-progress: false
    steps:
      - uses: azure/setup-kubectl@v4
      - name: Deploy production
        env:
          KUBECONFIG_DATA: ${{ secrets.KUBECONFIG_DATA }}
        run: |
          printf '%s' "$KUBECONFIG_DATA" > "$RUNNER_TEMP/kubeconfig"
          export KUBECONFIG="$RUNNER_TEMP/kubeconfig"
          kubectl -n app set image deployment/app app="$IMAGE"
          kubectl -n app rollout status deployment/app --timeout=180s

预期结果

text
test: deployment succeeds automatically
preproduction: waits for approval, then deployment succeeds
production: waits for approval, then deployment succeeds
same-environment concurrent run: queued until the active deployment finishes

cancel-in-progress: false 很关键:新发布不会为了抢占环境而取消正在执行的发布。若团队允许新版本覆盖旧版本,应当先明确回滚和审计语义,再改变这一策略,而不是默认开启抢占。

配置环境级凭据

示例中的 KUBECONFIG_DATA 应分别保存在 test、preproduction、production 三个 Environment 的机密中,使每个作业只能读取自己环境的凭据。实际生产更推荐使用云平台 OIDC 或其他短期凭据,避免长期 kubeconfig 成为高价值秘密。

验证晋级是否可控

验收时先用一个测试摘要触发工作流,确认测试环境自动部署;随后确认预发布和生产作业分别停在审批门禁。再启动第二次使用另一个摘要的工作流,观察它在同一环境并发组上排队,而不是与前一次部署并行执行。

最后在三个集群中查看 Deployment 实际镜像,三处都应指向同一个摘要;若任一环境出现重新打标签、重新构建或镜像摘要变化,就已经破坏了“同一制品晋级”的前提。生产级发布的可信度,来自不可变制品、显式审批和环境级串行化三者同时成立。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现环境晋级发布

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

登录哪都通