クラスターから アマゾン EKS アドオンを削除する - Amazon EKS
前提条件手順

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

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

クラスターから アマゾン EKS アドオンを削除する

eksctl、AWS Management Console、AWS CLI を使用して アマゾン EKS アドオンをクラスターから削除できます。

クラスターから アマゾン EKS アドオンを削除する場合:

  • アドオンが提供する機能にはダウンタイムはありません。

  • サービスアカウントの IAM 役割 (IRSA) を使用していて、アドオンに IAM 役割が関連付けられている場合、IAM 役割は削除されません。

  • Pod Identities を使用している場合、アドオンが所有する Pod Identity の関連付けはすべて削除されます。AWS CLI に --preserve オプションを指定すると、関連付けは保持されます。

  • アマゾン EKS はアドオンの設定の管理を停止します。

  • 新しいバージョンが利用可能になると、コンソールが通知を停止します。

  • AWS ツールや API を使用してアドオンを更新することはできません。

  • 自己管理できるようにアドオンソフトウェアをクラスターに保持するか、クラスターからアドオンソフトウェアを削除するかを選択できます。そのアドオンが提供している機能に依存するクラスターにリソースがない場合のみ、クラスターからアドオンソフトウェアを削除してください。

前提条件

アドオンを作成する前に、次を完了します:

  • 既存の アマゾン EKS クラスター。デプロイするには「Amazon EKS の使用を開始する」を参照してください。

  • アドオンに IAM 役割が必要かどうかを確認します。詳細については「」を参照してください。

  • デバイスまたは AWS CloudShell にインストールされている eksctl コマンドラインツールのバージョン 0.204.0 以降。eksctl をインストールまたはアップグレードするにはeksctl ドキュメントの「インストール」を参照してください。

手順

アマゾン EKS アドオンを削除する場合、次の 2 つのオプションがあります。

  • クラスター上のアドオンソフトウェアを保持する — このオプションではすべての設定の アマゾン EKS 管理が削除されます。また、アマゾン EKS による更新の通知機能や、更新の開始後の アマゾン EKS アドオンの自動更新機能も削除されます。ただし、クラスター上のアドオンソフトウェアは保持されます。このオプションを選択すると、アドオンは アマゾン EKS アドオンではなく、セルフマネージド型インストールになります。このオプションを使用すると、アドオンのダウンタイムは発生しません。

  • クラスターからアドオンソフトウェアを完全に削除する — クラスターから アマゾン EKS アドオンを削除するのはアドオンに依存するリソースがクラスター上にない場合のみとすることをお勧めします。

アマゾン EKS アドオンは eksctl、AWS Management Console、AWS CLI を使用して削除できます。

アドオンの削除 (eksctl)

  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
[...]

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

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

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

    アドオンの削除の詳細についてはeksctl ドキュメントの「Deleting addons」を参照してください。

アドオンの削除 (AWS コンソール)

  1. アマゾン EKS コンソールを開きます。

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

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

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

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

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

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

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

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

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

アドオンの削除 (AWS CLI)

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

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

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

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

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

  3. インストールされているアドオンを削除します。マイクラスター をクラスターの名前に置き換えて、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",
    }
}

  4. 削除のステータスを確認します。マイクラスター をクラスターの名前に置き換えて、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