如何从 kubectl 配置中删除集群和上下文？

在 Kubernetes 管理过程中，随着集群和上下文的不断增加，配置文件很容易变得臃肿。本文将介绍如何清理这些冗余配置，帮助你保持清晰的配置结构。

1. Kubernetes 中的集群与上下文

Kubernetes 使用 kubectl 作为命令行工具，用于与集群交互。它的配置文件通常位于 ~/.kube/config，其中包含了集群、上下文、用户等信息。

Cluster（集群）：是 Kubernetes 的基础单元，包含多个节点，运行容器化应用。
Context（上下文）：是集群、用户和命名空间的组合，用于快速切换不同环境。

2. 删除集群和上下文的命令

2.1 使用 `unset` 删除特定属性

unset 命令用于删除配置中的某个具体字段，而不是整个条目。

# 删除某个上下文
$ kubectl config unset contexts.<context-name>

# 删除某个集群
$ kubectl config unset clusters.<cluster-name>

2.2 使用 `delete` 删除完整条目

delete 命令用于彻底删除一个上下文或集群的全部配置。

# 删除上下文
$ kubectl config delete-context <context-name>

# 删除集群
$ kubectl config delete-cluster <cluster-name>

⚠️ 删除上下文或集群后，如果当前上下文被删除，后续 kubectl 命令将失败，直到重新设置有效上下文。

3. 示例操作

查看当前配置：

$ kubectl config view
apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: DATA+OMITTED
    server: https://master-node:6443
  name: kubernetes
contexts:
- context:
    cluster: kubernetes
    user: kubernetes-admin
  name: kubernetes-admin@kubernetes
- context:
    cluster: kubernetes
    namespace: staging
    user: user-02
  name: staging
current-context: kubernetes-admin@kubernetes
kind: Config
preferences: {}
users:
- name: kubernetes-admin
  user:
    client-certificate-data: DATA+OMITTED
    client-key-data: DATA+OMITTED

使用 unset 删除 staging 上下文的部分配置：

$ kubectl config unset contexts.staging
Property "contexts.staging" unset.

使用 delete 彻底删除上下文和集群：

$ kubectl config delete-context staging
deleted context staging from /home/user/.kube/config

$ kubectl config delete-cluster kubernetes
deleted cluster kubernetes from /home/user/.kube/config

✅ 使用 delete 会彻底删除条目，适合清理不再使用的配置。

4. 总结

✅ unset：用于删除配置中的某个字段，适合局部清理。
✅ delete：用于删除整个上下文或集群条目，适合彻底清理。
⚠️ 删除后，若当前上下文被移除，需重新设置新的上下文才能正常使用 kubectl。

保持配置文件干净，有助于提升管理效率，也能避免一些潜在的误操作风险。

Persistence

REST

Security