k8s学习: kubeconfig文件详解

1.什么是kubeconfig文件

• 用于配置集群访问的文件称为kubeconfig文件，这是引用配置文件的常用方法，.但并不是说有一个名为ubeconfi的文件。
• 用于配置集群访问信息的文件叫作 kubeconfig 文件，在开启了 TLS 的集群中，每次与集群交互时都需要身份认证，生产环境一般使用证书进行认证，其认证所需要的信息会放在 kubeconfig 文件中。此外，K8s 的组件都可以使用 kubeconfig 连接 apiserver，client-go 、operator、helm 等其他组件也使用 kubeconfig 访问 apiserver。
• 使用kubeconfig文件来组织有关集群、用户、命名空间和身份认证机制的信息。kubectl 命令行根据使用kubeconfig文件来查找选择集群所需的信息，并与集群的API服务进行通信。
• 默认情况下，kubectl 在 $HOME/.kube 目录下查找名为config的文件，可以通过设置KUBECONFIG环境变量或设置--kubeconfig参数来指定其他Kubeconfig文件。
• kubectl是操作k8s的一个客户端工具，只要为kubectl提供链接apiserver的配置(kubeconfig)，kubectl可以在任何地方操作该集群。

kubeconfig的一个示例如下：该示例为2个集群

apiVersion: v1
clusters:
- cluster:
   certificate-authority-data: xxx
   server: https://xxx:6443
  name: cluster1
- cluster:
   certificate-authority-data: xxx
   server: https://xxx:6443
  name: cluster2
contexts:
- context:
   cluster: cluster1
   user: kubelet
  name: cluster1-context
- context:
   cluster: cluster2
   user: kubelet
  name: cluster2-context
current-context: cluster1-context
kind: Config
preferences: {}
users:
- name: kubelet
  user:
   client-certificate-data: xxx
   client-key-data: xxx

apiVersion 和 kind 标识客户端解析器的版本和模式，不应手动编辑。preferences 指定当前可选（和当前未使用）的 kubectl 首选项

2.kubeconfig文件详解

2.1cluseter

cluster中包含k8s集群的端点数据，包括集群的证书颁发机构以及完整的URL。可以使用Kubectl config set-cluster添加或修改cluster条目。

cluster:
-cluster:
  certificate-authority-data:xxx
  server:url
 name:clusterName

可以使用 kubectl config set-cluster 添加或修改 cluster 条目，多个集群的话直接在后面添加-cluster部分即可

2.2contexts

•  contexts定义了一个命名的cluster、user、namespace元组，用于使用提供的认证信息和命名空间将请求发送到指定的集群。
• 三个都是可选的，仅使用 cluster、user、namespace 之一指定上下文，或指定none。
• 未指定的值或在加载的kubeconfig中没有相应条目的命名值将被替换为默认值。

contexts:
- context:
    cluster:xxx
    user":xxx
  name:xxx

可以使用kubectl config set-context添加或修改上下文条目。
 

2.3current-context

current-context 是作为cluster、user、namespace元组的 key，当 kubectl 从该文件中加载配置的时候会被默认使用。

可以在 kubectl 命令行里覆盖这些值，通过分别传入--context=CONTEXT、 --cluster=CLUSTER、--user=USER 和 --namespace=NAMESPACE。

kubectl get node --kubeconfig=./kubeconfig --context=cluster2-context

在第一部分的示例中，若不指定 context 则默认使用 cluster1-context。可以使用kubectl config use-context 更改 current-context。

2.4users

users 定义用于向 k8s 集群进行身份验证的客户端凭据。可用凭证有 client-certificate、client-key、token 和 username/password。username/password 和 token 是二者只能选择一个，但 client-certificate和 client-key 可以分别与它们组合。

可以使用kubectl config set-credentials添加或者修改 user 条目。

2.5、kubectl 生成 kubeconfig 的示例

kubectl 可以快速生成 kubeconfig，以下是一个示例：

若使用手写 kubeconfig 的方式，推荐一个工具 kubeval，可以校验 kubernetes yaml 或 json 格式的配置文件是否正确。

3.使用kubeconfig文件配置kubectl跨集群认证

kubectl 作为操作 k8s 的一个客户端工具，只要为 kubectl 提供连接 apiserver 的配置(kubeconfig)，kubectl 可以在任何地方操作该集群。若要使用多个集群， kubeconfig 文件中配置多个集群，kubectl 可以在多个集群间切换。如第一部分的示例文件中就设置了2个集群。

kubectl加载配置文件的顺序：

1)  kubectl 默认连接本机的 8080 端口
2)  从 $HOME/.kube 目录下查找文件名为 config 的文件
3）通过设置环境变量 KUBECONFIG 或者通过设置去指定其它 kubeconfig 文件

#设置KUBECONFIG的环境变量
export KUBECONFIG=/etc/kubernetes/kubeconfig/kubelet.kubeconfig

#指定kubeconfig文件
kubectl get node --kubeconfig=/etc/kubernetes/kubeconfig/kubelet.kubeconfig

#使用不同的 context在多个集群之间切换
kubectl get node --kubeconfig=./kubeconfig --context=cluster1-context