CI/CD / 系统课时
管理环境配置差异
管理环境配置差异
多环境发布最容易失控的原因,是把测试、预发、生产差异直接写进应用代码或复制出多套清单。本节用 Kustomize 的 base 与 overlay 把公共部署定义和环境参数分离,让同一份应用制品通过少量、可审查的配置进入不同环境。
学习目标
- 能区分应用制品、公共部署定义与环境专属配置的职责。
- 能用 Kustomize
base与overlay管理副本数和运行参数差异。 - 能在发布前渲染并核对环境配置,避免把错误参数带入生产。
先拆分不变项与环境差异
应用代码、容器启动方式、端口和基础探针通常属于公共定义;副本数、日志级别、外部服务地址、资源配额和特性开关更适合成为环境参数。敏感值不要与普通配置一起明文提交,应由 Secret 管理方案或外部密钥系统注入。

用 base 保存公共部署定义
下面的 base/deployment.yaml 只保留所有环境都一致的工作负载结构,并通过 app-config 读取普通运行参数。镜像地址应替换为团队真实仓库,并在正式流水线中优先使用不可变版本或 digest。
apiVersion: apps/v1
kind: Deployment
metadata:
name: checkout-api
spec:
replicas: 1
selector:
matchLabels:
app: checkout-api
template:
metadata:
labels:
app: checkout-api
spec:
containers:
- name: app
image: registry.example.com/checkout-api:1.8.3
envFrom:
- configMapRef:
name: app-configbase/kustomization.yaml 定义公共资源和默认配置,默认值只作为可覆盖的基线。
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- deployment.yaml
configMapGenerator:
- name: app-config
literals:
- APP_ENV=default
- LOG_LEVEL=info这两个文件本身不区分测试或生产环境;环境差异全部留给 overlay,避免复制整份 Deployment 后长期漂移。
用 overlay 只覆盖差异
overlays/staging/kustomization.yaml 可以把预发环境的副本数和日志级别调整为测试需要。
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- ../../base
replicas:
- name: checkout-api
count: 2
configMapGenerator:
- name: app-config
behavior: merge
literals:
- APP_ENV=staging
- LOG_LEVEL=debugoverlays/production/kustomization.yaml 只声明生产环境真正不同的值。
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- ../../base
replicas:
- name: checkout-api
count: 4
configMapGenerator:
- name: app-config
behavior: merge
literals:
- APP_ENV=production
- LOG_LEVEL=infobehavior: merge 会覆盖 base 中同名生成器的键,而不是再创建一套手工复制的 ConfigMap 定义。Kustomize 还会为生成的 ConfigMap 添加内容哈希,并自动更新 Deployment 中的引用。
发布前先渲染再比较
不要直接相信 overlay 文件“看起来没问题”。先让 kubectl 渲染两个环境,确认关键差异只出现在允许变化的位置。
kubectl kustomize overlays/staging | grep -E 'replicas:|APP_ENV:|LOG_LEVEL:'
kubectl kustomize overlays/production | grep -E 'replicas:|APP_ENV:|LOG_LEVEL:'预期输出
APP_ENV: staging
LOG_LEVEL: debug
replicas: 2
APP_ENV: production
LOG_LEVEL: info
replicas: 4字段顺序可能随 kubectl 版本变化,但值应与 overlay 一致。真正部署前还可使用 kubectl diff -k overlays/production -n production 查看集群差异,把意外删除、镜像变化或参数漂移挡在发布动作之前。
避免三类常见配置漂移
不要为每个环境复制一整套应用代码或完整 YAML;公共逻辑修复后很容易漏改某个环境。不要把数据库密码、令牌等密钥写进普通 ConfigMap 或明文 overlay。也不要让流水线临时用字符串替换修改 YAML,因为这种变更难审查、难复现。
环境配置应该具备三个特征:差异最小、来源可追踪、渲染结果可验证。做到这三点,同一份制品才能在测试、预发和生产之间稳定晋级,而不是靠维护多套近似代码来维持环境一致性。