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