3. 多集群环境搭建：Kubernetes集群规划、kubeconfig配置、Context切换、集群命名规范

在实施基于回滚策略的多集群变更门禁之前，首先需要搭建一套标准化的多集群环境。本章将围绕集群规划、kubeconfig 配置、Context 切换以及命名规范四个核心维度展开，确保后续的 Helm 迁移操作能够在清晰、可控的基础设施上执行。

3.1 集群规划与角色定义

多集群环境通常按功能角色划分为三类：管理集群、工作集群和灾备集群。每一类集群承担不同的职责，在变更门禁流程中扮演特定角色。

3.2 集群命名规范

统一的命名规范是多集群运维的基础。命名应包含环境标识、地域/可用区、集群序号三个维度，确保从名称即可快速识别集群角色与位置。

# 命名格式：{env}-{region}-{sequence}
# 示例：
prod-cn-north-01      # 生产环境，华北，第1个集群
prod-cn-east-02       # 生产环境，华东，第2个集群
staging-cn-north-01   # 预发环境，华北，第1个集群
test-cn-south-01      # 测试环境，华南，第1个集群
dr-cn-north-01        # 灾备环境，华北，第1个集群
mgmt-global-01        # 管理集群，全局，第1个集群

3.3 kubeconfig 配置与 Context 管理

kubeconfig 文件是多集群访问的核心凭证。每个集群对应一个 Context，Context 由 集群地址、用户凭证和默认命名空间三要素组成。以下是一个标准的多集群 kubeconfig 配置示例：

apiVersion: v1
kind: Config
current-context: prod-cn-north-01
clusters:
- cluster:
    server: https://api.prod-cn-north-01.example.com:6443
    certificate-authority-data: <base64-ca-cert>
  name: prod-cn-north-01
- cluster:
    server: https://api.prod-cn-east-02.example.com:6443
    certificate-authority-data: <base64-ca-cert>
  name: prod-cn-east-02
- cluster:
    server: https://api.staging-cn-north-01.example.com:6443
    certificate-authority-data: <base64-ca-cert>
  name: staging-cn-north-01
users:
- name: ops-user-prod
  user:
    client-certificate-data: <base64-client-cert>
    client-key-data: <base64-client-key>
- name: ops-user-staging
  user:
    : <bearer->
contexts:
- context:
    cluster: prod-cn-north-01
    user: ops-user-prod
    namespace: helm-migration
  name: prod-cn-north-01
- context:
    cluster: prod-cn-east-02
    user: ops-user-prod
    namespace: helm-migration
  name: prod-cn-east-02
- context:
    cluster: staging-cn-north-01
    user: ops-user-staging
    namespace: helm-migration
  name: staging-cn-north-01

3.4 Context 切换与验证

日常运维中，频繁切换 Context 是常见操作。推荐使用 kubectx 工具或原生 kubectl config use-context 命令。以下为切换与验证的标准流程：

1. 查看所有 Context：kubectl config get-contexts
2. 切换 Context：kubectl config use-context prod-cn-north-01
3. 验证当前 Context：kubectl config current-context
4. 测试连通性：kubectl cluster-info
5. 确认命名空间：kubectl get ns helm-migration

#!/bin/bash
# validate-contexts.sh
CONTEXTS=$(kubectl config get-contexts -o name)
for ctx in $CONTEXTS; do
  echo "验证 Context: $ctx"
  kubectl --context="$ctx" cluster-info --request-timeout=5s 2>/dev/null
  if [ $? -eq 0 ]; then
    echo "✅ $ctx 连接正常"
  else
    echo "❌ $ctx 连接失败"
  fi
done

3.5 多集群访问架构图

下图展示了管理集群如何通过统一的 kubeconfig 文件访问多个工作集群，以及 Context 切换在其中的作用。

3.6 多集群环境初始化清单

完成集群规划与 kubeconfig 配置后，建议按照以下清单逐项确认，确保环境就绪：