---
title: 同一版本如何从开发、测试、staging 晋级到生产？
description: 从 Helm chart 入门，理解镜像、部署包、环境配置与密钥如何支持可追溯发布。
topic: kubernetes
tags: [ci-cd, docker, kubernetes, helm, secrets]
updated: "2026-11-17"
---

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

[返回题库](../index.md)

## 题目

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

## 核心思路

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

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

## Helm chart 是什么？

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

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

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

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

一个示例 chart 可以长这样：

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

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

```yaml
replicaCount: 1
```

生产环境设置：

```yaml
replicaCount: 3
```

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

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

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

## “晋级”具体发生了什么？

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

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

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

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

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

## 四类发布输入如何管理？

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

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

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

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

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

```bash
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 或云平台密钥服务。环境配置保存引用，部署或运行时通过授权机制获取值。

- 开发、测试和生产使用独立凭据及访问权限。
- 明确轮换流程，以及应用通过热加载还是重启获取新值。
- 发布记录保存引用及必要的版本信息，不记录密钥明文。
- Kubernetes Secret 的 Base64 编码不是加密；还需配置访问控制和静态加密等保护措施。
- 将密码作为 Helm values 传入，不代表它不会被保存；值可能进入 Helm 的发布记录，命令行或日志也可能暴露它。

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

## 发布记录与门禁

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

例如以下概念清单（不是 Helm 规定的文件格式）：

```yaml
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 验证关键业务、配置及迁移；满足门禁后部署生产，并观察错误率、延迟和业务指标。审批可以人工或自动，取决于风险和组织要求。

## 常见误区

- **代码 commit 一样就一定是同一产物。** 构建依赖仍可能变化，应复用已验证的产物。
- **同一版本意味着所有环境配置完全相同。** 配置可以不同，但差异必须明确、可审查和可追踪。
- **Chart 版本固定就够了。** 还需固定实际镜像、依赖与配置，仓库也应防止包被覆盖。
- **Helm 会自动完成灰度和业务验证。** Helm 管理部署资源；流量分配、发布门禁和业务指标通常还需要其他机制。
- **Helm rollback 可以撤销所有变化。** 它不能自动恢复数据库数据、撤销外部副作用或恢复已经失效的密钥。

## 面试回答示例

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

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

## 延伸问题

- 如何证明跨仓库复制后的镜像与测试时一致？
- 配置变更没有改镜像，是否也应经过发布验证？
- 密钥轮换后回滚应用，旧版本还能否访问数据库？
- [应用与数据库 schema 同时升级时，如何设计兼容、灰度和回滚？](../databases/schema-migration.md)
