如何管理和切换多个 Kubernetes kubeconfig 文件

一、管理多个kubeconfig 文件

在开发和运维过程中，管理多个 Kubernetes 集群配置文件（kubeconfig）可能会变得复杂。本文将介绍一种简化的方法，通过合并多个 kubeconfig 文件并轻松切换上下文。

前置准备

1. 安装必要的软件：

   • 确保已安装 kubectl 命令行工具。
   • 使用 Bash shell。

2. 下载 kubeconfig 文件：

   • 将所有 kubeconfig 文件下载到一个文件夹中，例如 ~/Desktop/k8s/。

   • 确保文件命名符合以下规则：

     • 前缀为 kubeconfig-。
     • 后缀标识各个 Kubernetes 环境。
     • 扩展名为 .yaml。

     示例文件名：

     • kubeconfig-kv-live-sga-c1.yaml
     • kubeconfig-kv-live-sga-c2.yaml
     • kubeconfig-kv-qa-sgb-drill.yaml
     • 等等。

3. 设置文件权限：

   • 确保脚本和 kubeconfig 文件具有适当的读取和执行权限：

     chmod +x /path/to/your/script.sh
     chmod 644 ~/Desktop/k8s/*.yaml
     

脚本：合并和管理 kubeconfig 文件

以下是简化后的脚本，能够合并多个 kubeconfig 文件并重命名上下文，以便于切换：

#!/bin/bash

# 设置 KUBECONFIG 环境变量
export KUBECONFIG=$(ls ~/Desktop/k8s/kubeconfig-*.yaml | tr '\n' ':' | sed 's/:$//')

# 合并 kubeconfig 文件
kubectl config view --merge --flatten > ~/Desktop/k8s/merged-kubeconfig.yaml

# 设置新的 KUBECONFIG 环境变量
export KUBECONFIG=~/Desktop/k8s/merged-kubeconfig.yaml

# 获取所有上下文
contexts=$(kubectl config get-contexts -o name)

# 重命名上下文
for context in $contexts; do
  for file in ~/Desktop/k8s/kubeconfig-*.yaml; do
    if grep -q $context $file; then
      suffix=$(basename $file | sed 's/kubeconfig-//;s/.yaml//')
      kubectl config rename-context $context $suffix
    fi
  done
done

# 列出所有上下文
kubectl config get-contexts

# 提示用户选择上下文
echo "请输入要使用的上下文名称："
read context_name

# 切换到选择的上下文
kubectl config use-context $context_name

# 显示当前上下文
kubectl config current-context

运行脚本

1. 将上述脚本保存为 manage-kubeconfig.sh。
2. 确保脚本具有执行权限：

   chmod +x /path/to/manage-kubeconfig.sh
   

3. 运行脚本：

   /path/to/manage-kubeconfig.sh
   

验证结果

运行脚本后，验证合并和上下文切换是否成功：

kubectl config get-contexts
kubectl config current-context

二、如果不需要根据文件名命名 context（简化脚本）

如果你不需要根据文件名命名上下文，可以使用以下更简化的脚本：

#!/bin/bash

# 设置 KUBECONFIG 环境变量
export KUBECONFIG=kubeconfig-dev.yaml:kubeconfig-staging.yaml:kubeconfig-prod.yaml:kubeconfig-test.yaml:kubeconfig-qa.yaml

# 合并 kubeconfig 文件
kubectl config view --merge --flatten > merged-kubeconfig.yaml

# 设置新的 KUBECONFIG 环境变量
export KUBECONFIG=merged-kubeconfig.yaml

# 列出所有上下文
kubectl config get-contexts

# 提示用户选择上下文
echo "请输入要使用的上下文名称："
read context_name

# 切换到选择的上下文
kubectl config use-context $context_name

# 显示当前上下文
kubectl config current-context

三、管理多个上下文的插件：使用 kubectx 工具

kubectx 是一个开源工具，可以更方便地管理和切换 Kubernetes 上下文。安装 kubectx 后，你可以通过简单的命令切换上下文：

kubectx dev-context
kubectx staging-context

安装 kubectx：

• 使用 Homebrew 安装（适用于 macOS 和 Linux）：

  brew install kubectx
  

• 或者从 GitHub 下载并安装：

  git clone https://github.com/ahmetb/kubectx.git
  cd kubectx
  sudo install kubectx /usr/local/bin
  

使用 kubectx 切换上下文：

kubectx dev-context
kubectx prod-context