**帮助改进此页面** 

要帮助改进本用户指南，请选择位于每个页面右侧窗格中的**在 GitHub 上编辑此页面**链接。

# 从 Amazon EKS 控制台注销 Kubernetes 集群
<a name="deregister-connected-cluster"></a>

使用完已连接集群后，可以将其注销。取消注册后，该集群将不再在 Amazon EKS 控制台中显示。

您必须拥有以下权限才能调用 deregisterCluster API：
+  `eks:DeregisterCluster` 
+  `ssm:DeleteActivation` 
+  `ssm:DeregisterManagedInstance` 

此过程包括两个步骤：向 Amazon EKS 取消注册集群，在集群中卸载 eks-connector 代理。

## 注销 Kubernetes 集群
<a name="deregister-connected-cluster-eks"></a>

要从 Amazon EKS 连接器取消注册集群，您可以使用以下工具之一：
+  [AWS CLI](#awscli_deregister_cluster_connect) 
+  [AWS 管理控制台](#console_deregister_cluster_connect) 
+  [`eksctl`](#eksctl_deregister_cluster_connect) 

### AWS CLI
<a name="awscli_deregister_cluster_connect"></a>

1.  必须安装 AWS CLI。要进行安装或升级，请参阅[安装 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)。

1. 确保已创建 Amazon EKS Connector 代理角色。

1. 注销已连接的集群。

   ```
   aws eks deregister-cluster \
       --name my-cluster \
       --region region-code
   ```

### AWS 管理控制台
<a name="console_deregister_cluster_connect"></a>

1. 打开 [Amazon EKS 控制台](https://console.aws.amazon.com/eks/home#/clusters)。

1. 选择 **Clusters (集群)**。

1. 请在 **Clusters**（集群）页面上，选择连接的集群，然后选择 **Deregister**（注销）。

1. 确认您要注销该层。

### `eksctl`
<a name="eksctl_deregister_cluster_connect"></a>

1. 安装 `eksctl` 版本 `0.68` 或更高版本。要安装或对其升级，请参阅 [开始使用 Amazon EKS – `eksctl`](getting-started-eksctl.md)。

1. 确保已创建 Amazon EKS Connector 代理角色。

1. 取消注册已连接的集群：

   ```
   eksctl deregister cluster --name my-cluster
   ```

## 清除 Kubernetes 集群中的资源
<a name="deregister-connected-cluster-k8s"></a>

要卸载 `eks-connector` 代理，请使用以下工具之一：
+  [helm](#helm_agent_cluster_deregister) 
+  [yaml](#yaml_agent_cluster_deregister) 

### helm
<a name="helm_agent_cluster_deregister"></a>

运行以下命令来卸载代理。

```
helm -n eks-connector uninstall eks-connector
```

### yaml
<a name="yaml_agent_cluster_deregister"></a>

1. 从 Kubernetes 集群中删除 Amazon EKS Connector YAML 文件。

   ```
   kubectl delete -f eks-connector.yaml
   ```

1. 如果为其他 [IAM 主体](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#iam-term-principal)创建了 `clusterrole` 或 `clusterrolebindings` 来访问集群，请从 Kubernetes 集群中删除它们。