它是什么
k8s集群对外是以API的方式访问,连接到集群至少你需要几个信息:
- api地址
- ca证书
- 用户token
实际很多客户端,比如kubectl,helm,以及比如官方的client-go类库都会默认支持kubeconfig文件的方式
官方的解释:A file that is used to configure access to clusters is called a kubeconfig file. This is a generic way of referring to configuration files. It does not mean that there is a file named kubeconfig.
就是文件叫什么名字都无所谓,就是一个存储在文件内的一个配置信息罢了
什么时候需要配置这个东西
- 你想远程连接某个或者多个k8s集群
- CI构建流程里想通过kubectl命令直接deploy你的app到集群里
- ...
各种你想和k8s集群打交道的时候都需要先考虑配置这个
它的位置
- 优先从
--kubeconfig
里指定的位置读取 - 然后检查是否存在环境变量
KUBECONFIG
是否有值 - 最后默认从
$HOME/.kube/config
如何配置
# 集群信息
kubectl config set-cluster xx-cluster --server="$KUBE_URL" --certificate-authority="/path/xxca.pem"
# 用户信息
kubectl config set-credentials xx-user --token="$KUBE_TOKEN" --certificate-authority="/path/xxca.pem"
# 配置context
kubectl config set-context xx-context --cluster=xx-cluster --user=xx-user --namespace="$KUBE_NAMESPACE"
# 切换具体的context
kubectl config use-context xx-context
配置里的xx*实际操作需要替换成自己喜欢的名字,以及集群的API地址,用户的token,证书三个关键信息
示例配置
apiVersion: v1
clusters:
- cluster:
certificate-authority: /path/xxca.pem
server: https://k8s-api.xxx.com
name: xx-cluster
contexts:
- context:
cluster: xx-cluster
namespace: xx-namespace
user: xx-user
name: xx-context
current-context: xx-context
kind: Config
preferences: {}
users:
- name: xx-user
user:
token: xxxxxxxxxxxxxxxxxxxxxxxxxxxx
一般都是使用kubectl config生成配置,然后kubectl version测试下是否可以连接到集群
Client Version: version.Info{Major:"1", Minor:"15", GitVersion:"v1.15.0", GitCommit:"e8462b5b5dc2584fdcd18e6bcfe9f1e4d970a529", GitTreeState:"clean", BuildDate:"2019-06-19T16:40:16Z", GoVersion:"go1.12.5", Compiler:"gc", Platform:"linux/amd64"}
Server Version: version.Info{Major:"1", Minor:"15", GitVersion:"v1.15.0", GitCommit:"e8462b5b5dc2584fdcd18e6bcfe9f1e4d970a529", GitTreeState:"clean", BuildDate:"2019-06-19T16:32:14Z", GoVersion:"go1.12.5", Compiler:"gc", Platform:"linux/amd64"}
官方相关文档
https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/