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

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

# クラスターから Amazon EKS アドオンを削除する
<a name="removing-an-add-on"></a>

`eksctl`、AWS マネジメントコンソール、AWS CLI を使用して Amazon EKS アドオンをクラスターから削除できます。

クラスターから Amazon EKS アドオンを削除する場合:
+ アドオンが提供する機能にはダウンタイムはありません。
+ サービスアカウントの IAM 役割 (IRSA) を使用していて、アドオンに IAM 役割が関連付けられている場合、IAM 役割は削除されません。
+ Pod Identities を使用している場合、アドオンが所有する Pod Identity の関連付けはすべて削除されます。AWS CLI に `--preserve` オプションを指定すると、関連付けは保持されます。
+ Amazon EKS はアドオンの設定の管理を停止します。
+ 新しいバージョンが利用可能になると、コンソールが通知を停止します。
+ AWS ツールや API を使用してアドオンを更新することはできません。
+ 自己管理できるようにアドオンソフトウェアをクラスターに保持するか、クラスターからアドオンソフトウェアを削除するかを選択できます。そのアドオンが提供している機能に依存するクラスターにリソースがない場合のみ、クラスターからアドオンソフトウェアを削除してください。

## 前提条件
<a name="removing-an-add-on-prereq"></a>

アドオンを作成する前に、次を完了します:
+ 既存の Amazon EKS クラスター。デプロイするには「[Amazon EKS の使用を開始する](getting-started.md)」を参照してください。
+ アドオンに IAM 役割が必要かどうかを確認します。詳細については「」を参照してください。
+ デバイスまたは AWS CloudShell にインストールされている `eksctl` コマンドラインツールのバージョン `0.215.0` 以降。`eksctl` をインストールまたはアップグレードするには`eksctl` ドキュメントの「[インストール](https://eksctl.io/installation)」を参照してください。

## 手順
<a name="removing-an-add-on-procedure"></a>

Amazon EKS アドオンを削除する場合、次の 2 つのオプションがあります。
+  **クラスター上のアドオンソフトウェアを保持する** — このオプションではすべての設定の Amazon EKS 管理が削除されます。また、Amazon EKS による更新の通知機能や、更新の開始後の Amazon EKS アドオンの自動更新機能も削除されます。ただし、クラスター上のアドオンソフトウェアは保持されます。このオプションを選択すると、アドオンは Amazon EKS アドオンではなく、セルフマネージド型インストールになります。このオプションを使用すると、アドオンのダウンタイムは発生しません。
+  **クラスターからアドオンソフトウェアを完全に削除する** — クラスターから Amazon EKS アドオンを削除するのはアドオンに依存するリソースがクラスター上にない場合のみとすることをお勧めします。

Amazon EKS アドオンは `eksctl`、AWS マネジメントコンソール、AWS CLI を使用して削除できます。

### アドオンの削除 (eksctl)
<a name="_remove_add_on_eksctl"></a>

1. クラスターに現在インストールされているアドオンを確認します。*マイクラスター* の部分は自分のクラスター名に置き換えます。

   ```
   eksctl get addon --cluster my-cluster
   ```

   出力例は次のとおりです。

   ```
   NAME        VERSION              STATUS  ISSUES  IAMROLE  UPDATE AVAILABLE
   coredns     v1.8.7-eksbuild.2    ACTIVE  0
   kube-proxy  v1.23.7-eksbuild.1   ACTIVE  0
   vpc-cni     v1.10.4-eksbuild.1   ACTIVE  0
   [...]
   ```

   クラスターにあるアドオンおよびバージョンによって、出力が異なる場合があります。

1. アドオンを削除します。*マイクラスター* をクラスターの名前に置き換えて、*name-of-add-on* を削除する前のステップの出力で返されたアドオン名に置き換えます。*--preserve* オプションを削除する場合、Amazon EKS がアドオンを管理しなくなるだけではなく、アドオンソフトウェアがクラスターから削除されます。

   ```
   eksctl delete addon --cluster my-cluster --name name-of-addon --preserve
   ```

   アドオンの削除の詳細については`eksctl` ドキュメントの「[Deleting addons](https://eksctl.io/usage/addons/#deleting-addons)」を参照してください。

### アドオンの削除 (AWS コンソール)
<a name="remove_add_on_shared_aws_console"></a>

1. [Amazon EKS コンソール](https://console.aws.amazon.com/eks/home#/clusters)を開きます。

1. 左のナビゲーションペインで **[クラスター]** を選択してください。

1. Amazon EKS アドオンを削除するクラスターの名前を選択してください。

1. **[アドオン]** タブを選択してください。

1. 削除するアドオンを選択してください。

1. **[削除]** を選択してください。

1. **[削除: *アドオンの名前*]** 確認ダイアログボックスで、次を実行します:

   1. Amazon EKS でのアドオンの設定の管理を停止する場合は**[クラスターで保持する]** を選択してください。クラスターでアドオンソフトウェアを保持する場合はこの操作を実行してください。これはアドオンのすべての設定を自分で管理できるようにするためです。

   1. アドオン名を入力してください。

   1. **[削除]** を選択してください。

### アドオンの削除 (AWS CLI)
<a name="remove_add_on_shared_aws_cli"></a>

1. デバイスまたは AWS クラウドシェル にインストールされている `eksctl` コマンドラインツールのバージョン `0.215.0` 以降が必要です。`eksctl` をインストールまたはアップグレードするには`eksctl` ドキュメントの「[インストール](https://eksctl.io/installation)」を参照してください。

1. インストールされているアドオンのリストを参照してください。*マイクラスター* の部分は自分のクラスター名に置き換えます。

   ```
   aws eks list-addons --cluster-name my-cluster
   ```

   出力例は次のとおりです。

   ```
   {
       "addons": [
           "coredns",
           "kube-proxy",
           "vpc-cni",
           "name-of-addon"
       ]
   }
   ```

1. インストールされているアドオンを削除します。*マイクラスター* をクラスターの名前に置き換えて、*name-of-add-on* を削除するアドオン名に置き換えます。*--preserve* を削除することにより、アドオンソフトウェアがクラスターから削除されます。

   ```
   aws eks delete-addon --cluster-name my-cluster --addon-name name-of-addon --preserve
   ```

   簡略化した出力例を次に示します。

   ```
   {
       "addon": {
           "addonName": "name-of-add-on",
           "clusterName": "my-cluster",
           "status": "DELETING",
       }
   }
   ```

1. 削除のステータスを確認します。*マイクラスター* をクラスターの名前に置き換えて、*name-of-addon* を削除するアドオン名に置き換えます。

   ```
   aws eks describe-addon --cluster-name my-cluster --addon-name name-of-addon
   ```

   アドオンを削除した後の出力例は次のとおりです。

   ```
   An error occurred (ResourceNotFoundException) when calling the DescribeAddon operation: No addon: name-of-addon found in cluster: my-cluster
   ```