容器与云原生 / 系统课时
设计多环境交付流程
设计多环境交付流程
这一课把开发、预发布和生产环境串成一条可追溯交付链:镜像只构建一次,环境差异进入配置仓库,版本通过提交和审批逐级晋级,失败时可直接回退对应配置提交。
学习目标
- 设计“构建一次、跨环境晋级”的不可变镜像策略。
- 组织多环境配置仓库,让环境差异清晰且可审查。
- 为测试、审批、生产发布和回退设置明确门禁。
先固定唯一交付物
最重要的规则是:同一次发布只构建一次镜像。CI 在源码提交上构建镜像并推送到仓库,得到不可变 digest;开发、预发布和生产环境都引用这个 digest,而不是每到一个环境重新构建。
这样做能把“生产里跑的到底是不是测试过的那份二进制”变成可以直接核对的事实。版本标签可以保留用于阅读,但真正的发布身份应以 digest 为准,例如 registry.example.com/storefront@sha256:<VALUE>,其中 <VALUE> 替换为真实镜像摘要。
把环境差异放进配置仓库
一个实用结构是保留共享 base,再为 dev、staging、prod 建独立 overlay。环境目录只存必须变化的内容,例如副本数、域名、资源额度、外部 Secret 引用和镜像 digest,不复制整套 Deployment。
下面是 environments/staging/kustomization.yaml 的片段示例,依赖仓库中已经存在 ../../base:
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- ../../base
images:
- name: registry.example.com/storefront
newName: registry.example.com/storefront
digest: sha256:<VALUE>
patches:
- path: replicas.yaml生产环境使用同一 digest,但可以拥有不同的 replicas.yaml、Ingress 域名和资源额度。Secret 的实际值不要提交到普通 Git 明文文件中,应提交 Secret 引用、加密结果或外部密钥系统所需的声明。
让版本逐级晋级
CI 的职责到“产出镜像并更新配置变更”即可,部署控制器负责把 Git 期望状态同步到各环境。推荐的晋级链路是:开发环境自动接收候选版本,测试通过后把同一 digest 提升到 staging,staging 验收通过并取得审批后,再修改 prod 配置。

环境晋级不是复制镜像,也不是重新执行 Docker build,而是提交“这个环境现在应引用哪个 digest”的配置变化。这样每次发布都能回答三个问题:谁批准的、从哪个版本晋级、当前每个环境运行哪个制品。
为生产设置明确门禁
门禁应尽量落在可审计的 Git 变更上。开发环境可以自动合并机器人生成的版本更新;staging 至少要通过自动化测试;prod 则通常要求受保护分支或路径审批,并限制只有发布负责人或指定团队能批准。
一个最小门禁集合可以包含:镜像漏洞扫描通过、Kustomize 或 Helm 渲染成功、策略检查通过、staging 冒烟测试通过、生产审批完成。生产发布窗口较严格时,还可以让 Git 变更先合并,再由 Argo CD 的同步窗口或人工同步控制真正落地时间。
在 staging 和 prod 都使用 Kustomize 时,门禁还应验证晋级的是同一镜像。可以先渲染清单,再比较镜像字段;以下命令假设两个环境已经晋级到同一个 digest。
STAGING=$(kubectl kustomize environments/staging | awk '/image: registry.example.com\/storefront@sha256:/{print $2; exit}')
PROD=$(kubectl kustomize environments/prod | awk '/image: registry.example.com\/storefront@sha256:/{print $2; exit}')
test -n "$STAGING" && test "$STAGING" = "$PROD" && echo "promotion artifact is identical"预期输出:
promotion artifact is identical如果没有输出,先分别打印 STAGING 和 PROD 检查;常见原因是某个 overlay 仍引用旧 digest,或者渲染后的镜像名称与脚本匹配条件不同。实际 digest 值会随发布版本变化。
把回退也当作一次交付
生产故障时,优先回退配置仓库中最近一次晋级提交,而不是现场修改 Deployment 镜像。回退提交通过与正常发布相同的审批和同步链路,可以保留完整的操作者、时间、差异和恢复版本记录。
多环境流程设计完成后,理想状态是:CI 只负责生成不可变制品,Git 记录各环境期望版本,测试与审批决定版本能否向前晋级,GitOps 控制器负责落地,而回退仍然只是一次可审计的期望状态变更。