容器与云原生 / 系统课时
Kustomize 多环境配置
Kustomize 多环境配置
Kustomize 用同一份 Kubernetes 基础清单承载公共配置,再通过 overlay 只描述开发、测试和生产环境的差异。这样可以避免复制整套 YAML,同时让每个环境最终渲染出的资源仍然是普通 Kubernetes 清单,便于审查和部署。
学习目标
- 能用
base保存公共资源,用 overlay 表达环境差异。 - 能用
patches、images等机制覆盖镜像、副本数和环境变量。 - 能在部署前用
kubectl kustomize检查最终生成结果。
用 base 和 overlay 分离共性与差异
base 只放所有环境都成立的声明,例如 Deployment 的选择器、容器名和稳定标签;每个 overlay 引用同一个 base,再追加当前环境特有的补丁。生产环境需要 4 个副本、开发环境只要 1 个副本时,不应复制两份 Deployment,而应只覆盖 spec.replicas。

一个最小 base 由 kustomization.yaml 和被引用的 Deployment 组成。resources 声明要参与组合的基础资源,base 本身不关心当前是哪个环境。
# base/kustomization.yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- deployment.yaml# base/deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: web
spec:
replicas: 1
selector:
matchLabels:
app: web
template:
metadata:
labels:
app: web
spec:
containers:
- name: web
image: registry.example/web:latest
env:
- name: APP_ENV
value: base这里的 replicas: 1、latest 和 APP_ENV=base 只是可被 overlay 覆盖的默认值;Deployment 的名称、选择器和容器名则作为多个环境共享的稳定结构。
在 overlay 中只写差异
生产环境的 overlay 引用 ../../base,通过补丁把副本数和环境变量改成生产值,同时用 images 统一替换镜像标签。这样公共字段仍由 base 维护,环境目录只留下真正需要评审的差异。
# overlays/prod/kustomization.yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- ../../base
patches:
- path: deployment-patch.yaml
images:
- name: registry.example/web
newTag: "2026.09.04"# overlays/prod/deployment-patch.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: web
spec:
replicas: 4
template:
spec:
containers:
- name: web
env:
- name: APP_ENV
value: production补丁只写需要变化的字段即可;Kustomize 会把这些差异合并到同名 Deployment。对测试环境可以建立 overlays/test,只改变镜像版本或副本数,base 不需要复制。
构建后再验证最终清单
部署前先渲染目标 overlay,确认差异已经合并。下面命令不会创建资源,只把最终 YAML 输出到终端,因此适合放进代码审查或 CI 校验。
kubectl kustomize overlays/prod预期输出
apiVersion: apps/v1
kind: Deployment
metadata:
name: web
spec:
replicas: 4
selector:
matchLabels:
app: web
template:
metadata:
labels:
app: web
spec:
containers:
- env:
- name: APP_ENV
value: production
image: registry.example/web:2026.09.04
name: web不同 kubectl 版本生成的字段顺序或缩进可能略有不同;验证重点是副本数为 4、镜像标签为 2026.09.04、APP_ENV 为 production。确认结果正确后,部署阶段应继续消费同一 overlay,而不是复制渲染结果再手工维护另一份 YAML。
控制环境差异的边界
适合放进 overlay 的通常是副本数、镜像标签、Ingress 域名、资源配额、环境变量和少量环境专属资源。若两个环境的应用结构已经明显不同,例如生产多出独立队列、完全不同的权限模型或另一套控制器,继续堆补丁会让关系难以追踪,此时应拆分 base 或重新划分目录。
Kustomize 的核心不是“少写 YAML”,而是让公共声明只有一个来源,让环境差异集中、可比较、可渲染。只要每次变更都先检查最终清单,就能在减少重复的同时保留 Kubernetes 原生 YAML 的可审计性。