容器与云原生 / 系统课时

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 与多环境 overlay 的组合关系

一个最小 base 由 kustomization.yaml 和被引用的 Deployment 组成。resources 声明要参与组合的基础资源,base 本身不关心当前是哪个环境。

yaml
# base/kustomization.yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - deployment.yaml
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 维护,环境目录只留下真正需要评审的差异。

yaml
# 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"
yaml
# 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 校验。

bash
kubectl kustomize overlays/prod

预期输出

yaml
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 的可审计性。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Kustomize 多环境配置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通