经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置：技术经验 » 数据库/运维 » Kubernetes » 查看文章
k8s中kubeconfig的配置以及使用详解
来源：jb51　　时间：2022/1/18 17:31:50　　对本文有异议

1、概述

kubeconfig文件保存了k8s集群的集群、用户、命名空间、认证的信息。kubectl命令使用kubeconfig文件来获取集群的信息，然后和API server进行通讯。

注意：用于配置对集群的访问的文件称为kubecconfig文件。也就是说，kubeconfig文件中包含的内容是集群的配置。但是，并不是必须有个文件名字叫kubeconfig

默认情况下，kubectl命令从$HOME/.kube目录下查找一个名字叫做config的文件。可以通过KUBECONFIG环境变量或者--kubeconfig参数来指定其他的kubeconfig文件。

kubeconfig中主要由如下部分组成：

  • clusters （集群）
  • users（用户）
  • context（上下文）

2、kubeconfig支持多集群、多用户、多认证

在实际的使用中的如下场景：

  • kubelet使用证书认证（kubelet和api server进行认证）
  • 用户使用token进行认证
  • 管理员为不同的用户提供不同的证书

都可以使用kubeconfig来组织起集群、用户、命名空间的信息。同样，也可以使用context在集群和命名空间之间进行切换。

3、Context的定义

在kubeconfig中，context中将访问一个集群的参数进行分组。访问这个context名称就是访问这个参数组。context就是一组信息的别名，举例来说，当在高德中使用家的地址，公司的地址就是一个别名，就能迅速的定位到具体的地址信息。

每个context都有3个参数：

  • cluster （集群）
  • namespace（命名空间）
  • user（用户）

默认情况下，kubectl命令从current context中来获取参数，然后与集群进行通讯。

4、查看kubeconfig的配置

如果有KUBECONFIG环境变量，看到的配置是合并的配置

  1. [root@nccztsjb-node-11 ~]# kubectl config view
  2. apiVersion: v1
  3. clusters:
  4. - cluster:
  5.     certificate-authority-data: DATA+OMITTED
  6.     server: https://k8s.apiserver.io:6443
  7.   name: cluster.local
  8. contexts:
  9. - context:
  10.     cluster: cluster.local
  11.     user: kubernetes-admin-cluster.local
  12.   name: kubernetes-admin-cluster.local@cluster.local
  13. current-context: kubernetes-admin-cluster.local@cluster.local
  14. kind: Config
  15. preferences: {}
  16. users:
  17. - name: kubernetes-admin-cluster.local
  18.   user:
  19.     client-certificate-data: REDACTED
  20.     client-key-data: REDACTED
  21. [root@nccztsjb-node-11 ~]#

通过kubectl config view得到的配置可能是来自一个kubeconfig文件，也可能是来自多个kubeconfig文件合并的结果。

5、kubeconfig设置

5.1、设置集群

（1）集群有CA认证，并且将证书的输入嵌入到配置文件中

  1. kubectl config --kubeconfig=config-demo set-cluster development --server=https://1.2.3.4 --embed-certs --certificate-authority=ca.crt

指定--kubeconfig参数后，所有的配置都会写到对应的文件中。如果不指定--kubeconfig参数那么就会将配置文件写到~/.kube/config这个文件中。

--certificate-authority后面是ca证书的路径，需要确保这个证书是存在的。

查看config-demo文件的内容

  1. [root@nccztsjb-node-11 config-exercise]# cat config-demo 
  2. apiVersion: v1
  3. clusters:
  4. - cluster:
  5.     certificate-authority-data: LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUM2VENDQWRHZ0F3SUJBZ0lCQURBTkJna3Foa2lHOXcwQkFRc0ZBREFWTVJNd0VRWURWUVFERXdwcmRXSmwKY201bGRHVnpNQ0FYRFRJeE1USXdNakE0TURjMU5sb1lEekl4TVRFeE1URXhNRGd3TnpVMldqQVZNUk13RVFZRApWUVFERXdwcmRXSmxjbTVsZEdWek1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBCnFaWkVNZDhORHpoek5hTE1ab2tCenlabVUzQWh6R1Z4OW15MzJxaTB3UzkzS3Jib0xMUWhSSUhCYnYzdzZCbCsKZlBYaUdSeCt4OVpKY2lta1BqdmJtQ0ZpKzEvQmsxZkFONlNBSi9ISjJoenQxcExZbW41NXVVclpqdmFCTXNUdAp5U3B4QUlOUWNNU1NJYUFyeHF1VDJ0QjYzWkMvTHloQVFWWG4xL2lYS3hLTmpidjVlS21BdlRRTlQrNlMxaFIxCkJNQXNjSFc0R1lhNXVBTFZBTmZrVlpGaG5GMmt2cVMyRzRDMXV4emZtOFpyUnREOExRUjFmTnk1VnpnVkJLQjMKT2RKQkExNnl4YXk5N2JjaEtqenpqTmxKMFBlVDBOdFZZWVRlZ3F1ZG5iRURRSEdObC91Ym5UcGtWWHpFUGRKNAo3a3FQREdWUzRXYi9DZXpVcm9IQ1hRSURBUUFCbzBJd1FEQU9CZ05WSFE4QkFmOEVCQU1DQXFRd0R3WURWUjBUCkFRSC9CQVV3QXdFQi96QWRCZ05WSFE0RUZnUVVmQldoK3hIdlVSdFdKdUVuUUlYTHRDUzh2MEl3RFFZSktvWkkKaHZjTkFRRUxCUUFEZ2dFQkFHeHNvSXJOZkJYRkp1RjZwYmtvSkh3eVdCSkp0Qzlud1VabWNCMmYzT0xTZTN4LwpQQU5oYm9LcHZ6ME5ocm5IQ2VnUk1rWGlmSmhKZW9VU25sYUhJaWpjVlFDZ09sTDVnT0EyeFZkRk01MlZCTk5jCnN1Qmp2MHJoQnZXMWxaYWVEUGJuaGp3dGY5elp2WG4vMUkvZ1RKSVRiNmFVdk55b1U3WHY2c3RmN1NjaExwU3kKZmVwRjNKRFc5TXRvem9yMHhoV0U3M0FrZHE1bnE4OFlSdEcxK3UwRTJXbDJ5U20yR0dzRUkvcU1HOXlvd0NsRgozSnhOQm45MEk3V0xKd0pETGZZMXYwWXdRNDR3QUJteGN4R01qVzNmOHAvL3pxSHNaaXJGdTR3QUlUK003Mmw3CkhDbXAwbm84VXpKMUdMUFcxNzF5TWNsdlJNM3h2SENtZHd0VktBMD0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=
  6.     server: https://1.2.3.4
  7.   name: development
  8. contexts: null
  9. current-context: ""
  10. kind: Config
  11. preferences: {}
  12. users: null
  13. [root@nccztsjb-node-11 config-exercise]#

已经设置好了集群

（2）集群没有证书的

  1. kubectl config --kubeconfig=config-demo set-cluster development --server=https://1.2.3.4

查看证书内容

  1. [root@nccztsjb-node-11 config-exercise]# kubectl config --kubeconfig=config-demo set-cluster development --server=https://1.2.3.4
  2. Cluster "development" set.
  3. [root@nccztsjb-node-11 config-exercise]# cat config-demo 
  4. apiVersion: v1
  5. clusters:
  6. - cluster:
  7.     server: https://1.2.3.4
  8.   name: development
  9. contexts: null
  10. current-context: ""
  11. kind: Config
  12. preferences: {}
  13. users: null
  14. [root@nccztsjb-node-11 config-exercise]

（3）集群有证书，但是证书验证的

  1. kubectl config --kubeconfig=config-demo set-cluster scratch --server=https://5.6.7.8 --insecure-skip-tls-verify

查看证书的内容

  1. [root@nccztsjb-node-11 config-exercise]# cat config-demo 
  2. apiVersion: v1
  3. clusters:
  4. - cluster:
  5.     certificate-authority-data: LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUM2VENDQWRHZ0F3SUJBZ0lCQURBTkJna3Foa2lHOXcwQkFRc0ZBREFWTVJNd0VRWURWUVFERXdwcmRXSmwKY201bGRHVnpNQ0FYRFRJeE1USXdNakE0TURjMU5sb1lEekl4TVRFeE1URXhNRGd3TnpVMldqQVZNUk13RVFZRApWUVFERXdwcmRXSmxjbTVsZEdWek1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBCnFaWkVNZDhORHpoek5hTE1ab2tCenlabVUzQWh6R1Z4OW15MzJxaTB3UzkzS3Jib0xMUWhSSUhCYnYzdzZCbCsKZlBYaUdSeCt4OVpKY2lta1BqdmJtQ0ZpKzEvQmsxZkFONlNBSi9ISjJoenQxcExZbW41NXVVclpqdmFCTXNUdAp5U3B4QUlOUWNNU1NJYUFyeHF1VDJ0QjYzWkMvTHloQVFWWG4xL2lYS3hLTmpidjVlS21BdlRRTlQrNlMxaFIxCkJNQXNjSFc0R1lhNXVBTFZBTmZrVlpGaG5GMmt2cVMyRzRDMXV4emZtOFpyUnREOExRUjFmTnk1VnpnVkJLQjMKT2RKQkExNnl4YXk5N2JjaEtqenpqTmxKMFBlVDBOdFZZWVRlZ3F1ZG5iRURRSEdObC91Ym5UcGtWWHpFUGRKNAo3a3FQREdWUzRXYi9DZXpVcm9IQ1hRSURBUUFCbzBJd1FEQU9CZ05WSFE4QkFmOEVCQU1DQXFRd0R3WURWUjBUCkFRSC9CQVV3QXdFQi96QWRCZ05WSFE0RUZnUVVmQldoK3hIdlVSdFdKdUVuUUlYTHRDUzh2MEl3RFFZSktvWkkKaHZjTkFRRUxCUUFEZ2dFQkFHeHNvSXJOZkJYRkp1RjZwYmtvSkh3eVdCSkp0Qzlud1VabWNCMmYzT0xTZTN4LwpQQU5oYm9LcHZ6ME5ocm5IQ2VnUk1rWGlmSmhKZW9VU25sYUhJaWpjVlFDZ09sTDVnT0EyeFZkRk01MlZCTk5jCnN1Qmp2MHJoQnZXMWxaYWVEUGJuaGp3dGY5elp2WG4vMUkvZ1RKSVRiNmFVdk55b1U3WHY2c3RmN1NjaExwU3kKZmVwRjNKRFc5TXRvem9yMHhoV0U3M0FrZHE1bnE4OFlSdEcxK3UwRTJXbDJ5U20yR0dzRUkvcU1HOXlvd0NsRgozSnhOQm45MEk3V0xKd0pETGZZMXYwWXdRNDR3QUJteGN4R01qVzNmOHAvL3pxSHNaaXJGdTR3QUlUK003Mmw3CkhDbXAwbm84VXpKMUdMUFcxNzF5TWNsdlJNM3h2SENtZHd0VktBMD0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=
  6.     server: https://1.2.3.4
  7.   name: development
  8. - cluster:
  9.     insecure-skip-tls-verify: true
  10.     server: https://5.6.7.8
  11.   name: scratch
  12. contexts: null
  13. current-context: ""
  14. kind: Config
  15. preferences: {}
  16. users: null
  17. [root@nccztsjb-node-11 config-exercise]#

(4)删除集群

  1. kubectl config --kubeconfig=config-demo unset clusters.development

5.2、设置用户

（1）设置用户，使用客户端的证书和客户端密钥，并且将证书数据嵌入到配置文件中

  1. kubectl config --kubeconfig=config-demo set-credentials developer --client-certificate=fake-cert-file --client-key=fake-key-seefile --embed-certs=true

注意：客户端证书和key必须要存在。

(2)设置用户，使用用户名和密码

  1. kubectl config --kubeconfig=config-demo set-credentials experimenter --username=exp --password=some-password

（3）删除用户

  1. kubectl config --kubeconfig=config-demo unset users.experimenter

experimenter这个就是使用set-credentials参数后面的名字。

5.3、增加上下文信息context

  1. kubectl config --kubeconfig=config-demo set-context dev-frontend --cluster=development --namespace=frontend --user=developer

设置context将集群、命名空间、用户进行分组。即在dev-fronted这个context的以developer用户的信息访问developement集群的frontend命名空间。

  1. kubectl config --kubeconfig=config-demo set-context dev-storage --cluster=development --namespace=storage --user=developer

dev-stroage这个context访问stroage命名空间。

查看通过以上的所有配置形成的kubeconfig文件

  1. [root@nccztsjb-node-11 config-exercise]# cat config-demo 
  2. apiVersion: v1
  3. clusters:
  4. - cluster:
  5.     certificate-authority: fake-ca-file
  6.     server: https://1.2.3.4
  7.   name: development
  8. - cluster:
  9.     insecure-skip-tls-verify: true
  10.     server: https://5.6.7.8
  11.   name: scratch
  12. contexts:
  13. - context:
  14.     cluster: development
  15.     namespace: frontend
  16.     user: developer
  17.   name: dev-frontend
  18. - context:
  19.     cluster: development
  20.     namespace: storage
  21.     user: developer
  22.   name: dev-storage
  23. - context:
  24.     cluster: scratch
  25.     namespace: default
  26.     user: experimenter
  27.   name: exp-scratch
  28. current-context: ""
  29. kind: Config
  30. preferences: {}
  31. users:
  32. - name: developer
  33.   user:
  34.     client-certificate: fake-cert-file
  35.     client-key: fake-key-seefile
  36. - name: experimenter
  37.   user:
  38.     password: some-password.
  39.     username: exp

5.4、设置当前的context

  1. kubectl config --kubeconfig=config-demo use-context dev-frontend

查看当前的context

  1. kubectl config --kubeconfig=config-demo current-context

5.5、只查看和当前context有关的配置信息

  1. kubectl config --kubeconfig=config-demo view --minify
  1. [root@nccztsjb-node-11 config-exercise]# kubectl config --kubeconfig=config-demo view --minify
  2. apiVersion: v1
  3. clusters:
  4. - cluster:
  5.     certificate-authority: fake-ca-file
  6.     server: https://1.2.3.4
  7.   name: development
  8. contexts:
  9. - context:
  10.     cluster: development
  11.     namespace: frontend
  12.     user: developer
  13.   name: dev-frontend
  14. current-context: dev-frontend
  15. kind: Config
  16. preferences: {}
  17. users:
  18. - name: developer
  19.   user:
  20.     client-certificate: fake-cert-file
  21.     client-key: fake-key-seefile

那么kubeconfig中的其他的信息就不会显示

5.6、查看配置中所有的context

  1. [root@nccztsjb-node-11 config-exercise]# kubectl config --kubeconfig=config-demo get-contexts
  2. CURRENT   NAME           CLUSTER       AUTHINFO       NAMESPACE
  3. *         dev-frontend   development   developer      frontend
  4.           dev-storage    development   developer      storage
  5.           exp-scratch    scratch       experimenter   default

ok,以上就是kubeconfig的基本配置和使用。

6、总结

主要就是2个概念，kubeconfig由集群、用户、context组成。context将集群、命名空间、用户进行分组。每个context对应一个环境信息。

到此这篇关于k8s中kubeconfig的配置以及使用的文章就介绍到这了,更多相关k8s中kubeconfig配置使用内容请搜索w3xue以前的文章或继续浏览下面的相关文章希望大家以后多多支持w3xue！

 友情链接：直通硅谷 　点职佳 　北美留学生论坛

Kubernetes热门文章

  • 【Azure K8S | AKS】在AKS集群中创建 PVC(PersistentVolumeClaim)和 PV(PersistentVolume) 示例
  • 无法访问k8s.gcr.io下载镜像问题解决办法
  • Kubernetes(k8s)访问控制：身份认证
  • Prometheus服务发现之kubernetes_sd_config
  • Arthas排查Kubernetes中应用频繁挂掉重启异常
  • Kubernetes客户端认证——基于CA证书的双向认证方式
  • k8s中kubeconfig的配置以及使用详解
  • Centos7 安装部署 Kubernetes(k8s) 高可用集群
  • Kubernetes 证书详解
  • 案例分享-full gc导致k8s pod重启

    • Kubernetes推荐文章

  • 修改kubeadm证书过期时间及更新k8s集群证书
  • 探究kubernetes 探针参数periodSeconds和timeoutSeconds
  • 从 Helm 到 Operator：Kubernetes应用管理的进化
  • 深入理解Prometheus: Kubernetes环境中的监控实践
  • k8s集群搭建及对一些组件的简单理解（二）
  • K8s高可用集群二进制部署-V1.20
  • Kubernetes容器生命周期 —— 钩子函数详解（postStart、preStop）
  • Kubernetes 审计（Auditing）
  • Thanos解码：打造企业级云原生监控解决方案
  • k8s使用rbd作为存储

    • 本站QQ群：前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

    W3xue 的所有内容仅供测试，对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
    关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接（目前9元/月）请联系QQ：27243702 沸活量
    皖ICP备17017327号-2　皖公网安备34020702000426号