4. 安装 Operator SDK：不同操作系统下的安装方法、验证安装、SDK 版本选择建议

在开始构建自定义 CRD 控制器之前，首先需要正确安装 Operator SDK。本章将覆盖主流操作系统下的安装方法、安装后的验证步骤，以及 SDK 版本选择的实用建议，确保你拥有一个稳定、可复现的开发环境。

4.1 SDK 版本选择建议

Operator SDK 目前主要维护两个大版本线：1.x（稳定版）和 2.x（开发版）。对于初学者和生产级项目，推荐使用 1.x 的最新稳定版本（如 v1.37.x）。

4.2 不同操作系统下的安装方法

Operator SDK 提供三种安装方式：预编译二进制（推荐）、Homebrew（macOS / Linux）和源码编译。以下按操作系统分别说明。

4.2.1 macOS

方式一：Homebrew（推荐）

brew install operator-sdk

方式二：预编译二进制

# 下载指定版本（以 v1.37.0 为例）
curl -LO https://github.com/operator-framework/operator-sdk/releases/download/v1.37.0/operator-sdk_darwin_amd64

# 赋予执行权限并移动到 PATH
chmod +x operator-sdk_darwin_amd64
sudo mv operator-sdk_darwin_amd64 /usr/local/bin/operator-sdk

4.2.2 Linux（Ubuntu / CentOS / 通用）

方式一：预编译二进制（推荐）

# 下载 Linux amd64 版本
curl -LO https://github.com/operator-framework/operator-sdk/releases/download/v1.37.0/operator-sdk_linux_amd64

chmod +x operator-sdk_linux_amd64
sudo mv operator-sdk_linux_amd64 /usr/local/bin/operator-sdk

方式二：Snap（Ubuntu）

sudo snap install operator-sdk --classic

4.2.3 Windows

Windows 用户建议使用 WSL2（Windows Subsystem for Linux），在 WSL2 的 Linux 环境中按照 Linux 方式安装。如果需要在原生 Windows 环境中使用，请下载预编译 exe 文件：

# 使用 PowerShell 下载
Invoke-WebRequest -Uri https://github.com/operator-framework/operator-sdk/releases/download/v1.37.0/operator-sdk_windows_amd64.exe -OutFile operator-sdk.exe

# 将 operator-sdk.exe 移动到 PATH 目录（如 C:\Windows\System32\）

4.3 验证安装

安装完成后，执行以下命令验证 SDK 是否可用：

operator-sdk version

预期输出示例：

operator-sdk version: "v1.37.0", commit: "abc123def456", kubernetes version: "1.28", go version: "go1.21.13", GOOS: "linux", GOARCH: "amd64"

进一步验证 SDK 的核心功能是否正常：

# 查看帮助信息
operator-sdk --help

# 初始化一个临时项目（不保留，仅测试）
mkdir /tmp/sdk-test && cd /tmp/sdk-test
operator-sdk init --domain example.com --repo github.com/example/test-operator
# 如果 init 成功，说明 SDK 核心功能正常
rm -rf /tmp/sdk-test

4.4 安装后的环境依赖检查

Operator SDK 依赖以下工具链，请确保它们已正确安装：

echo "=== Go ===" && go version
echo "=== Docker ===" && docker --version
echo "=== kubectl ===" && kubectl version --client
echo "=== kustomize ===" && kustomize version
echo "=== operator-sdk ===" && operator-sdk version

4.5 SDK 安装架构与工作流程

下图展示了 Operator SDK 安装后的核心组件架构，以及 SDK 如何与 Go 工具链、Docker 和 Kubernetes 集群交互：

4.6 常见安装问题与排查

• “command not found: operator-sdk” — 检查二进制是否在 PATH 中，或使用 which operator-sdk 定位。
• “go: command not found” — 先安装 Go 1.21+，并确保 $GOPATH/bin 在 PATH 中。
• “permission denied” — 使用 chmod +x 赋予执行权限，或使用 sudo 移动二进制。
• 版本不匹配警告 — 检查 operator-sdk version 输出的 Kubernetes 版本是否与目标集群匹配。