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

# `AWS-UpdateEKSSelfManagedLinuxNodeGroups`
<a name="aws-updateeksselfmanagedlinuxnodegroup"></a>

 **説明** 

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

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

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

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

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

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

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

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

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

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

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

オートメーション

**[所有者]**

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