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. # `AWSPremiumSupport-ResizeNitroInstance` **Description** Le `AWSPremiumSupport-ResizeNitroInstance` runbook fournit une solution automatisée pour le redimensionnement des instances Amazon Elastic Compute Cloud (Amazon EC2) basées sur le système Nitro. Pour réduire le risque potentiel de perte de données et de temps d'arrêt, le runbook vérifie les points suivants : + Comportement d'arrêt de l'instance. + Si l'instance fait partie d'un groupe Amazon EC2 Auto Scaling et qu'elle est `standby` en mode. + État et location de l'instance. + Le type d'instance que vous souhaitez modifier prend en charge le nombre d'interfaces réseau actuellement attachées à votre instance. + L'architecture du processeur et le type de virtualisation pour le type d'instance actuel et le type d'instance cible sont identiques. + Si l'instance est en cours d'exécution, elle passe toutes les vérifications d'état. + Le type d'instance que vous souhaitez modifier est disponible dans la même zone de disponibilité. Si Amazon EC2 ne passe pas les vérifications de statut après avoir modifié le type d'instance, le runbook revient automatiquement au type d'instance précédent. Par défaut, ce runbook ne changera pas le type d'instance s'il est en cours d'exécution et si des volumes de stockage d'instance sont attachés. Le runbook ne modifiera pas non plus le type d'instance si l'instance fait partie d'une AWS CloudFormation pile. Si vous souhaitez modifier l'un de ces comportements, spécifiez `yes` les `AllowCloudFormationInstances` paramètres `AllowInstanceStoreInstances` et. Le runbook propose deux méthodes différentes pour spécifier le type d'instance que vous souhaitez remplacer : + Pour les automatisations simples ciblant une seule instance, spécifiez le type d'instance que vous souhaitez remplacer à l'aide du `TargetInstanceTypeFromParameter` paramètre. + Pour exécuter des automatisations à grande échelle afin de modifier le type d'instance de plusieurs instances, spécifiez le type d'instance à l'aide du `TargetInstanceTypeFromTagValue` paramètre. Pour plus d'informations sur l'exécution d'automatisations à grande échelle, voir [Exécuter des automatisations à](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-targets-and-rate-controls.html) grande échelle. Si vous ne spécifiez aucune valeur pour aucun des paramètres, l'automatisation échoue. **Important** L'accès aux `AWSPremiumSupport-*` runbooks nécessite un abonnement Business \$1 Support, Enterprise Support ou Unified Operations. Pour plus d'informations, voir [Comparer les AWS Support forfaits](https://aws.amazon.com/premiumsupport/plans/). **Considérations** + Nous vous recommandons de sauvegarder votre instance avant d'utiliser ce runbook. + Pour plus d'informations sur la compatibilité pour la modification du type d'instance, consultez la section [Compatibilité pour la modification du type d'instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/resize-limitations.html). + Si l'automatisation échoue et revient au type d'instance d'origine, voir [Résoudre les problèmes liés à la modification du type d'instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/troubleshoot-change-instance-type.html). + Pour modifier le type d'instance, le runbook doit arrêter votre instance. Lorsqu'une instance est arrêtée, toutes les données stockées en mémoire ou sur les volumes de stockage d'instance sont perdues. De plus, toutes les IPv4 adresses publiques attribuées automatiquement sont publiées. Pour plus d'informations sur ce qui se passe lorsque vous arrêtez une instance, consultez [Arrêter et démarrer votre instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html). + En utilisant `SkipInstancesWithTagKey` ce paramètre, vous pouvez ignorer les instances auxquelles une clé de balise Amazon EC2 spécifique est appliquée. [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-ResizeNitroInstance) **Type de document**  Automatisation **Propriétaire** Amazon **Plateformes** Linux, Windows **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. + Reconnaître Type : Chaîne Description : (Obligatoire) Entrez **yes** pour confirmer que votre instance sera arrêtée si elle est en cours d'exécution. + AllowInstanceStoreInstances Type : Chaîne Valeurs valides : non \$1 oui Par défaut : non Description : (Facultatif) Si vous le spécifiez`yes`, vous autorisez le runbook à s'exécuter sur des instances auxquelles des volumes de stockage d'instance sont attachés. + AllowCloudFormationInstances Type : Chaîne Valeurs valides : non \$1 oui Par défaut : non Description : (Facultatif) Si vous le spécifiez`yes`, le runbook s'exécute sur des instances faisant partie d'une CloudFormation pile. + DryRun Type : Chaîne Valeurs valides : non \$1 oui Par défaut : non Description : (Facultatif) Si vous le spécifiez`yes`, le runbook valide les exigences de redimensionnement sans modifier le type d'instance. + InstanceId Type : Chaîne Description : (Obligatoire) L'ID de l'instance Amazon EC2 dont vous souhaitez modifier le type. + SkipInstancesWithTagKey Type : Chaîne Description : (Facultatif) L'automatisation ignore une instance cible si la clé de balise que vous spécifiez est appliquée à l'instance. + SleepTime Type : Chaîne Valeur par défaut : 3 Description : (Facultatif) Le nombre de secondes pendant lesquelles ce runbook doit être mis en veille une fois terminé. + TagInstance Type : Chaîne Description : (Facultatif) Marquez les instances avec la clé et la valeur de votre choix en utilisant le format suivant :*Key=ChangingType,Value=True*. Cette option vous permet de suivre les instances ciblées par ce runbook. Les clés et les valeurs des balises distinguent les majuscules et minuscules. + TargetInstanceTypeFromParameter Type : Chaîne Description : (Facultatif) Le type d'instance auquel vous souhaitez remplacer votre instance. Laissez ce paramètre vide si vous souhaitez utiliser la valeur de la clé de balise fournie dans le `TargetInstanceTypeFromTagValue` paramètre. + TargetInstanceTypeFromTagValue Type : Chaîne Description : (Facultatif) La clé de balise appliquée à vos instances cibles dont la valeur contient le type d'instance que vous souhaitez modifier. Si vous spécifiez une valeur pour le `TargetInstanceTypeFromParameter` paramètre, elle remplace toute valeur que vous spécifiez pour ce paramètre. **Autorisations IAM requises** Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook. + `autoscaling:DescribeAutoScalingInstances` + `cloudformation:DescribeStackResources` + `ssm:GetAutomationExecution` + `ssm:DescribeAutomationExecutions` + `ec2:DescribeInstanceAttribute` + `ec2:DescribeInstances` + `ec2:DescribeInstanceStatus` + `ec2:DescribeInstanceTypeOfferings` + `ec2:DescribeInstanceTypes` + `ec2:DescribeTags` + `ec2:ModifyInstanceAttribute` + `ec2:StartInstances` + `ec2:StopInstances` **Étapes de document** 1. `aws:assertAwsResourceProperty`: garantit que l'instance Amazon EC2 n'est pas étiquetée avec la clé de balise de ressource spécifiée dans le `SkipInstancesWithTagKey` paramètre. Si la clé de balise est trouvée appliquée à l'instance, l'étape échoue et l'automatisation prend fin. 1. `aws:assertAwsResourceProperty`: confirme que le statut de l'instance Amazon EC2 cible est `running` `pending``stopped`, ou. `stopping` Dans le cas contraire, l'automatisation prend fin. 1. `aws:executeAwsApi`: rassemble les propriétés de l'instance Amazon EC2. 1. `aws:executeAwsApi`: rassemble des informations sur le type d'instance Amazon EC2 actuel. 1. `aws:branch`: Vérifie si le type d'instance actuel et le type d'instance spécifié dans le `TargetInstanceTypeFromParameter` paramètre sont identiques. Si tel est le cas, l'automatisation prend fin. 1. `aws:assertAwsResourceProperty`: garantit que l'instance fonctionne sur le système Nitro. 1. `aws:branch`: garantit que le type de volume racine de l'instance Amazon EC2 est un volume Amazon Elastic Block Store (Amazon EBS). 1. `aws:assertAwsResourceProperty`: confirme que le comportement d'arrêt de l'instance est `stop` ou non`terminate`. 1. `aws:branch`: garantit que l'instance Amazon EC2 n'est pas une instance Spot. 1. `aws:branch`: garantit que la location de l'instance Amazon EC2 est par défaut et non un hôte dédié ou une instance dédiée. 1. `aws:executeScript`: confirme qu'il n'existe qu'une seule automatisation de ce runbook ciblant l'ID d'instance actuel. Si une autre automatisation est déjà en cours ciblant la même instance, l'automatisation renvoie une erreur et se termine. 1. `aws:branch`: répartit l'automatisation en fonction de l'état de l'instance Amazon EC2. 1. Dans l'`stopped`affirmative`stopping`, l'automatisation s'exécute `aws:waitForAwsResourceProperty` jusqu'à ce que l'instance Amazon EC2 soit complètement arrêtée. 1. Dans l'`running`affirmative`pending`, l'automatisation s'exécute `aws:waitForAwsResourceProperty` jusqu'à ce que l'instance Amazon EC2 passe les vérifications de statut. 1. `aws:assertAwsResourceProperty`: confirme que l'instance Amazon EC2 ne fait pas partie d'un groupe Auto Scaling en appelant l'opération `DescribeAutoScalingInstances` API. Si l'instance fait partie d'un groupe Auto Scaling, assurez-vous que l'instance Amazon EC2 est en `standby` mode. 1. `aws:branch`: répartit l'automatisation selon que vous souhaitez que l'automatisation vérifie si l'instance Amazon EC2 fait partie d'une CloudFormation pile : 1. `aws:executeScript`Garantit que l'instance Amazon EC2 ne fait pas partie d'une CloudFormation pile en appelant l'opération d'`DescribeStackResources`API. 1. `aws:executeAwsApi`: renvoie une liste de types d'instances ayant le même type d'architecture de processeur, le même type de virtualisation et prenant en charge le nombre d'interfaces réseau actuellement attachées à l'instance cible. 1. `aws:executeAwsApi`: obtient la valeur du type d'instance cible à partir de la clé de balise spécifiée dans le `TargetInstanceTypeFromTagValue` paramètre. 1. `aws:executeScript`: confirme que les types d'instances actuels et cibles sont compatibles. Garantit que le type d'instance cible est disponible dans le même sous-réseau. Vérifie que le principal qui a lancé le runbook est autorisé à modifier le type d'instance et à arrêter et démarrer l'instance si elle était en cours d'exécution. 1. `aws:branch`: Branche l'automatisation selon que la valeur du `DryRun` paramètre est définie ou non sur`yes`. Si`yes`, l'automatisation prend fin. 1. `aws:branch`: Vérifie si le type d'instance d'origine et le type d'instance cible sont identiques. S'ils sont identiques, l'automatisation prend fin. 1. `aws:executeAwsApi`: obtient l'état actuel de l'instance. 1. `aws:changeInstanceState`: arrête l'instance Amazon EC2. 1. `aws:changeInstanceState`: force l'instance à s'arrêter si elle est bloquée dans son `stopping` état. 1. `aws:executeAwsApi`: remplace le type d'instance par le type d'instance cible. 1. `aws:sleep`: Attend 3 secondes après avoir changé le type d'instance pour une cohérence éventuelle. 1. `aws:branch`: répartit l'automatisation en fonction de l'état de l'instance précédent. Si c'est le cas`running`, l'instance est démarrée. 1. `aws:changeInstanceState`: démarre l'instance Amazon EC2 si elle était en cours d'exécution avant de modifier le type d'instance. 1. `aws:waitForAwsResourceProperty`: attend que l'instance Amazon EC2 passe les vérifications de statut. Si l'instance ne passe pas les vérifications de statut, le type d'instance d'origine est rétabli. 1. `aws:changeInstanceState`: arrête l'instance Amazon EC2 avant de lui redonner son type d'instance d'origine. 1. `aws:changeInstanceState`: force l'instance Amazon EC2 à s'arrêter avant de la remplacer par son type d'instance d'origine au cas où elle resterait bloquée dans un état d'arrêt. 1. `aws:executeAwsApi`: remplace le type d'origine de l'instance Amazon EC2. 1. `aws:sleep`: Attend 3 secondes après avoir changé le type d'instance pour une cohérence éventuelle. 1. `aws:changeInstanceState`: démarre l'instance Amazon EC2 si elle était en cours d'exécution avant de modifier le type d'instance. 1. `aws:waitForAwsResourceProperty`: attend que l'instance Amazon EC2 passe les vérifications de statut. 1. `aws:sleep`: Attend avant de terminer le runbook.