**このページの改善にご協力ください** 

このユーザーガイドに貢献するには、すべてのページの右側のペインにある「**GitHub でこのページを編集する**」リンクを選択してください。

# Amazon EKS コンソールから Kubernetes クラスターの登録を解除する
<a name="deregister-connected-cluster"></a>

接続されたクラスターの使用が終了したら、登録を解除できます。登録解除されると、クラスターは Amazon EKS コンソールに表示されなくなります。

deregisterCluster API を呼び出すには、次のアクセス許可が必要です。
+  `eks:DeregisterCluster` 
+  `ssm:DeleteActivation` 
+  `ssm:DeregisterManagedInstance` 

このプロセスには 2 つのステップがあります。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. [アマゾン EKS コンソール](https://console.aws.amazon.com/eks/home#/clusters)を開きます。

1. **[クラスター]** を選択します。

1. リポジトリの[**クラスター**]ページで、接続されているクラスターを選択し、[**登録解除**]を選択します。

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 コネクタ 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 クラスターから削除します。