WSL中运行kubectl切换AKS context提示名称不存在报错如何解决

问题根因 #

WSL环境与Windows环境的kubeconfig配置默认隔离，同时如果WSL内调用的是Windows版本的kubectl，会出现配置读写路径不一致的问题，导致az写入的配置kubectl读不到。

修复步骤 #

• 首先排查kubectl运行环境：
  执行which kubectl，如果输出路径以/mnt/c/开头，说明当前使用的是Windows版kubectl，它默认读取Windows用户目录下的.kube\config，而WSL内的az命令默认写入WSL家目录下的~/.kube/config，两者路径不互通。
  两种修复方案二选一：
  1. 安装WSL原生kubectl：

  sudo apt update && sudo apt install -y kubectl
  

  安装完成后重新执行az aks get-credentials --resource-group RivieraRG --name RivieraAksCls0即可正常生成配置。
  2. 指定az写入Windows的kubeconfig路径：
  替换下方命令中的<Windows用户名>为你实际的Windows账号名，执行即可：

  az aks get-credentials --resource-group RivieraRG --name RivieraAksCls0 --file /mnt/c/Users/<Windows用户名>/.kube/config
  

• 如果输出路径是WSL本地路径（比如/usr/bin/kubectl），说明是context命名不符问题：
  Azure CLI默认生成的AKS context名称格式为[订阅ID]_[集群名]，而非单纯的集群名，先执行以下命令查看所有已存在的context：

  kubectl config get-contexts
  

  找到对应RivieraAksCls0的context条目，复制完整名称直接切换即可，也可以用以下命令重命名为你需要的短名称：

  # 替换<完整context名称>为你查到的实际名称
  kubectl config rename-context <完整context名称> RivieraAksCls0
  

验证 #

执行kubectl config use-context RivieraAksCls0无报错，再执行kubectl get nodes能正常返回节点信息即为修复成功。

内容的提问来源于stack exchange，提问作者Venkatesh Gotimukul