kubectl config 管理多集群

最新推荐文章于 2025-06-09 09:07:05 发布

lzyjzb

最新推荐文章于 2025-06-09 09:07:05 发布

阅读量935

点赞数

CC 4.0 BY-SA版权

文章标签：云计算

原文链接：http://erikjiang.github.io/2019/05/02/KubeConfMultiCluster/

本文介绍如何使用kubectlconfig优雅地管理多个Kubernetes集群环境，包括本地DockerDesktop、测试、开发和生产环境。通过配置KUBECONFIG环境变量，实现集群间的无缝切换。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

我们日常开发中会不可避免的使用到多个 Kubernetes 集群，一般比较传统的做法，我们会使用 ssh 远程到集群节点主机上，然后再进行 kubectl 相关命令的操作，这样做也没什么问题，但是当集群数增多以后，就会发现切换集群的操作略显麻烦，且无法管理，于是就有了一个需求，怎样能够更加优雅的组织管理这些不同的集群接入场景？

在了解 kubectl config 提供的功能时发现，它本身就能够清晰的组织管理不同集群的上下文，且能够无缝切换集群环境。

在这篇文章中，我将介绍如何使用 kubectl config 组织管理日常工作中的四个不同的集群环境。

我们先列出需要组织管理的集群列表：

docker for desktop: 本地 Docker Desktop 提供的 k8s 单节点环境
work-test: k8s 多节点测试环境
work-dev: k8s 多节点开发环境
work-prod: k8s 多节点生产环境
首先，当你本地成功安装了 kubectl，会存在一个 ~/.kube/ 的目录，该目录用于存放所有集群的配置文件；

由于我本地安装了 Docker Desktop Kubernetes 环境，
所以现在可以通过 vim ~/.kube/config 查看一下本地 k8s 单节点配置信息：

apiVersion: v1
clusters:

cluster:
insecure-skip-tls-verify: true
server: https://localhost:6443
name: docker-for-desktop-cluster
contexts:
context:
cluster: docker-for-desktop-cluster
user: docker-for-desktop
name: docker-for-desktop
current-context: docker-for-desktop
kind: Config
preferences: {}
users:
name: docker-for-desktop
user:
client-certificate-data: …
client-key-data: …
从该配置能够看出，一个完整的集群配置至少要包含三个要素：

clusters 集群
contexts 上下文
users 用户
接下来，我们需要分别将 work-test、work-dev、work-prod 三个环境中的配置添加到本地；

通常 Kubernetes 集群在安装时会生成一个管理配置文件，该配置文件位于每个集群的主节点上，具体目录：

/etc/kubernetes/admin.conf
了解到了这一点，我们就可以使用 scp 命令将各个集群主节点中的配置拷贝到本地 .kube 目录中了：

copy the Kubernetes admin config for work test

scp root@SERV_MASTER_TEST:/etc/kubernetes/admin.conf ~/.kube/config-work-test

copy the Kubernetes admin config for work dev

scp root@SERV_MASTER_DEV:/etc/kubernetes/admin.conf ~/.kube/config-work-dev

copy the Kubernetes admin config for work prod

scp root@SERV_MASTER_PROD:/etc/kubernetes/admin.conf ~/.kube/config-work-prod
将如上命令中 SERV_MASTER_TEST、SERV_MASTER_DEV、SERV_MASTER_PROD 分别替换为对应集群主节点 IP;

注：配置文件中包含敏感信息，请妥善保管！

现在，我们已经完成了配置的拷贝，但是为了便于管理，我们需要对这些配置中的命名进行修改规范；

我们要修改这三个配置文件，并着重关注三大要素：集群、上下文、用户；

以 work-dev 为例：

集群 clusters

修改集群名称

cluster:
server: https://xx.xx.xx.xx:6443
name: work-dev-cluster

用户 users

修改用户名称

users:

name: work-dev-admin

上下文 contexts

更新上下文名称，关联对应用户及集群

contexts:

context:
cluster: work-dev-cluster
user: work-dev-admin
name: work-dev
三个配置文件都修改完成后，我们需要将这些配置全部加载到 kube config 中；

具体这里将会使用到名为 KUBECONFIG 的环境变量，该环境变量用于保存以冒号分隔的配置文件路径列表；

kubectl config 将通过 KUBECONFIG 环境变量加载并组合所有的集群配置信息；

我们可以将 KUBECONFIG 环境变量配置添加到 .bash_profile 或 .zshrc 当中：

export KUBECONFIG= $H O M E / . k u b e / c o n f i g - w o r k - t e s t :$ HOME/.kube/config-work-dev: $H O M E / . k u b e / c o n f i g - w o r k - p r o d :$ HOME/.kube/config
设置完后，执行命令以使配置生效：

$ source ~/.bash_profile

或者

$ source ~/.zshrc
也可以打开一个新终端，验证环境变量是否生效：

$ echo $KUBECONFIG
至此，kubectl config 集群配置已经完成;

让我们验证一下！

获取所有的集群上下文列表：
$ kubectl config get-contexts
CURRENT NAME CLUSTER AUTHINFO NAMESPACE

    docker-for-desktop   docker-for-desktop-cluster   docker-for-desktop
    work-test            work-test-cluster            work-test-admin
    work-dev             work-dev-cluster             work-dev-admin
    work-prod            work-prod-cluster            work-prod-admin

获取展示当前的上下文：
$ kubectl config current-context
docker-for-desktop
将当前上下文设置为开发环境：
$ kubectl config use-context work-dev
Switched to context “work-dev”.
此时，即可使用 kubectl get nodes 等命令验证一下是否已切换到对应集群环境。
更多的 kubectl config 命令见帮助信息：
current-context 显示 current_context
delete-cluster 删除 kubeconfig 文件中指定的集群
delete-context 删除 kubeconfig 文件中指定的 context
get-clusters 显示 kubeconfig 文件中定义的集群
get-contexts 描述一个或多个 contexts
rename-context Renames a context from the kubeconfig file.
set 设置 kubeconfig 文件中的一个单个值
set-cluster 设置 kubeconfig 文件中的一个集群条目
set-context 设置 kubeconfig 文件中的一个 context 条目
set-credentials 设置 kubeconfig 文件中的一个用户条目
unset 取消设置 kubeconfig 文件中的一个单个值
use-context 设置 kubeconfig 文件中的当前上下文
view 显示合并的 kubeconfig 配置或一个指定的 kubeconfig 文件