📚 课程目录第2章 KubeConfig基础回顾

KubeConfig 基础回顾：文件结构、三要素与命令速览

KubeConfig 是 Kubernetes 集群访问的“通行证”与“路由表”。无论是单集群开发还是多集群运维，理解其内部结构都是掌握 KubeConfig 快照 与 租户边界回退 的前提。本节从文件结构、三要素、常用命令三个维度进行系统回顾。

KubeConfig 默认位于 $HOME/.kube/config，是一个 YAML 格式的配置文件。其顶层字段定义了集群、用户、上下文以及当前上下文。

顶层字段	类型	说明
`apiVersion`	string	固定为 `v1`
`kind`	string	固定为 `Config`
`clusters`	[]Cluster	集群列表，包含 API Server 地址与 CA 证书
`users`	[]User	用户列表，包含客户端证书、或用户名密码
`contexts`	[]Context	上下文列表，将 cluster、user、namespace 绑定为一个三元组
`current-context`	string	当前激活的上下文名称

  关键认知： KubeConfig 本身不存储敏感密钥明文（如私钥），而是引用证书文件路径或嵌入 base64 编码的证书数据。在多集群场景下，一个 KubeConfig 文件可以包含数十个集群与用户条目。

三要素是 KubeConfig 的核心抽象，理解它们之间的关系是操作多集群拓扑的基础。

clusters：定义集群的访问端点（server）和证书颁发机构（certificate-authority-data）。每个集群有一个唯一名称。
users：定义客户端身份凭证，支持 client-certificate-data + client-key-data、、username/password 或 exec 插件认证。
contexts：将 cluster、user、namespace 组合为一个命名三元组。切换上下文即切换集群/用户/命名空间组合。

租户边界映射： 在多租户场景中，每个租户通常对应一个独立的 namespace 或一组 namespace。通过为不同租户创建不同的 context（相同 cluster + 不同 user + 不同 namespace），可以实现租户级别的访问隔离。

以下是一个典型的三要素关系示意图：

kubectl config 是操作 KubeConfig 文件的专用命令组，支持查看、修改、合并、切换上下文等操作。以下为高频子命令清单：

子命令	功能	常用示例
`view`	查看当前 KubeConfig 内容（合并后）	`kubectl config view`
`get-contexts`	列出所有上下文	`kubectl config get-contexts`
`current-context`	显示当前上下文名称	`kubectl config current-context`
`use-context`	切换当前上下文	`kubectl config use-context ctx-dev-staging`
`set-context`	修改或创建上下文	`kubectl config set-context ctx-demo --cluster=cluster-a --user=user-admin --namespace=prod`
`set-cluster`	修改或创建集群条目	`kubectl config set-cluster cluster-c --server=https://10.0.0.3:6443`
`set-credentials`	修改或创建用户凭证	`kubectl config set-credentials user-ops --=xxxx`
`delete-context`	删除指定上下文	`kubectl config delete-context ctx-old`
`rename-context`	重命名上下文	`kubectl config rename-context ctx-old ctx-new`

常见陷阱： 使用 set-context 时如果指定的 cluster 或 user 不存在，命令不会报错，但切换后会导致 API 调用失败。建议在修改后执行 kubectl config view 验证完整性。

以下 SVG 展示了从单集群到多集群的上下文切换路径，这是后续快照回退演练的基础操作模式。

在 KubeConfig 快照课程中，三要素的每个字段都可能成为回退目标：