AWSPremiumSupport-ResizeNitroInstance - AWS Systems Manager Référence du manuel d'automatisation

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 à 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 + Support, Enterprise Support ou Unified Operations. Pour plus d'informations, voir Comparer les AWS Support forfaits.

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.

  • 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.

  • 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.

  • 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)

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 | oui

    Par défaut : non

    Description : (Facultatif) Si vous le spécifiezyes, 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 | oui

    Par défaut : non

    Description : (Facultatif) Si vous le spécifiezyes, le runbook s'exécute sur des instances faisant partie d'une CloudFormation pile.

  • DryRun

    Type : Chaîne

    Valeurs valides : non | oui

    Par défaut : non

    Description : (Facultatif) Si vous le spécifiezyes, 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.

  2. aws:assertAwsResourceProperty: confirme que le statut de l'instance Amazon EC2 cible est running pendingstopped, ou. stopping Dans le cas contraire, l'automatisation prend fin.

  3. aws:executeAwsApi: rassemble les propriétés de l'instance Amazon EC2.

  4. aws:executeAwsApi: rassemble des informations sur le type d'instance Amazon EC2 actuel.

  5. 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.

  6. aws:assertAwsResourceProperty: garantit que l'instance fonctionne sur le système Nitro.

  7. aws:branch: garantit que le type de volume racine de l'instance Amazon EC2 est un volume Amazon Elastic Block Store (Amazon EBS).

  8. aws:assertAwsResourceProperty: confirme que le comportement d'arrêt de l'instance est stop ou nonterminate.

  9. aws:branch: garantit que l'instance Amazon EC2 n'est pas une instance Spot.

  10. 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.

  11. 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.

  12. aws:branch: répartit l'automatisation en fonction de l'état de l'instance Amazon EC2.

    1. Dans l'stoppedaffirmativestopping, l'automatisation s'exécute aws:waitForAwsResourceProperty jusqu'à ce que l'instance Amazon EC2 soit complètement arrêtée.

    2. Dans l'runningaffirmativepending, l'automatisation s'exécute aws:waitForAwsResourceProperty jusqu'à ce que l'instance Amazon EC2 passe les vérifications de statut.

  13. 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.

  14. 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:executeScriptGarantit que l'instance Amazon EC2 ne fait pas partie d'une CloudFormation pile en appelant l'opération d'DescribeStackResourcesAPI.

  15. 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.

  16. aws:executeAwsApi: obtient la valeur du type d'instance cible à partir de la clé de balise spécifiée dans le TargetInstanceTypeFromTagValue paramètre.

  17. 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.

  18. aws:branch: Branche l'automatisation selon que la valeur du DryRun paramètre est définie ou non suryes. Siyes, l'automatisation prend fin.

  19. 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.

  20. aws:executeAwsApi: obtient l'état actuel de l'instance.

  21. aws:changeInstanceState: arrête l'instance Amazon EC2.

  22. aws:changeInstanceState: force l'instance à s'arrêter si elle est bloquée dans son stopping état.

  23. aws:executeAwsApi: remplace le type d'instance par le type d'instance cible.

  24. aws:sleep: Attend 3 secondes après avoir changé le type d'instance pour une cohérence éventuelle.

  25. aws:branch: répartit l'automatisation en fonction de l'état de l'instance précédent. Si c'est le casrunning, 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.

    2. 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.

      2. 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.

      3. aws:executeAwsApi: remplace le type d'origine de l'instance Amazon EC2.

      4. aws:sleep: Attend 3 secondes après avoir changé le type d'instance pour une cohérence éventuelle.

      5. aws:changeInstanceState: démarre l'instance Amazon EC2 si elle était en cours d'exécution avant de modifier le type d'instance.

      6. aws:waitForAwsResourceProperty: attend que l'instance Amazon EC2 passe les vérifications de statut.

  26. aws:sleep: Attend avant de terminer le runbook.