AWS-DeleteEKSCluster - AWS Systems Manager 自動化ランブックリファレンス

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

AWS-DeleteEKSCluster

説明

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

注記

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

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

  1. Kubernetes コマンドラインユーティリティ kubectl をインストールします。詳細については、「Amazon EKS ユーザーガイド」の「Ikubectl のインストール」を参照してください。

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

    kubectl get svc --all-namespaces

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

    
                        kubectl delete svc
                        service-name

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

このオートメーションを実行する (コンソール)

ドキュメントタイプ

Automation

[所有者]

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 スタックを削除します。