如何使用 kubectl 配置多集群上下文切换 kubeconfig

管理多个 Kubernetes 集群时，最稳妥的方式是通过环境变量合并 kubeconfig 文件或使用 kubectl config 命令切换上下文，这样既能隔离配置又能快速切换。

先说结论：适合日常开发运维多集群场景，核心是理解 context 与 cluster 的映射关系

适合：需要同时访问测试、生产等多个集群的开发或运维人员
先准备：各集群的 kubeconfig 文件，确保权限正确
验收：通过 kubectl config current-context 确认当前指向

命令速用版

# 合并多个 kubeconfig 文件
export KUBECONFIG=$HOME/.kube/config:$HOME/.kube/config-test

# 查看所有上下文
kubectl config get-contexts

# 切换上下文
kubectl config use-context <context-name>

为什么会这样

kubectl 本身不存储集群信息，它依赖 kubeconfig 文件来知道如何连接 API Server。一个 kubeconfig 文件可以包含多个集群、多个用户和多个上下文。上下文（context）是集群和用户的组合，切换上下文本质上就是告诉 kubectl 接下来用哪套证书连接哪个地址。

分步处理

1. 获取各集群的 kubeconfig 文件，通常命名为 config-prod、config-dev 等，存放在安全目录。

2. 使用环境变量临时合并配置，避免直接修改默认文件导致混乱：

export KUBECONFIG=~/.kube/config:~/.kube/config-prod

3. 查看可用上下文列表，确认名称无误：

kubectl config get-contexts

4. 切换到目标上下文：

kubectl config use-context prod-cluster

怎么验证是否生效

执行以下命令查看当前集群信息，确认连接的是预期集群：

kubectl cluster-info
kubectl config current-context

如果能正常列出命名空间或节点，且 cluster-info 显示的地址与目标一致，即表示切换成功。

常见坑

1. 直接覆盖默认文件：不要随意将新配置 cat 到 ~/.kube/config，容易丢失原有上下文，建议先用环境变量测试。

2. 上下文名称混淆：不同集群可能有相同的 context 名称，切换前务必用 get-contexts 核对。

3. 权限问题：kubeconfig 文件包含敏感凭证，权限应设置为 600，避免泄露。

参考来源

Kubernetes 官方文档 - Organize Cluster Access Using kubeconfig Files (https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/)