Kustomize 常用命令速查

常用命令

kustomize init
kustomize build overlays/prod
kubectl apply -k overlays/prod
kubectl kustomize overlays/prod
kustomize edit set image app=registry.example.com/app:1.0.0
kustomize edit add resource deployment.yaml
kustomize edit add patch --path patch.yaml

目录结构：

base/
  kustomization.yaml
  deployment.yaml
  service.yaml
overlays/
  dev/kustomization.yaml
  prod/kustomization.yaml

overlay 示例：

resources:
- ../../base
images:
- name: app
  newName: registry.example.com/app
  newTag: 1.0.0
patches:
- path: replicas.yaml

场景速查

易错点

• kustomization.yaml 里的路径相对于该文件，不是当前目录。
• commonLabels 会加到 selectors，可能影响已有 Deployment。
• configMapGenerator 改名会触发滚动更新，注意 hash 后缀。
• patch 的 target 匹配不到资源时不会报错，容易漏改。
• kubectl apply -k 和 kustomize build | kubectl apply -f - 行为基本一致，但版本要匹配。
• 多环境 overlay 不要复制整份 base，容易漂移。
• 密钥不要用 secretGenerator 明文提交到 Git。

相关命令

• kustomize — Kustomize 详细用法
• helm — Helm
• kubectl — apply -k
• helm-cheatsheet — Helm 速查
• argocd-cheatsheet — Argo CD 速查