罗罗编程学习记录
本页内容 展开查看

08.6.2 Kustomize 与环境差异管理

所属:全栈开发面试题库 / 08 云原生与 DevOps / 08.6 Helm 与 Operator

覆盖范围

  • Kustomize 理念与 base/overlay 结构
  • kustomization.yaml 常见字段
  • patches、strategic merge、JSON patch
  • 配置映射与 Secret 生成器
  • Kustomize 与 Helm 的差异与选型

高频题速览

编号 题目 难度 频率
08.6.2-001 Kustomize 是什么?与 Helm 有什么区别? 基础 ★★★★★
08.6.2-002 base 与 overlay 怎么组织? 基础 ★★★★★
08.6.2-003 kustomization.yaml 有哪些常用字段? 进阶 ★★★★
08.6.2-004 patches 有哪几种写法? 进阶 ★★★★
08.6.2-005 configMapGenerator 与 secretGenerator 怎么用? 进阶 ★★★★
08.6.2-006 Kustomize 如何做跨环境配置差异? 进阶 ★★★★
08.6.2-007 namePrefix 与 namespace 全局修改? 基础 ★★★
08.6.2-008 Kustomize 与 Helm 怎么配合? 进阶 ★★★
08.6.2-009 为什么 Kustomize 不用模板变量? 进阶 ★★★★
08.6.2-010 Kustomize 与原生 kubectl 的关系? 基础 ★★★★

08.6.2-001 Kustomize 是什么?与 Helm 有什么区别?

一句话结论

Kustomize 是无模板的 K8s 配置定制工具,用 base + overlay 的方式在原生 YAML 上做 patch;Helm 是模板化包管理,用 values + 模板渲染;Kustomize 不引入变量语法,Helm 用 Go template。

概念解释

  • Kustomize:原生 YAML 为基础,overlay 叠加 patch。
  • Helm:模板 + values 渲染,参数化复用。
  • 区别:Kustomize 不引入新语法,Helm 引入模板语言;Kustomize 适合环境差异,Helm 适合分发与复用。

原理流程

  1. Kustomize:读 base YAML,按 overlay patch 叠加。
  2. Helm:读 values,渲染模板生成 YAML。

代码 / 示例

Kustomize:
  base/           # 原始 YAML
  overlays/
    dev/          # dev patch
    prod/         # prod patch

Helm:
  charts/mychart/
    values.yaml
    templates/*.yaml

常见误区

  • 误区:Kustomize 能替代 Helm;正解:Kustomize 适合组织内多环境差异,Helm 适合对外分发与版本化依赖;两者常配合使用。
  • 误区:Kustomize 是 kubectl 的子命令;正解:Kustomize 是独立工具,但 kubectl 内置了 kustomize 能力(kubectl apply -k)。

追问

  • Q:什么场景选 Kustomize? A:同一套配置在 dev/staging/prod 差异小(副本数、镜像 tag、资源限额),不想引入模板语言。
  • Q:什么场景选 Helm? A:需要对外发布 Chart、有复杂依赖、参数化程度高。

08.6.2-002 base 与 overlay 怎么组织?

一句话结论

base 放通用资源(Deployment、Service 等),overlay 放环境差异(patches、不同副本数、不同镜像),overlay 通过 bases: [../../base] 引用 base 再叠加。

概念解释

  • base:所有环境共享的原始 YAML。
  • overlay:特定环境(dev/prod)的差异层。
  • kustomization.yaml:在 base 与 overlay 各有一份。

原理流程

  1. base/kustomization.yaml 列出 resources。
  2. overlay/dev/kustomization.yaml 引用 base 并写 patches。
  3. kubectl apply -k overlays/dev 渲染 base + dev overlay。

代码 / 示例

app/
  base/
    kustomization.yaml
    deployment.yaml
    service.yaml
  overlays/
    dev/
      kustomization.yaml
      replica_count.yaml
    prod/
      kustomization.yaml
      replica_count.yaml
      hpa.yaml
# overlays/dev/kustomization.yaml
resources:
  - ../../base
patches:
  - path: replica_count.yaml

常见误区

  • 误区:overlay 复制 base 文件再改;正解:overlay 只写差异 patch,不复制整个文件,base 是 single source of truth。
  • 误区:base 不能包含 configMapGenerator;正解:base 可以有 generator,overlay 可以追加。

追问

  • Q:多环境差异很大怎么办? A:拆多个 base,或用 components(Kustomize 组件复用)。
  • Q:如何预览渲染结果? A:kubectl kustomize overlays/dev。

08.6.2-003 kustomization.yaml 有哪些常用字段?

一句话结论

常用字段有 resources(要包含的资源)、bases(引用其他 kustomization)、patches(补丁)、configMapGenerator/secretGenerator、namePrefix/nameSuffix、namespace、commonLabels/commonAnnotations。

概念解释

  • resources:直接列出 YAML 文件。
  • bases:引用其他 kustomization 目录(已逐步被 resources 替代)。
  • patches:对资源打补丁。
  • configMapGenerator:从文件或字面值生成 ConfigMap。
  • namePrefix/nameSuffix:给所有资源名加前后缀。
  • namespace:全局改命名空间。

原理流程

  1. kustomize 按 resources/bases 收集所有资源。
  2. 应用 namePrefix/namespace/commonLabels。
  3. 应用 patches。
  4. 生成 generator 资源(ConfigMap/Secret)。

代码 / 示例

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  - deployment.yaml
  - service.yaml
namePrefix: myapp-
namespace: prod
commonLabels:
  app: myapp
patches:
  - path: replica_count.yaml
configMapGenerator:
  - name: app-config
    literals:
      - LOG_LEVEL=info

常见误区

  • 误区:resources 与 bases 一样;正解:bases 是旧写法,新写法统一用 resources 引用目录。
  • 误区:commonLabels 会改 selector;正解:commonLabels 会同时改 labels 与 selector,改 selector 会导致 Deployment 重建 Pod,要谨慎。

追问

  • Q:namespace 全局改有什么风险? A:跨 namespace 资源(如 ClusterRoleBinding)会出问题,要注意。
  • Q:如何只给特定资源加 label? A:用 patches 精确改,不要用 commonLabels。

08.6.2-004 patches 有哪几种写法?

一句话结论

Kustomize patch 分 strategic merge patch(按 K8s schema 智能合并)与 JSON patch(RFC 6902,精确 add/replace/remove);还有 patch target 精确指定目标资源。

概念解释

  • strategic merge:写部分字段,K8s schema 决定如何合并(list 按 key 合并)。
  • JSON patch:精确操作 op: add/replace/remove,path 指向字段。
  • patch target:在 kustomization.yaml 里用 target 选择要打补丁的资源。

原理流程

  1. strategic merge:写 Deployment 的 replicas 字段,kustomize 只改 replicas,其他保留。
  2. JSON patch:写 [{"op":"replace","path":"/spec/replicas","value":5}]。

代码 / 示例

# strategic merge patch (replica_count.yaml)
apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
spec:
  replicas: 5
# JSON patch
- target:
    kind: Deployment
    name: myapp
  patch: |-
    - op: replace
      path: /spec/replicas
      value: 5

常见误区

  • 误区:strategic merge 与 JSON merge patch 一样;正解:strategic merge 是 K8s 特有的,list 按 key(如 containers 的 name)合并;JSON merge patch 是 RFC 7386,list 整体替换。
  • 误区:patch 文件必须包含完整资源;正解:patch 只写要改的字段,name 必须匹配。

追问

  • Q:如何给 Deployment 加一个新容器? A:strategic merge 写 containers 列表,K8s 按 name 合并;新 name 会追加。
  • Q:如何删除某个 list 元素? A:用 JSON patch 的 op: remove 配合 path。

08.6.2-005 configMapGenerator 与 secretGenerator 怎么用?

一句话结论

generator 从字面值或文件生成 ConfigMap/Secret,自动加内容 hash 后缀,配置变化时自动更新 Pod 引用;secretGenerator 用 type: Opaque 与 literals 或 files。

概念解释

  • generator:在 kustomize 里声明,渲染时生成资源。
  • hash 后缀:ConfigMap 名带内容 hash,内容变 hash 变,Pod 引用自动更新。
  • literals:直接写 key=value。
  • files:从文件读取。

原理流程

  1. kustomize 渲染时执行 generator。
  2. 计算内容 hash,生成 <name>-<hash> 的 ConfigMap。
  3. Pod envFrom/configMapKeyRef 自动指向带 hash 的名字。

代码 / 示例

configMapGenerator:
  - name: app-config
    literals:
      - LOG_LEVEL=info
      - FEATURE_FLAG=true
    files:
      - app.properties=config/app.properties
secretGenerator:
  - name: app-secret
    literals:
      - DB_PASSWORD=changeme
    type: Opaque

常见误区

  • 误区:generator 生成的 Secret 会明文提交 Git;正解:secretGenerator 只是把字面值编码成 base64,不是加密,敏感值仍不能提交 Git,要用 Sealed Secrets。
  • 误区:改 ConfigMap 后 Pod 自动重启;正解:hash 后缀让 Pod 引用的 ConfigMap 名变化,Pod 滚动重启,实现配置热更新。

追问

  • Q:如何关闭 hash 后缀? A:generatorOptions: { disableNameSuffixHash: true },但会失去配置变更自动重启能力。
  • Q:如何引用 generator 生成的 ConfigMap? A:直接写名字(不带 hash),kustomize 自动替换为带 hash 的名字。

08.6.2-006 Kustomize 如何做跨环境配置差异?

一句话结论

每个环境一个 overlay,通过不同的 patches、replica 数、image tag、资源限额、环境变量叠加;base 保持稳定,overlay 只写差异。

概念解释

  • dev overlay:副本数 1、资源限额小、日志 debug。
  • prod overlay:副本数 N、HPA、资源限额大、日志 info。
  • 镜像 tag:dev 用 latest,prod 用固定版本。

原理流程

  1. base 定义 Deployment/Service 等通用资源。
  2. dev overlay 补丁:replicas=1、image tag=latest。
  3. prod overlay 补丁:replicas=3、加 HPA、image tag=v1.2.3。

代码 / 示例

# overlays/dev/kustomization.yaml
patches:
  - target: { kind: Deployment, name: myapp }
    patch: |-
      - op: replace
        path: /spec/replicas
        value: 1
images:
  - name: myapp
    newTag: latest

常见误区

  • 误区:每个环境都复制一份完整 YAML;正解:用 overlay patch,base 是 single source of truth。
  • 误区:prod 与 dev 差异很大就拆成两个 base;正解:差异大时考虑拆 base 或用 components,而不是复制。

追问

  • Q:如何只在 prod 加 HPA? A:prod overlay 的 resources 里加 hpa.yaml,dev 不加。
  • Q:如何用 images 字段改镜像? A:images: [{name: myapp, newName: registry.example/myapp, newTag: v1.2.3}],不用改 Deployment。

08.6.2-007 namePrefix 与 namespace 全局修改?

一句话结论

namePrefix 给所有资源名加前缀,namespace 把所有 namespaced 资源放到指定命名空间;常用于多套环境部署在同一集群(如 dev/prod 各一套)。

概念解释

  • namePrefix:所有资源名前加前缀,避免冲突。
  • namespace:所有 namespaced 资源的目标命名空间。
  • 适用:同一集群部署多套环境。

原理流程

  1. kustomize 渲染时遍历所有资源。
  2. namespaced 资源 metadata.name 前加 prefix。
  3. metadata.namespace 设为指定值。

代码 / 示例

namePrefix: prod-
namespace: prod
Deployment myapp -> prod-myapp
namespace: default -> prod

常见误区

  • 误区:namePrefix 会改 Service 之间的 DNS 引用;正解:Kustomize 会自动改引用(如 Service 的 DNS 名),但跨资源引用(如 ExternalName、Helm 子 Chart)可能漏改。
  • 误区:namespace 改了 ClusterRoleBinding 也跟着改;正解:ClusterRoleBinding 是集群级,namespace 不影响。

追问

  • Q:nameSuffix 怎么用? A:与 namePrefix 类似,给资源名加后缀,如 -v2。
  • Q:如何在同一集群部署 dev 与 prod? A:dev 用 namePrefix=dev-、namespace=dev;prod 用 namePrefix=prod-、namespace=prod。

08.6.2-008 Kustomize 与 Helm 怎么配合?

一句话结论

用 Helm 渲染 Chart 输出 YAML,再用 Kustomize overlay 打环境差异;Helm 负责包管理与依赖,Kustomize 负责环境差异,两者分层。

概念解释

  • Helm template:把 Chart 渲染成 YAML(不 apply)。
  • Kustomize:在渲染结果上打 patch。
  • 常见模式:Helm 渲染 base,Kustomize overlay 加环境差异。

原理流程

  1. helm template mychart ./chart --output-dir ./base。
  2. base 目录是 Helm 渲染的 YAML。
  3. overlay 用 Kustomize patch。
  4. kubectl apply -k overlays/prod。

代码 / 示例

helm template ingress-nginx ingress-nginx/ingress-nginx \
  --namespace ingress-nginx \
  --output-dir ./base
kubectl kustomize overlays/prod
kubectl apply -k overlays/prod

常见误区

  • 误区:Helm 与 Kustomize 二选一;正解:两者互补,Helm 管包,Kustomize 管环境差异,ArgoCD 同时支持两者。
  • 误区:Helm 渲染后 Kustomize 无法 patch;正解:Helm 输出的是普通 YAML,Kustomize 完全可以 patch。

追问

  • Q:ArgoCD 里怎么用? A:ArgoCD Application 可指定 helm 或 kustomize 类型,也可以先 helm template 再 kustomize。
  • Q:为什么不直接用 Helm values 做环境差异? A:Helm values 适合参数化(副本数、镜像 tag),复杂结构差异(加 Volume、改 probe)用 Kustomize patch 更清晰。

08.6.2-009 为什么 Kustomize 不用模板变量?

一句话结论

Kustomize 刻意不引入模板变量,保持 YAML 原生可读,避免模板语法让配置难以审阅;环境差异通过 patch 叠加,而不是变量替换。

概念解释

  • 无模板:所有 YAML 都是合法 K8s 资源。
  • Git 友好:diff 是真实 YAML 差异,不是模板渲染。
  • 可审阅:PR review 看到的是真实资源,不是模板语法。

原理流程

  1. base 是完整的合法 YAML。
  2. overlay patch 是差异片段。
  3. 渲染结果 = base + patch,都是真实 YAML。

代码 / 示例

Helm 模板:replicas: {{ .Values.replicas }}
Kustomize:replicas: 3(直接写)

常见误区

  • 误区:Kustomize 不灵活;正解:无模板是设计选择,复杂参数化场景用 Helm,环境差异用 Kustomize。
  • 误区:Kustomize 不能做条件判断;正解:通过 overlay 划分环境,不同环境放不同 overlay,不需要 if。

追问

  • Q:Kustomize 如何做条件? A:没有 if 条件,把条件逻辑拆到不同 overlay,或用 components 组合。
  • Q:这种设计的缺点? A:参数化能力弱,复杂 Chart 用 Kustomize 表达很啰嗦。

08.6.2-010 Kustomize 与原生 kubectl 的关系?

一句话结论

Kustomize 已内置到 kubectl(kubectl apply -k),从 kubectl 1.14 起内置,不需要单独安装 kustomize 二进制;但 kubectl 内置版本可能落后于独立 kustomize。

概念解释

  • kubectl apply -k:应用 kustomize 目录。
  • kubectl kustomize:渲染 kustomize 目录输出 YAML。
  • 独立 kustomize:版本更新,支持新特性。

原理流程

  1. kubectl kustomize dir 渲染输出 YAML。
  2. kubectl apply -k dir 渲染并 apply。

代码 / 示例

kubectl kustomize overlays/prod
kubectl apply -k overlays/prod
kubectl diff -k overlays/prod

常见误区

  • 误区:kubectl 的 kustomize 与独立 kustomize 完全一致;正解:kubectl 内置版本滞后,新特性(如 components、catalog)可能需要独立 kustomize。
  • 误区:kubectl apply -f 不支持 kustomize;正解:用 -k 而不是 -f 指向目录。

追问

  • Q:如何看 kubectl 内置 kustomize 版本? A:kubectl version 里包含 kustomize 版本。
  • Q:生产环境用哪个? A:CI/CD 里用独立 kustomize 固定版本,避免 kubectl 版本升级带来行为变化。

待整理清单

  • [ ] Kustomize components 与复用
  • [ ] Kustomize 与 ArgoCD ApplicationSet
  • [ ] Kustomize 与 kyverno/policy
  • [ ] 多集群 overlay 组织