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 适合分发与复用。
原理流程
- Kustomize:读 base YAML,按 overlay patch 叠加。
- 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 各有一份。
原理流程
- base/kustomization.yaml 列出 resources。
- overlay/dev/kustomization.yaml 引用 base 并写 patches。
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:全局改命名空间。
原理流程
- kustomize 按 resources/bases 收集所有资源。
- 应用 namePrefix/namespace/commonLabels。
- 应用 patches。
- 生成 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 选择要打补丁的资源。
原理流程
- strategic merge:写 Deployment 的 replicas 字段,kustomize 只改 replicas,其他保留。
- 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:从文件读取。
原理流程
- kustomize 渲染时执行 generator。
- 计算内容 hash,生成
<name>-<hash>的 ConfigMap。 - 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 用固定版本。
原理流程
- base 定义 Deployment/Service 等通用资源。
- dev overlay 补丁:replicas=1、image tag=latest。
- 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 资源的目标命名空间。
- 适用:同一集群部署多套环境。
原理流程
- kustomize 渲染时遍历所有资源。
- namespaced 资源 metadata.name 前加 prefix。
- 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 加环境差异。
原理流程
helm template mychart ./chart --output-dir ./base。- base 目录是 Helm 渲染的 YAML。
- overlay 用 Kustomize patch。
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 看到的是真实资源,不是模板语法。
原理流程
- base 是完整的合法 YAML。
- overlay patch 是差异片段。
- 渲染结果 = 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:版本更新,支持新特性。
原理流程
kubectl kustomize dir渲染输出 YAML。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 组织