kubeconfig多配置文件切换工具推荐

前言

随着 Kubernetes 越来越流行，不管大公司还是小公司都往 Kubernetes 迁移，每个公司最少有两套集群（测试和生产），但是多个集群就有多个 Kubeconfig 用户授权文件。虽然官方文档中有介绍多个 Kubeconfig 文件合并成一个 Kubeconfig，但是对于一些新手来说，看得不是很明白。如果需要从本地计算机连接访问 Kubernetes 集群，需要下载 kubectl 和获取集群访问凭证，但如果有多个k8s集群通过2个神器就可以做到轻松切换不同的kubeconfig环境，这里推荐kubecm和k8slens

更新历史

2022年05月18日 - 初稿

阅读原文 - https://wsgzao.github.io/post/kubeconfig/

---

安装kubectl

https://kubernetes.io/docs/tasks/tools/

https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/

curl -LO "https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl


# If you do not have root access on the target system, you can still install kubectl to the ~/.local/bin directory:
chmod +x kubectl
mkdir -p ~/.local/bin
mv ./kubectl ~/.local/bin/kubectl
# and then append (or prepend) ~/.local/bin to $PATH

kubeconfig

https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/

Kubeconfig 用途

kubectl 命令行工具通过 kubeconfig 文件的配置来选择集群以及集群API Server通信的所有信息。kubeconfig 文件用来保存关于集群用户、命名空间和身份验证机制的信息。默认情况下 kubectl 读取 $HOME/.kube/config 文件，也可以通过设置环境变量 KUBECONFIG 或者 –kubeconfig 指定其他的配置文件。

Kubeconfig 文件结构

kubeconfig 文件主要由下面几部分构成：

• 集群参数
• 用户参数
• 上下文参数
• 当前上下文

apiVersion: v1
kind: Config
preferences: {}

clusters: # 集群参数
- cluster:
  name: {cluster-name}

users: # 用户参数
- name: {user-name}

contexts: # 上下文参数
- context:
    cluster: {cluster-name}
    user: {user-name}
  name: kubernetes # 集群上下文名称
current-context: kubernetes # 当前上下文

kubecm

https://github.com/sunny0826/kubecm
https://kubecm.cloud/#/zh-cn/install

通过 kubecm 工具合并多个 kubeconfig 文件

kubecm 安装

# install kubecm
# https://github.com/sunny0826/kubecm/releases
export VERSION="0.16.4"

# linux x86_64
curl -Lo kubecm.tar.gz https://github.com/sunny0826/kubecm/releases/download/v${VERSION}/kubecm_${VERSION}_Linux_x86_64.tar.gz
# macos
curl -Lo kubecm.tar.gz https://github.com/sunny0826/kubecm/releases/download/v${VERSION}/kubecm_${VERSION}_Darwin_x86_64.tar.gz
brew install kubecm

# windows
curl -Lo kubecm.tar.gz https://github.com/sunny0826/kubecm/releases/download/v${VERSION}/kubecm_${VERSION}_Windows_x86_64.tar.gz

# linux & macos
tar -zxvf kubecm.tar.gz kubecm
cd kubecm
sudo mv kubecm /usr/local/bin/

# merge and generate kubeconfig
# https://kubecm.cloud/#/en-us/cli/kubecm_add

# 把需要合并的 Kubeconfig 文件放到 kubeconfig 目录下，执行命令后会在当前路径下产生一个新的 kubeconfig 文件
kubecm merge -f kubeconfig

# replace $HOME/.kube/config
kubecm merge -f kubeconfig -c

# switch k8s cluster
kubecm switch

# list kubeconfig
kubecm list


        Manage your kubeconfig more easily.


██   ██ ██    ██ ██████  ███████  ██████ ███    ███
██  ██  ██    ██ ██   ██ ██      ██      ████  ████
█████   ██    ██ ██████  █████   ██      ██ ████ ██
██  ██  ██    ██ ██   ██ ██      ██      ██  ██  ██
██   ██  ██████  ██████  ███████  ██████ ██      ██

 Tips  Find more information at: https://kubecm.cloud

Usage:
  kubecm [command]

Available Commands:
  add         Add KubeConfig to $HOME/.kube/config
  alias       Generate alias for all contexts
  clear       Clear lapsed context, cluster and user
  completion  Generates bash/zsh completion scripts
  create      Create new KubeConfig(experiment)
  delete      Delete the specified context from the kubeconfig
  help        Help about any command
  list        List KubeConfig
  merge       Merge the KubeConfig files in the specified directory
  namespace   Switch or change namespace interactively
  rename      Rename the contexts of kubeconfig
  switch      Switch Kube Context interactively
  version     Print version info

Flags:
      --config string   path of kubeconfig (default "$HOME/.kube/config")
  -h, --help            help for kubecm

Use "kubecm [command] --help" for more information about a command.



# 查看 $HOME/.kube/config 中所有的 context
kubecm

# 添加 example.yaml 到 $HOME/.kube/config.yaml，该方式不会覆盖源 kubeconfig，只会在当前目录中生成一个 config.yaml 文件
kubecm add -f example.yaml

# 功能同上，但是会将 example.yaml 中的 context 命名为 test
kubecm add -f example.yaml -n test

# 添加 -c 会覆盖源 kubeconfig
kubecm add -f example.yaml -c

# 交互式删除
kubecm delete

# 删除指定 context
kubecm delete my-context

# 合并 test 目录中的 kubeconfig,该方式不会覆盖源 kubeconfig，只会在当前目录中生成一个 config.yaml 文件
kubecm merge -f test 

# 添加 -c 会覆盖源 kubeconfig
kubecm merge -f test -c

# 交互式重命名
kubecm rename

# 将 dev 重命名为 test
kubecm rename -o dev -n test

# 重命名 current-context 为 dev
kubecm rename -n dev -c

# 交互式切换 namespace
kubecm namespace

# 或者
kubecm ns

# 切换默认 namespace 为 kube-system
kubecm ns kube-system

k8slens

GUI界面切换kubeconfig就更强大了，自己探索吧

https://k8slens.dev/
https://docs.k8slens.dev/main/

Lens - The Kubernetes IDE

Lens - The Kubernetes IDE (“Lens IDE”) is a distribution of the OpenLens repository with Team Lens specific customizations released under a traditional EULA.

Lens IDE provides the full situational awareness for everything that runs in Kubernetes. It’s lowering the barrier of entry for people just getting started and radically improving productivity for people with more experience.

Lens IDE a standalone application for MacOS, Windows and Linux operating systems. You can download it free of charge for Windows, MacOS, and Linux from Lens IDE website.