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

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

AWS-UpdateEKSSelfManagedLinuxNodeGroups

説明

AWS-UpdateEKSSelfManagedLinuxNodeGroups ランブックは、 AWS CloudFormation スタックを使用することで、Amazon Elastic Kubernetes Service (Amazon EKS) クラスター内の自己管理型の管理型ノードグループを更新します。

クラスターで自動スケーリングを使用している場合は、このランブックを使用する前にデプロイを 2 つのレプリカにスケールダウンすることをお勧めします。

デプロイでのレプリカを 2 にスケールするには

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

  2. 以下のコマンドを実行してください。

    kubectl scale deployments/cluster-autoscaler --replicas=2 -n kube-system

  3. AWS-UpdateEKSSelfManagedLinuxNodeGroups ランブックを実行してください。

  4. デプロイを必要な数のレプリカにスケールバックする際は、次のコマンドを実行します。

    kubectl scale deployments/cluster-autoscaler --replicas=number -n kube-system

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

ドキュメントタイプ

Automation

[所有者]

Amazon

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

Linux、macOS、Windows

パラメータ

  • AutomationAssumeRole

    タイプ: 文字列

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

  • ClusterName

    タイプ: 文字列

    説明: (必須) Amazon EKS クラスターの名前。

  • NodeGroupName

    タイプ: 文字列

    説明: (必須) マネージド型ノードグループの名前。

  • ClusterControlPlaneSecurityGroup

    タイプ: 文字列

    説明: (必須) コントロールプレーンセキュリティグループの ID。

  • DisableIMDSv1

    型: ブール値

    説明: (オプション) インスタンスメタデータサービスバージョン 1 (IMDSv1) および IMDSv2 を許可するかどうかを決定します。

  • KeyName

    タイプ: 文字列

    説明: (オプション) インスタンスのキーの名前。

  • NodeAutoScalingGroupDesiredCapacity

    タイプ: 文字列

    説明: (オプション) ノードグループが保持する必要があるノードの数。

  • NodeAutoScalingGroupMaxSize

    タイプ: 文字列

    説明: (オプション) ノードグループがスケールアウトできるノードの最大数。

  • NodeAutoScalingGroupMinSize

    タイプ: 文字列

    説明: (オプション) ノードグループがスケールインできるノードの最小数。

  • NodeInstanceType

    タイプ: 文字列

    デフォルト: t3.large

    説明: (オプション) ノードグループに使用するインスタンスタイプ。

  • NodeImageId

    タイプ: 文字列

    説明: (オプション) ノードグループに使用する Amazon Machine Image (AMI) のID。

  • NodeImageIdSSMParam

    タイプ: 文字列

    デフォルト: /aws/service/eks/optimized-ami/1.21/amazon-linux-2/recommended/image_id

    説明: (オプション) ノードグループに使用する AMI のパブリック Systems Manager パラメータ。

  • StackName

    タイプ: 文字列

    説明: (必須) ノードグループの更新に使用される CloudFormation スタックの名前。

  • サブネット

    タイプ: 文字列

    説明: (必須) クラスターに使用させるサブネットの ID をカンマ区切りにしたリスト。

  • VpcId

    タイプ: 文字列

    デフォルト: Default

    説明: (必須) クラスターがデプロイされている仮想プライベートクラウド (VPC)。

必要な IAM アクセス許可

AutomationAssumeRole パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。

  • eks:CreateCluster

  • eks:CreateNodegroup

  • eks:DeleteNodegroup

  • eks:DeleteCluster

  • eks:DescribeCluster

  • eks:DescribeNodegroup

  • eks:ListClusters

  • eks:ListNodegroups

  • eks:UpdateClusterConfig

  • eks:UpdateNodegroupConfig

ドキュメントステップ

  • aws:executeScript - ランブックの入力パラメータに指定した値に従って Amazon EKS クラスターノードグループを更新します。

  • aws:waitForAwsResourceProperty - CloudFormation スタックの更新ステータスが返されるのを待ちます。