k8s学习：kubeconfig文件详解

1.什么是kubeconfig文件       

         用于配置集群访问的文件称为kubeconfig文件，这是引用配置文件的常用方法，但并不是说有一个名为kubeconfig的文件。

         使用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:xxxxx
  server:url
 name:clusterName

多个集群的话直接在后面添加-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条目。

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