3. 实验环境准备：Minikube 集群搭建、kubectl 配置、Argo Rollouts 控制器安装、Argo Rollouts kubectl 插件安装

本章节将指导你从零搭建一套完整的 Argo Rollouts 实验环境。我们将依次完成 Minikube 本地集群的创建、kubectl 命令行工具的配置、Argo Rollouts 控制器在集群内的部署，以及 Argo Rollouts kubectl 插件的安装。这套环境将作为后续所有灰度发布与自动回滚演练的基础平台。

3.1 实验环境架构总览

下图展示了我们即将搭建的实验环境整体架构。Minikube 作为单节点 Kubernetes 集群运行在本地，Argo Rollouts 控制器作为核心组件部署在集群内，而 kubectl 和 Argo Rollouts 插件则作为客户端工具与集群交互。

3.2 Minikube 集群搭建

Minikube 是运行本地 Kubernetes 集群的最佳工具之一，特别适合学习和实验场景。我们将使用 Minikube 创建一个包含所有必要组件的单节点集群。

3.2.1 安装 Minikube

根据你的操作系统，选择对应的安装方式：

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

brew install minikube

brew install minikube

# 在 WSL2 终端中执行
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

3.2.2 启动 Minikube 集群

启动集群时，我们需要指定足够的资源以确保 Argo Rollouts 及其依赖组件能够正常运行。推荐使用 Docker 驱动，这是最稳定且兼容性最好的方式。

# 启动 Minikube 集群，指定 4GB 内存和 2 个 CPU
minikube start --memory=4096 --cpus=2 --driver=docker

# 验证集群状态
minikube status

# 查看集群节点信息
kubectl get nodes

3.2.3 启用必要的 Minikube 插件

为了支持后续的灰度发布场景，我们需要启用 Ingress 控制器和 Metrics Server 插件。

# 启用 Ingress 控制器，用于外部流量接入
minikube addons enable ingress

# 启用 Metrics Server，用于 Pod 资源监控
minikube addons enable metrics-server

# 验证插件状态
minikube addons list | grep -E "ingress|metrics-server"

3.3 kubectl 配置

Minikube 启动后会自动配置 kubectl 的上下文。我们只需要验证配置是否正确，并确保能够正常访问集群。

3.3.1 验证 kubectl 配置

# 查看当前 kubectl 上下文
kubectl config current-context

# 查看集群信息
kubectl cluster-info

# 测试 API 访问
kubectl api-versions | head -10

3.3.2 配置自动补全（可选但推荐）

# Bash 自动补全
source <(kubectl completion bash)
echo "source <(kubectl completion bash)" >> ~/.bashrc

# Zsh 自动补全
source <(kubectl completion zsh)
echo "source <(kubectl completion zsh)" >> ~/.zshrc

3.4 Argo Rollouts 控制器安装

Argo Rollouts 控制器是灰度发布的核心组件，它负责监听 Rollout 资源的变化并执行相应的发布策略。我们将通过官方提供的清单文件进行安装。

3.4.1 安装控制器

# 创建 argo-rollouts 命名空间
kubectl create namespace argo-rollouts

# 安装 Argo Rollouts 控制器
kubectl apply -n argo-rollouts -f https://github.com/argoproj/argo-rollouts/releases/latest/download/install.yaml

# 查看控制器 Pod 状态
kubectl get pods -n argo-rollouts -w

3.4.2 验证控制器安装

# 查看 Argo Rollouts 相关的 CRD
kubectl get crd | grep argoproj.io

# 查看控制器日志
kubectl logs -n argo-rollouts deployment/argo-rollouts --tail=50

安装完成后，集群中将注册以下关键的自定义资源定义（CRD）：

3.5 Argo Rollouts kubectl 插件安装

Argo Rollouts kubectl 插件提供了丰富的命令来管理 Rollout 资源，包括查看发布进度、手动 promote、回滚等操作。安装该插件可以极大提升操作效率。

3.5.1 安装插件

根据你的操作系统选择对应的安装方式：

curl -LO https://github.com/argoproj/argo-rollouts/releases/latest/download/kubectl-argo-rollouts-linux-amd64
chmod +x kubectl-argo-rollouts-linux-amd64
sudo mv kubectl-argo-rollouts-linux-amd64 /usr/local/bin/kubectl-argo-rollouts

brew install argoproj/tap/kubectl-argo-rollouts

curl -LO https://github.com/argoproj/argo-rollouts/releases/latest/download/kubectl-argo-rollouts-linux-amd64
chmod +x kubectl-argo-rollouts-linux-amd64
sudo mv kubectl-argo-rollouts-linux-amd64 /usr/local/bin/kubectl-argo-rollouts

3.5.2 验证插件安装

# 验证插件是否可用
kubectl argo rollouts version

# 查看插件帮助信息
kubectl argo rollouts --help

3.5.3 启用插件自动补全（可选）

# Bash 自动补全
source <(kubectl argo rollouts completion bash)
echo "source <(kubectl argo rollouts completion bash)" >> ~/.bashrc

# Zsh 自动补全
source <(kubectl argo rollouts completion zsh)
echo "source <(kubectl argo rollouts completion zsh)" >> ~/.zshrc

3.6 环境验证清单

完成以上所有步骤后，请使用以下清单逐一验证你的实验环境是否准备就绪：