AWS-UpdateEKSSelfManagedLinuxNodeGroups - AWS Systems Manager オートメーションランブックリファレンス

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

AWS-UpdateEKSSelfManagedLinuxNodeGroups

説明

AWS-UpdateEKSSelfManagedLinuxNodeGroups ランブックは、 AWS CloudFormation スタックを使用して Amazon Elastic Kubernetes Service (Amazon EKS) クラスター内のセルフマネージドマネージド型ノードグループを更新します。

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

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

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

  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 ユーザーに代わってアクションを実行できるようにする () ロールARNの Amazon リソースネーム (IAM）。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。

  • ClusterName

    型: 文字列

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

  • NodeGroupName

    型: 文字列

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

  • ClusterControlPlaneSecurityGroup

    型: 文字列

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

  • D isableIMDSv1

    型: ブール値

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

  • KeyName

    型: 文字列

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

  • NodeAutoScalingGroupDesiredCapacity

    型: 文字列

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

  • NodeAutoScalingGroupMaxSize

    型: 文字列

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

  • NodeAutoScalingGroupMinSize

    型: 文字列

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

  • NodeInstanceType

    型: 文字列

    デフォルト: t3.large

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

  • NodeImageId

    型: 文字列

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

  • NodeImageIdSSMParam

    型: 文字列

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

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

  • StackName

    型: 文字列

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

  • サブネット

    型: 文字列

    説明: (必須) クラスターで使用するサブネットIDsの のカンマ区切りリスト。

  • 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 - AWS CloudFormation スタック更新ステータスが返されるまで待ちます。