

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# `AWS-MigrateToNewEKSSelfManagedNodeGroup`
<a name="aws-migratetoneweksselfmanagedlinuxnodegroup"></a>

 **Description** 

 Le `AWS-MigrateToNewEKSSelfManagedNodeGroup` runbook vous aide à créer un nouveau groupe de nœuds Linux Amazon Elastic Kubernetes Service (Amazon EKS) vers lequel migrer votre application existante. Pour plus d'informations, consultez la section [Migration vers un nouveau groupe de nœuds](https://docs.aws.amazon.com/eks/latest/userguide/migrate-stack.html) dans le **guide de l'utilisateur Amazon EKS**.

 [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-MigrateToNewEKSSelfManagedLinuxNodeGroup) 

**Type de document**

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

Linux

**Paramètres**
+ AutomationAssumeRole

  Type : Chaîne

  Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.
+ OldStackName

  Type : Chaîne

  Description : (Obligatoire) Le nom ou l'ID de pile de votre CloudFormation pile existante.
+ NewStackName

  Type : Chaîne

  Description : (Facultatif) Nom de la nouvelle CloudFormation pile créée pour votre nouveau groupe de nœuds. Si vous ne spécifiez aucune valeur pour ce paramètre, le nom de la pile est créé au format :`NewNodeGroup-{{ClusterName}}-{{AutomationExecutionID}}`.
+ ClusterControlPlaneSecurityGroup

  Type : Chaîne

  Description : (Facultatif) L'ID du groupe de sécurité que vous souhaitez que les nœuds utilisent pour communiquer avec le plan de contrôle Amazon EKS. Si vous ne spécifiez aucune valeur pour ce paramètre, le groupe de sécurité spécifié dans votre CloudFormation pile existante est utilisé.
+ NodeInstanceType

  Type : Chaîne

  Description : (Facultatif) Type d'instance que vous souhaitez utiliser pour le nouveau groupe de nœuds. Si vous ne spécifiez aucune valeur pour ce paramètre, le type d'instance spécifié dans votre CloudFormation pile existante est utilisé.
+ NodeGroupName

  Type : Chaîne

  Description : (Facultatif) Le nom de votre nouveau groupe de nœuds. Si vous ne spécifiez aucune valeur pour ce paramètre, le nom du groupe de nœuds spécifié dans votre CloudFormation pile existante est utilisé.
+ NodeAutoScalingGroupDesiredCapacity

  Type : Chaîne

  Description : (Facultatif) Le nombre de nœuds souhaité à atteindre lors de la création de votre nouvelle pile. Ce nombre doit être supérieur ou égal à la `NodeAutoScalingGroupMinSize` valeur et inférieur ou égal à`NodeAutoScalingGroupMaxSize`. Si vous ne spécifiez aucune valeur pour ce paramètre, la capacité souhaitée du groupe de nœuds spécifiée dans votre CloudFormation pile existante est utilisée.
+ NodeAutoScalingGroupMaxSize

  Type : Chaîne

  Description : (Facultatif) Le nombre maximum de nœuds que votre groupe de nœuds peut atteindre. Si vous ne spécifiez aucune valeur pour ce paramètre, la taille maximale du groupe de nœuds spécifiée dans votre CloudFormation pile existante est utilisée.
+ NodeAutoScalingGroupMinSize

  Type : Chaîne

  Description : (Facultatif) Le nombre minimum de nœuds que votre groupe de nœuds peut atteindre. Si vous ne spécifiez aucune valeur pour ce paramètre, la taille minimale du groupe de nœuds spécifiée dans votre CloudFormation pile existante est utilisée.
+ NodeImageId

  Type : Chaîne

  Description : (Facultatif) L'ID du Amazon Machine Image (AMI) que vous souhaitez que le groupe de nœuds utilise.
+ NodeImageIdSSMParam

  Type : Chaîne

  Description : (Facultatif) Le paramètre public de Systems Manager AMI que vous souhaitez que le groupe de nœuds utilise.
+ NodeVolumeSize

  Type : Chaîne

  Description : (Facultatif) Taille du volume racine de vos nœuds en GiB. Si vous ne spécifiez aucune valeur pour ce paramètre, la taille du volume du nœud spécifiée dans votre CloudFormation pile existante est utilisée.
+ NodeVolumeType

  Type : Chaîne

  Description : (Facultatif) Type de volume Amazon EBS que vous souhaitez utiliser pour le volume racine de vos nœuds. Si vous ne spécifiez aucune valeur pour ce paramètre, le type de volume spécifié dans votre CloudFormation pile existante est utilisé.
+ KeyName

  Type : Chaîne

  Description : (Facultatif) La paire de clés que vous souhaitez attribuer à vos nœuds. Si vous ne spécifiez aucune valeur pour ce paramètre, la paire de clés spécifiée dans votre CloudFormation pile existante est utilisée.
+ Subnets

  Type : StringList

  Description : (Facultatif) Liste séparée par des virgules des ID de sous-réseau que vous souhaitez utiliser pour votre nouveau groupe de nœuds. Si vous ne spécifiez aucune valeur pour ce paramètre, les sous-réseaux spécifiés dans votre CloudFormation pile existante sont utilisés.
+ Désactiver IMDS V1

  Type : Boolean

  Description : (Facultatif) Spécifiez `true` la désactivation du service de métadonnées d'instance version 1 (IMDSv1). Par défaut, les nœuds prennent en charge IMDSv1 et IMDSv2.
+ BootstrapArguments

  Type : Chaîne

  Description : (Facultatif) Arguments supplémentaires que vous souhaitez transmettre au script bootstrap du nœud.

**Autorisations IAM requises**

Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook.
+ `ssm:StartAutomationExecution`
+ `ssm:GetAutomationExecution`
+ `ssm:GetParameters`
+ `autoscaling:CreateAutoScalingGroup`
+ `autoscaling:CreateOrUpdateTags`
+ `autoscaling:DeleteTags`
+ `autoscaling:DescribeAutoScalingGroups`
+ `autoscaling:DescribeScalingActivities`
+ `autoscaling:DescribeScheduledActions`
+ `autoscaling:SetDesiredCapacity`
+ `autoscaling:TerminateInstanceInAutoScalingGroup`
+ `autoscaling:UpdateAutoScalingGroup`
+ `cloudformation:CreateStack`
+ `cloudformation:DescribeStackResource`
+ `cloudformation:DescribeStacks`
+ `cloudformation:UpdateStack`
+ `ec2:AuthorizeSecurityGroupEgress`
+ `ec2:AuthorizeSecurityGroupIngress`
+ `ec2:CreateLaunchTemplateVersion`
+ `ec2:CreateLaunchTemplate`
+ `ec2:CreateSecurityGroup`
+ `ec2:CreateTags`
+ `ec2:DeleteLaunchTemplate`
+ `ec2:DeleteSecurityGroup`
+ `ec2:DescribeAvailabilityZones`
+ `ec2:DescribeImages`
+ `ec2:DescribeInstanceAttribute`
+ `ec2:DescribeInstanceStatus`
+ `ec2:DescribeInstances`
+ `ec2:DescribeKeyPairs`
+ `ec2:DescribeLaunchTemplateVersions`
+ `ec2:DescribeLaunchTemplates`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeSubnets`
+ `ec2:DescribeVpcs`
+ `ec2:RevokeSecurityGroupEgress`
+ `ec2:RevokeSecurityGroupIngress`
+ `ec2:RunInstances`
+ `ec2:TerminateInstances`
+ `iam:AddRoleToInstanceProfile`
+ `iam:AttachRolePolicy`
+ `iam:CreateInstanceProfile`
+ `iam:CreateRole`
+ `iam:GetInstanceProfile`
+ `iam:GetRole`
+ `iam:PassRole`

 **Étapes de document** 
+ DetermineParameterValuesForNewNodeGroup (AWS:ExecuteScript) - Rassemble les valeurs des paramètres à utiliser pour le nouveau groupe de nœuds.
+ CreateStack (AWS:CreateStack) - Crée la CloudFormation pile pour le nouveau groupe de nœuds. 
+ GetNewStackNodeInstanceRole (aws:executeAwsApi) - Obtient le rôle d'instance du nœud. 
+ GetNewStackSecurityGroup (aws:executeAwsApi) - L'étape obtient le groupe de sécurité du nœud. 
+ AddIngressRulesToNewNodeSecurityGroup (aws:executeAwsApi) - Ajoute des règles d'entrée au groupe de sécurité nouvellement créé afin qu'il puisse accepter le trafic provenant de celui attribué à votre groupe de nœuds précédent. 
+ AddIngressRulesToOldNodeSecurityGroup (aws:executeAwsApi) - Ajoute des règles d'entrée au groupe de sécurité précédent afin qu'il puisse accepter le trafic provenant de celui attribué au groupe de nœuds que vous venez de créer. 
+ VerifyStackComplete (aws:assertAwsResourceProperty) - Vérifie que le nouveau statut de la pile est. `CREATE_COMPLETE` 

 **Sorties** 

DetermineParameterValuesForNewNodeGroup.NewStackParameters - Les paramètres utilisés pour créer la nouvelle pile.

GetNewStackNodeInstanceRole.NewNodeInstanceRole - Le rôle d'instance de nœud pour le nouveau groupe de nœuds.

GetNewStackSecurityGroup.NewNodeSecurityGroup - L'ID du groupe de sécurité pour le nouveau groupe de nœuds.

DetermineParameterValuesForNewNodeGroup.NewStackName - Le nom de la CloudFormation pile pour le nouveau groupe de nœuds.

CreateStack.StackId - L'ID de CloudFormation pile du nouveau groupe de nœuds.