k8s中kubeconfig的配置以及使用詳解
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環境變量，看到的配置是合並的配置
[root@nccztsjb-node-11 ~]# kubectl config view
apiVersion: v1
clusters:
- cluster:
certificate-authority-data: DATA+OMITTED
server: https://k8s.apiserver.io:6443
name: cluster.local
contexts:
- context:
cluster: cluster.local
user: kubernetes-admin-cluster.local
name: [email protected]
current-context: [email protected]
kind: Config
preferences: {}
users:
- name: kubernetes-admin-cluster.local
user:
client-certificate-data: REDACTED
client-key-data: REDACTED
[root@nccztsjb-node-11 ~]#
通過kubectl config view得到的配置可能是來自一個kubeconfig文件，也可能是來自多個kubeconfig文件合並的結果。
5、kubeconfig設置
5.1、設置集群
（1）集群有CA認證，並且將證書的輸入嵌入到配置文件中
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文件的內容
[root@nccztsjb-node-11 config-exercise]# cat config-demo
apiVersion: v1
clusters:
- cluster:
certificate-authority-data: LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUM2VENDQWRHZ0F3SUJBZ0lCQURBTkJna3Foa2lHOXcwQkFRc0ZBREFWTVJNd0VRWURWUVFERXdwcmRXSmwKY201bGRHVnpNQ0FYRFRJeE1USXdNakE0TURjMU5sb1lEekl4TVRFeE1URXhNRGd3TnpVMldqQVZNUk13RVFZRApWUVFERXdwcmRXSmxjbTVsZEdWek1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBCnFaWkVNZDhORHpoek5hTE1ab2tCenlabVUzQWh6R1Z4OW15MzJxaTB3UzkzS3Jib0xMUWhSSUhCYnYzdzZCbCsKZlBYaUdSeCt4OVpKY2lta1BqdmJtQ0ZpKzEvQmsxZkFONlNBSi9ISjJoenQxcExZbW41NXVVclpqdmFCTXNUdAp5U3B4QUlOUWNNU1NJYUFyeHF1VDJ0QjYzWkMvTHloQVFWWG4xL2lYS3hLTmpidjVlS21BdlRRTlQrNlMxaFIxCkJNQXNjSFc0R1lhNXVBTFZBTmZrVlpGaG5GMmt2cVMyRzRDMXV4emZtOFpyUnREOExRUjFmTnk1VnpnVkJLQjMKT2RKQkExNnl4YXk5N2JjaEtqenpqTmxKMFBlVDBOdFZZWVRlZ3F1ZG5iRURRSEdObC91Ym5UcGtWWHpFUGRKNAo3a3FQREdWUzRXYi9DZXpVcm9IQ1hRSURBUUFCbzBJd1FEQU9CZ05WSFE4QkFmOEVCQU1DQXFRd0R3WURWUjBUCkFRSC9CQVV3QXdFQi96QWRCZ05WSFE0RUZnUVVmQldoK3hIdlVSdFdKdUVuUUlYTHRDUzh2MEl3RFFZSktvWkkKaHZjTkFRRUxCUUFEZ2dFQkFHeHNvSXJOZkJYRkp1RjZwYmtvSkh3eVdCSkp0Qzlud1VabWNCMmYzT0xTZTN4LwpQQU5oYm9LcHZ6ME5ocm5IQ2VnUk1rWGlmSmhKZW9VU25sYUhJaWpjVlFDZ09sTDVnT0EyeFZkRk01MlZCTk5jCnN1Qmp2MHJoQnZXMWxaYWVEUGJuaGp3dGY5elp2WG4vMUkvZ1RKSVRiNmFVdk55b1U3WHY2c3RmN1NjaExwU3kKZmVwRjNKRFc5TXRvem9yMHhoV0U3M0FrZHE1bnE4OFlSdEcxK3UwRTJXbDJ5U20yR0dzRUkvcU1HOXlvd0NsRgozSnhOQm45MEk3V0xKd0pETGZZMXYwWXdRNDR3QUJteGN4R01qVzNmOHAvL3pxSHNaaXJGdTR3QUlUK003Mmw3CkhDbXAwbm84VXpKMUdMUFcxNzF5TWNsdlJNM3h2SENtZHd0VktBMD0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=
server: https://1.2.3.4
name: development
contexts: null
current-context: ""
kind: Config
preferences: {}
users: null
[root@nccztsjb-node-11 config-exercise]#
已經設置好瞭集群
（2）集群沒有證書的
kubectl config --kubeconfig=config-demo set-cluster development --server=https://1.2.3.4
查看證書內容
[root@nccztsjb-node-11 config-exercise]# kubectl config --kubeconfig=config-demo set-cluster development --server=https://1.2.3.4
Cluster "development" set.
[root@nccztsjb-node-11 config-exercise]# cat config-demo
apiVersion: v1
clusters:
- cluster:
server: https://1.2.3.4
name: development
contexts: null
current-context: ""
kind: Config
preferences: {}
users: null
[root@nccztsjb-node-11 config-exercise]
（3）集群有證書，但是證書驗證的
kubectl config --kubeconfig=config-demo set-cluster scratch --server=https://5.6.7.8 --insecure-skip-tls-verify
查看證書的內容
[root@nccztsjb-node-11 config-exercise]# cat config-demo
apiVersion: v1
clusters:
- cluster:
certificate-authority-data: LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUM2VENDQWRHZ0F3SUJBZ0lCQURBTkJna3Foa2lHOXcwQkFRc0ZBREFWTVJNd0VRWURWUVFERXdwcmRXSmwKY201bGRHVnpNQ0FYRFRJeE1USXdNakE0TURjMU5sb1lEekl4TVRFeE1URXhNRGd3TnpVMldqQVZNUk13RVFZRApWUVFERXdwcmRXSmxjbTVsZEdWek1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBTUlJQkNnS0NBUUVBCnFaWkVNZDhORHpoek5hTE1ab2tCenlabVUzQWh6R1Z4OW15MzJxaTB3UzkzS3Jib0xMUWhSSUhCYnYzdzZCbCsKZlBYaUdSeCt4OVpKY2lta1BqdmJtQ0ZpKzEvQmsxZkFONlNBSi9ISjJoenQxcExZbW41NXVVclpqdmFCTXNUdAp5U3B4QUlOUWNNU1NJYUFyeHF1VDJ0QjYzWkMvTHloQVFWWG4xL2lYS3hLTmpidjVlS21BdlRRTlQrNlMxaFIxCkJNQXNjSFc0R1lhNXVBTFZBTmZrVlpGaG5GMmt2cVMyRzRDMXV4emZtOFpyUnREOExRUjFmTnk1VnpnVkJLQjMKT2RKQkExNnl4YXk5N2JjaEtqenpqTmxKMFBlVDBOdFZZWVRlZ3F1ZG5iRURRSEdObC91Ym5UcGtWWHpFUGRKNAo3a3FQREdWUzRXYi9DZXpVcm9IQ1hRSURBUUFCbzBJd1FEQU9CZ05WSFE4QkFmOEVCQU1DQXFRd0R3WURWUjBUCkFRSC9CQVV3QXdFQi96QWRCZ05WSFE0RUZnUVVmQldoK3hIdlVSdFdKdUVuUUlYTHRDUzh2MEl3RFFZSktvWkkKaHZjTkFRRUxCUUFEZ2dFQkFHeHNvSXJOZkJYRkp1RjZwYmtvSkh3eVdCSkp0Qzlud1VabWNCMmYzT0xTZTN4LwpQQU5oYm9LcHZ6ME5ocm5IQ2VnUk1rWGlmSmhKZW9VU25sYUhJaWpjVlFDZ09sTDVnT0EyeFZkRk01MlZCTk5jCnN1Qmp2MHJoQnZXMWxaYWVEUGJuaGp3dGY5elp2WG4vMUkvZ1RKSVRiNmFVdk55b1U3WHY2c3RmN1NjaExwU3kKZmVwRjNKRFc5TXRvem9yMHhoV0U3M0FrZHE1bnE4OFlSdEcxK3UwRTJXbDJ5U20yR0dzRUkvcU1HOXlvd0NsRgozSnhOQm45MEk3V0xKd0pETGZZMXYwWXdRNDR3QUJteGN4R01qVzNmOHAvL3pxSHNaaXJGdTR3QUlUK003Mmw3CkhDbXAwbm84VXpKMUdMUFcxNzF5TWNsdlJNM3h2SENtZHd0VktBMD0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=
server: https://1.2.3.4
name: development
- cluster:
insecure-skip-tls-verify: true
server: https://5.6.7.8
name: scratch
contexts: null
current-context: ""
kind: Config
preferences: {}
users: null
[root@nccztsjb-node-11 config-exercise]#
(4)刪除集群
kubectl config --kubeconfig=config-demo unset clusters.development
5.2、設置用戶
（1）設置用戶，使用客戶端的證書和客戶端密鑰，並且將證書數據嵌入到配置文件中
kubectl config --kubeconfig=config-demo set-credentials developer --client-certificate=fake-cert-file --client-key=fake-key-seefile --embed-certs=true
註意：客戶端證書和key必須要存在。
(2)設置用戶，使用用戶名和密碼
kubectl config --kubeconfig=config-demo set-credentials experimenter --username=exp --password=some-password
（3）刪除用戶
kubectl config --kubeconfig=config-demo unset users.experimenter
experimenter這個就是使用set-credentials參數後面的名字。
5.3、增加上下文信息context
kubectl config --kubeconfig=config-demo set-context dev-frontend --cluster=development --namespace=frontend --user=developer
設置context將集群、命名空間、用戶進行分組。即在dev-fronted這個context的以developer用戶的信息訪問developement集群的frontend命名空間。
kubectl config --kubeconfig=config-demo set-context dev-storage --cluster=development --namespace=storage --user=developer
dev-stroage這個context訪問stroage命名空間。
查看通過以上的所有配置形成的kubeconfig文件
[root@nccztsjb-node-11 config-exercise]# cat config-demo
apiVersion: v1
clusters:
- cluster:
certificate-authority: fake-ca-file
server: https://1.2.3.4
name: development
- cluster:
insecure-skip-tls-verify: true
server: https://5.6.7.8
name: scratch
contexts:
- context:
cluster: development
namespace: frontend
user: developer
name: dev-frontend
- context:
cluster: development
namespace: storage
user: developer
name: dev-storage
- context:
cluster: scratch
namespace: default
user: experimenter
name: exp-scratch
current-context: ""
kind: Config
preferences: {}
users:
- name: developer
user:
client-certificate: fake-cert-file
client-key: fake-key-seefile
- name: experimenter
user:
password: some-password.
username: exp
5.4、設置當前的context
kubectl config --kubeconfig=config-demo use-context dev-frontend
查看當前的context
kubectl config --kubeconfig=config-demo current-context
5.5、隻查看和當前context有關的配置信息
kubectl config --kubeconfig=config-demo view --minify
[root@nccztsjb-node-11 config-exercise]# kubectl config --kubeconfig=config-demo view --minify
apiVersion: v1
clusters:
- cluster:
certificate-authority: fake-ca-file
server: https://1.2.3.4
name: development
contexts:
- context:
cluster: development
namespace: frontend
user: developer
name: dev-frontend
current-context: dev-frontend
kind: Config
preferences: {}
users:
- name: developer
user:
client-certificate: fake-cert-file
client-key: fake-key-seefile
那麼kubeconfig中的其他的信息就不會顯示
5.6、查看配置中所有的context
[root@nccztsjb-node-11 config-exercise]# kubectl config --kubeconfig=config-demo get-contexts
CURRENT NAME CLUSTER AUTHINFO NAMESPACE
* dev-frontend development developer frontend
dev-storage development developer storage
exp-scratch scratch experimenter default
ok,以上就是kubeconfig的基本配置和使用。
6、總結
主要就是2個概念，kubeconfig由集群、用戶、context組成。context將集群、命名空間、用戶進行分組。每個context對應一個環境信息。
到此這篇關於k8s中kubeconfig的配置以及使用的文章就介紹到這瞭,更多相關k8s中kubeconfig配置使用內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！
推薦閱讀：
- k3d入門指南之在Docker中運行K3s的詳細教程
- Python使用Kubernetes API訪問集群
- Mac為docker和kubectl添加自動補全命令的方法
- python3 kubernetes api的使用示例
- Kubernetes中創建命名空間實現方法