同一版本如何从开发、测试、staging 晋级到生产?

从 Helm chart 入门,理解镜像、部署包、环境配置与密钥如何支持可追溯发布。

kubernetesci-cddockerkuberneteshelmsecrets更新 2026-11-17

题目

如何让同一版本从开发、测试、staging 晋级到生产?镜像、Helm chart、配置和密钥各如何管理?

核心思路

生产部署的程序应当是前面验证过的程序。采用“构建一次、逐环境晋级”的方式,固定镜像和部署包,明确管理环境差异,并记录每次部署的完整输入。

这里的“同一版本”允许副本数、数据库地址等环境配置不同,但不能在每个环境重新构建一个内容可能变化的镜像。

Helm chart 是什么?

向 Kubernetes 部署一个服务,通常需要几类资源:

资源 作用
Deployment 描述服务用哪个镜像、运行多少副本、申请多少资源,以及如何更新
Service 为一组服务实例提供稳定访问入口
Ingress 描述外部 HTTP/HTTPS 请求的路由,需要对应的 Ingress controller 执行
ConfigMap 保存普通配置,供应用使用
Secret 承载密码、令牌等敏感信息,需要额外配置权限和保护措施

这些资源通常用 YAML 描述。应用多、环境多时,直接维护多份相似 YAML 容易重复和出错。

Helm 是部署包管理工具,chart 是它使用的部署包,包含 Kubernetes 资源模板、默认参数和包信息。

一个示例 chart 可以长这样:

platform-api/
├── Chart.yaml               # 包名称、版本和依赖声明
├── values.yaml              # 默认参数
└── templates/
    ├── deployment.yaml      # 如何运行应用
    ├── service.yaml         # 如何访问应用
    └── configmap.yaml       # 普通配置

模板从 values 中读取参数。例如开发环境设置:

replicaCount: 1

生产环境设置:

replicaCount: 3

前提是 chart 的 Deployment 模板确实使用了 replicaCount 这个参数。Helm 把模板和参数组合成 Kubernetes 资源定义,再提交给集群。

概念 意义
镜像 要运行的程序及其运行依赖
Chart 描述程序如何部署的模板包
Values 渲染部署模板时使用的参数
Release 一个 chart 在集群中的具名安装实例,升级时会产生新的 revision

同一个 chart 可以安装到不同环境。Chart 版本与应用版本独立:调整部署模板可能只升级 chart,镜像保持不变。Chart.yaml 中的 appVersion 是应用版本信息,本身不会自动锁定实际部署的镜像。

“晋级”具体发生了什么?

假设 CI 从某个 Git commit 构建出一个镜像,并获得其内容摘要 digest。

Git commit → 构建并测试 → 固定镜像与 chart
                              ↓
                        开发环境验证
                              ↓
                        测试环境验证
                              ↓
                        staging 验证
                              ↓
                          生产发布

Staging 是预生产环境,尽量接近生产部署结构与关键配置方式,通常使用隔离的数据、凭据和较小的资源规模。

晋级是在验证通过后,让下一个环境使用同一份候选产物。不同团队可以调整环境顺序和门禁,但候选产物一旦变化,就需要重新进行受影响的验证。

如果测试通过后为生产重新构建,即使 Git commit 一样,基础镜像或依赖下载结果也可能改变。部署时使用固定 digest,可以明确镜像内容;若跨镜像仓库复制产物,也要验证目标内容摘要一致。

四类发布输入如何管理?

对象 管理方式 要解决的问题
镜像 存入镜像仓库,固定 digest,保留测试和扫描结果 避免 latest 或可覆盖标签指向不同内容
Helm chart 保存不可变版本的包,锁定依赖,必要时同时记录包摘要 避免部署模板或依赖在晋级途中变化
普通配置 放入 Git,分公共默认值和环境覆盖值,审查变更并记录 commit 明确环境差异,减少漂移
密钥 独立密钥管理、按环境隔离,通过受控身份获取并注入 避免凭据进入代码、镜像或普通配置

可以按如下方式组织非敏感配置:

deployment-config/
├── common.yaml
└── environments/
    ├── dev.yaml
    ├── test.yaml
    ├── staging.yaml
    └── production.yaml

配置本身也是发布输入,需要校验必填项、格式及兼容性。共享默认值变化同样可能影响生产,不能只审查环境覆盖文件。

以下命令示意如何固定 chart 版本并组合配置,仓库地址和参数仅作示例:

helm upgrade --install platform-api oci://registry.example.com/charts/platform-api \
  --version 1.4.2 \
  --namespace production \
  -f deployment-config/common.yaml \
  -f deployment-config/environments/production.yaml

镜像 digest 应包含在经审查的 values 中,并由模板实际渲染到资源的 image 字段。Helm 参数名称由 chart 作者定义,不存在适用于所有 chart 的统一 image.digest 约定。

密钥为什么要单独管理?

数据库密码、访问令牌和 TLS 私钥应放在专门的密钥管理系统,例如 Vault 或云平台密钥服务。环境配置保存引用,部署或运行时通过授权机制获取值。

密钥轮换可能独立于应用发布发生。若密钥引用始终指向最新版本,应能审计某次运行实际使用的版本;旧凭据被撤销后,应用回滚也必须适配新的有效凭据。

发布记录与门禁

每次部署至少能回答:用了哪个源码版本、镜像摘要、chart 包、环境配置和密钥引用,部署到哪里,验证结果是什么。

例如以下概念清单(不是 Helm 规定的文件格式):

sourceCommit: "<git-commit>"
image: "registry.example.com/platform-api@sha256:<完整摘要>"
chartVersion: "1.4.2"
chartDigest: "sha256:<完整摘要>"
configCommit: "<config-git-commit>"
environment: production
databaseSecretRef: platform/production/database

典型流程是:CI 构建、测试和扫描;测试环境执行集成测试;staging 验证关键业务、配置及迁移;满足门禁后部署生产,并观察错误率、延迟和业务指标。审批可以人工或自动,取决于风险和组织要求。

常见误区

面试回答示例

我会采用构建一次、逐环境晋级的方式。镜像固定 digest,chart 固定不可变版本及依赖,普通配置在 Git 中管理环境差异,密钥独立管理并按环境隔离。每次部署记录这些输入以及验证结果,经过测试和预生产验证后再进入生产。出现问题时,可以定位具体发布输入,并回退到经过兼容性确认的版本。数据库变更和外部副作用需要单独设计恢复方案,不能只依赖 Helm rollback。

如果 Kubernetes 经验有限,可先如实说明实践范围,再结合熟悉的构建、版本管理和发布追踪经验解释上述设计。

延伸问题