AWSPremiumSupport-ExtendVolumesOnWindows - AWS Systems Manager Riferimento all'Automation Runbook

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWSPremiumSupport-ExtendVolumesOnWindows

Descrizione

Il AWSPremiumSupport-ExtendVolumesOnWindows runbook estende i volumi Amazon Elastic Block Store (Amazon EBS), le relative partizioni e i file system su un'istanza Amazon Elastic Compute Cloud (Amazon EC2) di destinazione.

Considerazioni importanti

  • Impatto operativo e stati del volume: le modifiche al volume di Amazon EBS avvengono in tre fasi: modifyingoptimizing, e. completed Questa automazione procede con l'estensione del file system quando il volume raggiunge lo stato. optimizing Durante lo optimizing stato, è possibile che si verifichino un impatto temporaneo sulle prestazioni e potenziali interruzioni a livello di file system durante il ridimensionamento delle partizioni. Puoi monitorare lo stato di avanzamento delle modifiche ai volumi di Amazon EBS.

  • Costi e limitazioni: l'aumento delle dimensioni di un volume Amazon EBS comporterà costi di storage mensili più elevati. Per ulteriori informazioni, consulta i prezzi di Amazon EBS. L'AMI di backup e le istantanee associate create da questo runbook comporteranno costi aggiuntivi in base alle dimensioni e al periodo di tempo di conservazione. Per alcuni tipi di volume, se è necessario mantenere lo stesso rapporto IOPS per GB dopo l'espansione, potrebbe essere necessario modificare gli IOPS assegnati.

  • Backup e ripristino: il runbook crea un'AMI di backup prima di apportare modifiche ai volumi. L'AMI e le istantanee associate non vengono rimosse automaticamente dal tuo account. È necessario rimuovere manualmente questi backup se non sono più necessari. In caso di errore, i volumi possono essere recuperati dagli snapshot dell'AMI associata come descritto in Sostituire un volume Amazon EBS utilizzando uno snapshot.

Come funziona?

Questo runbook esegue le seguenti operazioni:

  • Verifica che l'istanza di destinazione sia gestita da Systems Manager e stia eseguendo Windows Server

  • Assicura che vi sia una sola esecuzione di questo runbook destinata all'istanza corrente di Amazon EC2

  • Crea un'Amazon Machine Image (AMI) di backup dall'istanza di destinazione

  • Estende i volumi Amazon EBS specificati per l'espansione

  • Estende i filesystem sull'istanza di destinazione utilizzando i comandi PowerShell

Importante

L'accesso ai AWSPremiumSupport-* runbook richiede un abbonamento Business + Support, Enterprise Support o Unified Operations. Per ulteriori informazioni, consulta Confronta Supporto AWS i piani.

Esegui questa automazione (console)

Autorizzazioni IAM richieste

Il AutomationAssumeRole parametro richiede le seguenti azioni per utilizzare correttamente il runbook.

  • ec2:DescribeInstances

  • ec2:CreateImage

  • ec2:DescribeImages

  • ec2:DescribeVolumes

  • ec2:ModifyVolume

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

Policy IAM di esempio:


 {
     "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": "*"
         }
     ]
 }

Istruzioni

Segui questi passaggi per configurare l'automazione:

  1. Accedere AWSPremiumSupport-ExtendVolumesOnWindowsa Systems Manager nella sezione Documenti.

  2. Seleziona Execute automation (Esegui automazione).

  3. Per i parametri di input, immettete quanto segue:

    • AutomationAssumeRole (Facoltativo):

      • Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo IAM che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.

      • Tipo: AWS::IAM::Role::Arn

    • InstanceId (Obbligatorio):

      • Descrizione: (obbligatorio) ID dell'istanza Amazon EC2.

      • Tipo: String

      • Pattern consentito: ^i-[0-9a-f]{8,17}$

    • VolumeExpansionCapSize (Obbligatorio):

      • Descrizione: (Obbligatorio) La dimensione massima (in GiB) dei volumi Amazon EBS verrà aumentata.

      • Tipo: String

      • Pattern consentito: ^[0-9]{1,4}$

    • DiagnosticResults (Obbligatorio):

      • Descrizione: (Obbligatorio) I risultati dello script di precontrollo DiagnoseDiskUsage contenuto nel documento, in formato CSV a una riga. La stringa inizia con EXTEND; seguita da informazioni sul volume separate da virgole per ogni volume, con i volumi separati da punto e virgola. Le informazioni di ogni volume includono: Volume ID, Drive letter, Extend flag (1 per estendere, 0 per ignorare), Nuova dimensione in GB, regione e Motivo/azione. AWS

      • Tipo: String

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

  4. Seleziona Esegui.

  5. L'automazione si avvia.

  6. Il documento esegue le seguenti operazioni:

    • AssertInstanceIsManagedInstance:

      Verifica che l'istanza di destinazione sia gestita da Systems Manager.

    • DescribeInstance:

      Recupera le informazioni sulla piattaforma dell'istanza Amazon EC2 di destinazione.

    • BranchOnPlatform:

      Conferma che la piattaforma di istanze Amazon EC2 di destinazione è Windows Server.

    • CheckConcurrency:

      Assicura che vi sia una sola esecuzione di questo runbook destinata all'istanza corrente di Amazon EC2.

    • CreateImage:

      Crea un'Amazon Machine Image (AMI) di backup dall'istanza di destinazione.

    • WaitUntilImageReady:

      Attende che Amazon Machine Image (AMI) completi la creazione e raggiunga lo available stato.

    • Estendi EBSVolume:

      Estende i volumi Amazon EBS dell'istanza di destinazione specificati per l'espansione.

    • DescribeVolumes:

      Descrive i volumi Amazon EBS dell'istanza di destinazione specificati per l'espansione.

    • ExtendFilesystem:

      Estende i filesystem dell'istanza di destinazione utilizzando i comandi. PowerShell

  7. Dopo il completamento, consulta la sezione Output per i risultati dettagliati dell'esecuzione.

Riferimenti

Systems Manager Automation