2. 环境准备：Kubernetes集群搭建要求、Velero CLI与Helm安装、MinIO对象存储部署

本章聚焦于搭建一套可用于生产级蓝绿发布与灾备演练的完整实验环境。我们将依次完成Kubernetes集群的规格选型与配置、Velero命令行工具与Helm Chart的安装，以及MinIO对象存储的部署。这套环境将作为后续所有回滚策略与灾备流程的底层基础设施。

2.1 Kubernetes集群搭建要求

Velero对Kubernetes集群的版本与存储后端有明确依赖。以下表格列出了推荐的生产级配置与最低实验配置，请根据实际资源选择。

2.2 Velero CLI与Helm安装

Velero提供两种安装方式：CLI二进制（用于日常管理）和 Helm Chart（用于声明式部署与版本管理）。建议两者都安装，CLI用于快速操作，Helm用于生产级持续部署。

2.2.1 安装Velero CLI

以下步骤适用于Linux/macOS环境。Windows用户请使用WSL2或下载对应exe文件。

# 下载最新稳定版Velero CLI
wget https://github.com/vmware-tanzu/velero/releases/download/v1.14.0/velero-v1.14.0-linux-amd64.tar.gz

# 解压并移动到系统路径
tar -xzf velero-v1.14.0-linux-amd64.tar.gz
sudo mv velero-v1.14.0-linux-amd64/velero /usr/local/bin/

# 验证安装
velero version --client-only

Client:
    Version: v1.14.0
    Git commit: xxxxxxx

2.2.2 使用Helm部署Velero服务端

Helm方式更适合GitOps流程。首先添加Velero官方Helm仓库，然后创建命名空间并部署。

# 添加Helm仓库
helm repo add vmware-tanzu https://vmware-tanzu.github.io/helm-charts
helm repo update

# 创建命名空间
kubectl create namespace velero-system

# 使用Helm安装Velero（需提前准备好MinIO凭证）
helm install velero vmware-tanzu/velero \
  --namespace velero-system \
  --set configuration.provider=aws \
  --set configuration.backupStorageLocation.name=default \
  --set configuration.backupStorageLocation.bucket=velero-backups \
  --set configuration.backupStorageLocation.config.region=minio \
  --set configuration.backupStorageLocation.config.s3Url=http://minio.minio-system.svc:9000 \
  --set configuration.backupStorageLocation.config.publicUrl=http://minio.example.com:9000 \
  --set configuration.volumeSnapshotLocation.name=default \
  --set configuration.volumeSnapshotLocation.config.region=minio \
  --set initContainers[0].name=velero-plugin-for-aws \
  --set initContainers[0].image=velero/velero-plugin-for-aws:v1.9.0 \
  --set initContainers[0].volumeMounts[0].mountPath=/target \
  --set initContainers[0].volumeMounts[0].name=plugins \
  --set credentials.useSecret=true \
  --set credentials.secretContents.cloud="[default]\naws_access_key_id=minioadmin\naws_secret_access_key=minioadmin"

2.3 MinIO对象存储部署

MinIO作为S3兼容的对象存储，是Velero备份与快照的核心后端。我们使用Helm Chart在Kubernetes集群内部署一个高可用的MinIO实例。

2.3.1 部署架构图

下图展示了MinIO在集群中的部署拓扑，以及Velero与MinIO之间的数据流关系。

2.3.2 使用Helm部署MinIO

我们采用Bitnami的MinIO Helm Chart，它提供了生产级的高可用配置。

# 添加Bitnami仓库
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

# 创建命名空间
kubectl create namespace minio-system

# 部署MinIO（单节点模式，适合实验环境）
helm install minio bitnami/minio \
  --namespace minio-system \
  --set mode=standalone \
  --set auth.rootUser=minioadmin \
  --set auth.rootPassword=minioadmin \
  --set persistence.size=20Gi \
  --set service.type=ClusterIP \
  --set service.ports.api=9000 \
  --set service.ports.console=9001

2.3.3 验证MinIO与Velero连通性

部署完成后，执行以下步骤确认端到端连通性。

1. 检查MinIO Pod状态：

kubectl get pods -n minio-system -l app.kubernetes.io/name=minio

2. 创建Velero备份存储位置（BSL）测试：

velero backup-location create default \
  --provider aws \
  --bucket velero-backups \
  --config region=minio,s3Url=http://minio.minio-system.svc:9000 \
  --access-mode=ReadWrite

3. 执行一次测试备份：

velero backup create test-backup --include-namespaces default --ttl 24h

4. 查看备份状态：

velero backup get

如果备份状态显示 Completed，则说明环境准备成功。若出现 Failed，请检查MinIO的 s3Url 是否可达，以及凭证是否正确。

2.4 环境验证清单

在进入下一章之前，请逐项确认以下环境就绪状态。