2. Kustomize 基础：Kustomize 是什么、核心概念与安装

2.1 Kustomize 是什么

Kustomize 是 Kubernetes 生态中原生的配置管理工具，它通过 声明式覆盖（Declarative Overlay） 机制，在不修改原始 YAML 文件的前提下，实现对 Kubernetes 资源的多环境定制。Kustomize 自 kubectl 1.14 起被内置为 kubectl apply -k 子命令，无需额外安装即可使用。

2.2 核心概念

2.2.1 kustomization.yaml

每个 Kustomize 项目的根目录下必须包含一个 kustomization.yaml 文件，它是整个定制过程的 入口清单。该文件声明了所有要管理的资源路径、要应用的补丁、要生成的 ConfigMap/Secret 等。

# 一个典型的 kustomization.yaml 结构
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization

# 1. 资源引用
resources:
  - deployment.yaml
  - service.yaml
  - namespace.yaml

# 2. 名称前缀
namePrefix: prod-

# 3. 通用标签
commonLabels:
  app.kubernetes.io/managed-by: kustomize
  environment: production

# 4. 镜像替换
images:
  - name: nginx
    newTag: 1.25.3-alpine

# 5. 补丁（Patches）
patches:
  - path: increase-replicas.yaml
    target:
      kind: Deployment
      name: web-app

2.2.2 resources（资源声明）

resources 字段列出所有需要被 Kustomize 管理的原始 Kubernetes YAML 文件路径。这些文件可以是 Deployment、Service、ConfigMap、Namespace 等任意合法资源。Kustomize 会按顺序读取并合并它们，然后应用后续的补丁和转换。

2.2.3 patches（补丁）

补丁是 Kustomize 实现 环境差异化 的核心机制。Kustomize 支持两种补丁策略：Strategic Merge Patch（SMP） 和 JSON Patch（RFC 6902）。

• Strategic Merge Patch（推荐）：Kubernetes 原生支持的合并策略，可以按 kind、name、namespace 等字段精准定位目标资源，并只覆盖指定字段。
• JSON Patch：使用 add、remove、replace 操作数组索引或路径，适合对列表字段做精确修改。

# patches 示例：为生产环境增加副本数
# increase-replicas.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: web-app
spec:
  replicas: 5

2.3 Kustomize 工作流程（SVG）

2.4 安装与版本选择

2.4.1 安装方式

2.4.2 版本选择建议

Kustomize 版本与 Kubernetes API 版本存在对应关系。建议根据集群版本选择兼容的 Kustomize 版本：

2.5 验证安装

安装完成后，运行以下命令验证 Kustomize 是否正常工作：

# 检查 kubectl 内置版本
kubectl version --client

# 检查独立 Kustomize 版本（如果单独安装）
kustomize version

# 快速测试：创建一个空目录并运行 kustomize build
mkdir test-kustomize && cd test-kustomize
cat <<EOF > kustomization.yaml
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources: []
EOF
kustomize build .   # 应输出空资源列表，无报错