AWSPremiumSupport-ExtendVolumesOnWindows - 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-ExtendVolumesOnWindows

Description

Le AWSPremiumSupport-ExtendVolumesOnWindows runbook étend les volumes Amazon Elastic Block Store (Amazon EBS), leurs partitions et leurs systèmes de fichiers sur une instance Amazon Elastic Compute Cloud (Amazon EC2) cible.

Considérations importantes

  • Impact sur le fonctionnement et états du volume : les modifications du volume Amazon EBS se déroulent en trois phases : modifyingoptimizing, etcompleted. Cette automatisation se poursuit avec l'extension du système de fichiers lorsque le volume atteint optimizing cet état. Au cours de optimizing cet état, vous pouvez rencontrer un impact temporaire sur les performances et des perturbations potentielles au niveau du système de fichiers lors du redimensionnement de la partition. Vous pouvez suivre la progression des modifications des volumes Amazon EBS.

  • Coût et limites : l'augmentation de la taille d'un volume Amazon EBS entraîne une augmentation des coûts de stockage mensuels. Pour plus d'informations, consultez les tarifs Amazon EBS. L'AMI de sauvegarde et les instantanés associés créés par ce runbook entraîneront des frais supplémentaires en fonction de leur taille et de la durée pendant laquelle vous les conservez. Pour certains types de volumes, si vous devez conserver le même ratio d'IOPS par Go après l'extension, vous devrez peut-être modifier les IOPS provisionnées.

  • Sauvegarde et restauration : le runbook crée une AMI de sauvegarde avant d'apporter des modifications aux volumes. L'AMI et les instantanés associés ne sont pas automatiquement supprimés de votre compte. Vous devez supprimer manuellement ces sauvegardes si elles ne sont plus nécessaires. En cas de panne, les volumes peuvent être restaurés à partir des instantanés de l'AMI associée, comme décrit dans Remplacer un volume Amazon EBS à l'aide d'un instantané.

Fonctionnement

Ce runbook effectue les opérations suivantes :

  • Vérifie que l'instance cible est gérée par Systems Manager et exécute Windows Server

  • Garantit qu'il n'y a qu'une seule exécution de ce runbook ciblant l'instance Amazon EC2 actuelle

  • Crée une Amazon Machine Image (AMI) de sauvegarde à partir de l'instance cible

  • Étend les volumes Amazon EBS spécifiés pour l'extension

  • Étend les systèmes de fichiers de l'instance cible à l'aide de commandes PowerShell

Important

L'accès aux AWSPremiumSupport-* runbooks nécessite un abonnement Business + Support, Enterprise Support ou Unified Operations. Pour plus d'informations, consultez la section Comparer AWS Support les forfaits.

Exécuter cette automatisation (console)

Autorisations IAM requises

Le AutomationAssumeRole paramètre nécessite les actions suivantes pour utiliser correctement le runbook.

  • ec2:DescribeInstances

  • ec2:CreateImage

  • ec2:DescribeImages

  • ec2:DescribeVolumes

  • ec2:ModifyVolume

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

Exemple de politique IAM :


 {
     "Version": "2012-10-17",
     "Statement": [
         {
             "Effect": "Allow",
             "Action": [
                 "ec2:DescribeInstances",
                 "ec2:CreateImage",
                 "ec2:DescribeImages",
                 "ec2:DescribeVolumes",
                 "ec2:ModifyVolume",
                 "ssm:SendCommand",
                 "ssm:DescribeInstanceInformation",
                 "ssm:ListCommandInvocations"
             ],
             "Resource": "*"
         }
     ]
 }

Instructions

Pour configurer l'automatisation, procédez comme suit :

  1. Accédez AWSPremiumSupport-ExtendVolumesOnWindowsà Systems Manager sous Documents.

  2. Sélectionnez Execute automation (Exécuter l'automatisation).

  3. Pour les paramètres d'entrée, entrez ce qui suit :

    • AutomationAssumeRole (Facultatif) :

      • Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle 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.

      • Type : AWS::IAM::Role::Arn

    • InstanceId (Obligatoire) :

      • Description : (Obligatoire) ID de l'instance Amazon EC2.

      • Type : String

      • Autoriser le modèle : ^i-[0-9a-f]{8,17}$

    • VolumeExpansionCapSize (Obligatoire) :

      • Description : (Obligatoire) Taille maximale (en GiB) à laquelle les volumes Amazon EBS seront augmentés.

      • Type : String

      • Autoriser le modèle : ^[0-9]{1,4}$

    • DiagnosticResults (Obligatoire) :

      • Description : (Obligatoire) Les résultats du script de prévérifications provenant du DiagnoseDiskUsage document, au format CSV d'une ligne. La chaîne commence EXTEND; par des informations de volume séparées par des virgules pour chaque volume, les volumes étant séparés par des points-virgules. Les informations de chaque volume incluent : l'identifiant du volume, la lettre du lecteur, l'indicateur d'extension (1 pour étendre, 0 pour ignorer), la nouvelle taille en Go, AWS la région et le raison/l'action.

      • Type : String

      • Autoriser le modèle : ^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$

  4. Sélectionnez Exécuter.

  5. L'automatisation démarre.

  6. Le document exécute les étapes suivantes :

    • AssertInstanceIsManagedInstance:

      Vérifie que l'instance cible est gérée par Systems Manager.

    • DescribeInstance:

      Récupère les informations de plate-forme de l'instance Amazon EC2 cible.

    • BranchOnPlatform:

      Confirme que la plate-forme d'instance Amazon EC2 cible est Windows Server.

    • CheckConcurrency:

      Garantit qu'il n'y a qu'une seule exécution de ce runbook ciblant l'instance Amazon EC2 actuelle.

    • CreateImage:

      Crée une Amazon Machine Image (AMI) de sauvegarde à partir de l'instance cible.

    • WaitUntilImageReady:

      Attend que la création de l'Amazon Machine Image (AMI) soit terminée et atteigne l'availableétat requis.

    • Étendre EBSVolume :

      Étend les volumes Amazon EBS de l'instance cible spécifiés pour l'extension.

    • DescribeVolumes:

      Décrit les volumes Amazon EBS de l'instance cible qui ont été spécifiés pour l'extension.

    • ExtendFilesystem:

      Étend les systèmes de fichiers de l'instance cible à l'aide PowerShell de commandes.

  7. Une fois l'exécution terminée, consultez la section Sorties pour connaître les résultats détaillés de l'exécution.

Références

Systems Manager Automation