翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# `AWS-DeleteEKSCluster`
<a name="automation-aws-deleteekscluster"></a>

 **説明** 

 このランブックは、ノードグループや Fargate プロファイルなど、Amazon EKS クラスターに関連付けられているリソースを削除します。必要に応じて、すべてのセルフマネージド型ノード、ノードの作成に使用される CloudFormation スタック、クラスターの VPC CloudFormation スタックを削除できます。クラスターの削除の詳細については、Amazon EKS ユーザーガイドの[「クラスターの削除」](https://docs.aws.amazon.com/eks/latest/userguide/delete-cluster.html)を参照してください。

**注記**  
 クラスター内にロードバランサーと関連付けられているアクティブなサービスがある場合は、クラスターを削除する前にそれらのサービスを削除する必要があります。これを行わない場合は、システムがロードバランサーを削除できなくなります。`AWS-DeleteEKSCluster` ランブックを実行する前にサービスを検索および削除するには、次の手順に従います。

**クラスター内のサービスを検索して削除するには**

1.  Kubernetes コマンドラインユーティリティ `kubectl` をインストールします。詳細については、「Amazon EKS ユーザーガイド」の「[Ikubectl のインストール](https://docs.aws.amazon.com/eks/latest/userguide/install-kubectl.html)」を参照してください。

1. クラスターで実行されているすべてのサービスを一覧表示するには、次のコマンドを実行します。

   ```
   kubectl get svc --all-namespaces
   ```

1. EXTERNAL-IP 値が関連付けられているサービスをすべて削除するには、次のコマンドを実行します。これらのサービスの前面にはロードバランサーが置かれているため、そのロードバランサーや関連するリソースを適切に解放するためには、これらのサービスを Kubernetes から削除する必要があります。

   ```
                           kubectl delete svc
                           service-name
   ```

 これで、`AWS-DeleteEKSCluster` ランブックを実行できます。

 [このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-DeleteEKSCluster) 

**ドキュメントタイプ**

オートメーション

**[所有者]**

Amazon

**[Platforms]** (プラットフォーム)

Linux、macOS、Windows

**パラメータ**
+ AutomationAssumeRole

  タイプ: 文字列

  説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。
+ EKSClusterName

  タイプ: 文字列

  説明: (必須) 削除される Amazon EKS クラスターの名前。
+ VPCCloudFormationStack

  タイプ: 文字列

  説明: (オプション) 削除される EKS クラスターの VPC の CloudFormation スタック名。これにより、VPC の CloudFormation スタックと、スタックによって作成されたリソースが削除されます。
+ VPCCloudFormationStackRole

  タイプ: 文字列

  説明: (オプション) VPC CloudFormation スタックを削除するために が CloudFormation 引き受ける IAM ロールの ARN。 は、ロールの認証情報 CloudFormation を使用してユーザーに代わって呼び出しを行います。
+ SelfManagedNodeStacks

  タイプ: 文字列

  説明: (オプション) セルフマネージドノードの CloudFormation スタック名のカンマ区切りリスト。これにより、セルフマネージドノードの CloudFormation スタックが削除されます。
+ SelfManagedNodeStacksRole

  タイプ: 文字列

  説明: (オプション) セルフマネージド型ノードスタックを削除するために が CloudFormation 引き受ける IAM ロールの ARN。 は、ロールの認証情報 CloudFormation を使用してユーザーに代わって呼び出しを行います。

**必要な IAM アクセス許可**

`AutomationAssumeRole` パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。
+  `sts:AssumeRole` 
+  `eks:ListNodegroups` 
+  `eks:DeleteNodegroup` 
+  `eks:ListFargateProfiles` 
+  `eks:DeleteFargateProfile` 
+  `eks:DeleteCluster` 
+  `cfn:DescribeStacks` 
+  `cfn:DeleteStack` 

 **ドキュメントステップ** 
+  `aws:executeScript` - DeleteNodeGroups: EKS クラスター内のすべてのノードグループを検索および削除します。
+  `aws:executeScript` - DeleteFargateProfiles: EKS クラスター内のすべてのFargateプロファイルを検索および削除します。
+  `aws:executeScript` - DeleteSelfManagedNodes: すべてのセルフマネージド型ノードと、ノードの作成に使用される CloudFormation スタックを削除します。
+  `aws:executeScript` - DeleteEKSCluster: EKS クラスターを削除します。
+  `aws:executeScript` - DeleteVPCCloudFormationStack: VPC CloudFormation スタックを削除します。