3. Kustomize 安装与配置：kubectl内置Kustomize、独立二进制安装、版本兼容性检查

Kustomize 的安装方式主要分为两种：kubectl 内置模式（推荐用于日常开发）和独立二进制安装（适用于 CI/CD 管道或需要固定版本的场景）。本章将详细讲解这两种方式的安装步骤、版本验证方法以及跨版本兼容性检查策略。

3.1 安装方式对比

3.2 安装步骤详解

3.2.1 方式一：使用 kubectl 内置 Kustomize

从 Kubernetes v1.14 开始，kubectl 已内置 Kustomize 支持。你只需确保 kubectl 版本满足最低要求即可。

1. 检查 kubectl 版本：确认版本 ≥ v1.14。
2. 验证内置 Kustomize 版本：运行以下命令查看内置版本号。

kubectl version --client --short

3. 测试 Kustomize 功能：在包含 kustomization.yaml 的目录中执行。

kubectl kustomize ./overlays/production

3.2.2 方式二：独立二进制安装

独立安装允许你精确控制 Kustomize 版本，适合需要长期稳定构建的 CI/CD 环境。

1. 下载二进制文件：从 Kustomize 官方 GitHub Release 页面获取对应操作系统和架构的压缩包。
2. 解压并安装：将可执行文件移动到 /usr/local/bin 或添加到 $PATH 中。
3. 验证安装：运行版本检查命令。

# Linux / macOS 示例
curl -s "https://raw.githubusercontent.com/kubernetes-sigs/kustomize/master/hack/install_kustomize.sh" | bash
sudo mv kustomize /usr/local/bin/
kustomize version

3.3 版本兼容性检查

Kustomize 的版本演进中引入了多项破坏性变更。以下表格列出了关键版本之间的兼容性要点：

3.3.1 版本检查命令

# 检查独立 Kustomize 版本
kustomize version

# 检查 kubectl 内置 Kustomize 版本（kubectl v1.21+）
kubectl kustomize version

# 检查 kustomization.yaml 的 apiVersion 兼容性
grep "apiVersion" kustomization.yaml

3.3.2 跨版本迁移检查清单

• 检查 vars 使用：如果 kustomization.yaml 中包含 vars 字段，且目标 Kustomize 版本 ≥ v5.0，必须迁移到 replacements。
• 检查 patchesStrategicMerge：建议统一替换为 patches 字段，以保持向前兼容。
• 检查插件路径：独立安装的 Kustomize 插件路径默认为 ~/.config/kustomize/plugin，而 kubectl 内置版本可能不加载外部插件。
• 验证构建输出：在切换版本后，使用 diff 工具对比新旧版本的构建输出，确保无意外变更。

3.4 安装架构与版本管理流程

下图展示了两种安装方式在开发与生产环境中的典型部署架构，以及版本兼容性检查的关键节点。

3.5 常见安装问题与排查