View a markdown version of this page

AWSPremiumSupport-ExtendVolumesOnLinux - AWS Systems Manager Référence du dossier d’exploitation Automation

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

Description

Le AWSPremiumSupport-ExtendVolumesOnLinux 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 des opérations et états des volumes  : les modifications des volumes Amazon EBS se produisent en trois phases : modifyingoptimizing, etcompleted. Cette automatisation procède à l'extension du système de fichiers lorsque le volume atteint optimizing cet état. Au cours de l'optimizingé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ûts et limites  : l'augmentation de la taille d'un volume Amazon EBS entraînera une augmentation des coûts de stockage mensuels. Pour plus d'informations, consultez la tarification https://aws.amazon.com/ebs/pricing 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 souhaitez conserver le même ratio IOPS par Go après l'extension, vous devrez peut-être modifier les IOPS provisionnés. Les périphériques RAID et les volumes LVM ne sont pas pris en charge.

  • 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 la section 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 qu'elle exécute Linux

  • 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 qui ont été spécifiés pour l'extension

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

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 les AWS Support forfaits.

Exécutez cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

Linux

Paramètres

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:DescribeVolumesModifications

  • ec2:ModifyVolume

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

  • ssm:DescribeAutomationExecutions

  • ssm:GetAutomationExecution

Exemple de politique IAM :


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

Instructions

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

  1. Ouvrez AWSPremiumSupport-ExtendVolumesOnLinux dans le Gestionnaire de systèmes sous Documents.

  2. Choisissez Execute automation (Exécuter l’automatisation).

  3. Pour les paramètres d'entrée, entrez les informations suivantes :

    • AutomationAssumeRole (Facultatif) :

      • 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 démarre ce runbook.

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

    • InstanceId (Obligatoire) :

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

      • Type : String

      • Autoriser le schéma : ^i-[a-z0-9]{8,17}$

    • VolumeExpansionCapSize (Obligatoire) :

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

      • Type : String

      • Autoriser le schéma : ^[0-9]{1,4}$

    • DiagnosticResults (Obligatoire) :

      • Description : (Obligatoire) Les résultats du script de prévérifications du DiagnoseDiskUsage document, au format CSV d'une ligne. La chaîne commence par des informations EXTEND; 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'ID du volume, la partition, l'indicateur d'extension (1 pour étendre, 0 pour ignorer), la nouvelle taille en Go, AWS la région et Reason/Action.

      • Type : String

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

  4. Sélectionnez Execute (Exécuter).

  5. L'automatisation démarre.

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

    • AssertInstanceIsManagedInstance:

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

    • DescribeInstance:

      Récupère les Platform informations de l'instance Amazon EC2 cible.

    • BranchOnPlatform:

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

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

    • Étendez le volume de l'Ebs :

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

    • DescribeVolumes:

      Décrit les volumes Amazon EBS attachés à l'instance cible.

    • ExtendFilesystem:

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

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

Références

Systems Manager Automation