View a markdown version of this page

AWSPremiumSupport-ExtendVolumesOnWindows - AWS Systems Manager Riferimento al runbook dell’automazione

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 ai volumi di Amazon EBS avvengono in tre fasi:, e. modifying optimizing 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 l'avanzamento delle modifiche ai volumi di Amazon EBS.

  • Costi e limitazioni: l'aumento delle dimensioni di un volume di Amazon EBS comporterà costi di archiviazione 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 loro dimensioni e alla durata 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 dall'account. È necessario rimuovere manualmente questi backup se non sono più necessari. In caso di errore, i volumi possono essere ripristinati dalle istantanee dell'AMI associata come descritto in Sostituire un volume Amazon EBS utilizzando un'istantanea.

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 ci sia una sola esecuzione di questo runbook destinata all'istanza Amazon EC2 corrente

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

  • Estende i volumi Amazon EBS specificati per l'espansione

  • Estende i file system 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)

Tipo di documento

Automazione

Proprietario

Amazon

Piattaforme

Windows

Parametri

Autorizzazioni IAM richieste

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

  • ec2:DescribeInstances

  • ec2:CreateImage

  • ec2:DescribeImages

  • ec2:DescribeVolumes

  • ec2:DescribeVolumesModifications

  • ec2:ModifyVolume

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

  • ssm:DescribeAutomationExecutions

  • ssm:GetAutomationExecution

Policy IAM di esempio:


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

Istruzioni

Segui questi passaggi per configurare l'automazione:

  1. Accedi AWSPremiumSupport-ExtendVolumesOnWindows a Systems Manager in Documenti.

  2. Seleziona Execute automation (Esegui automazione).

  3. Per i parametri di input, inserisci 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

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

    • VolumeExpansionCapSize (Obbligatorio):

      • Descrizione: (Obbligatorio) Dimensione massima (in GiB) in cui verranno aumentati i volumi Amazon EBS.

      • Tipo: String

      • Schema di autorizzazione: ^[0-9]{1,4}$

    • DiagnosticResults (Obbligatorio):

      • Descrizione: (Obbligatorio) I risultati dello script di precheck del DiagnoseDiskUsage documento, formattato come CSV a riga singola. La stringa inizia con EXTEND; seguita da informazioni sul volume separate da virgole per ogni volume, con volumi separati da punto e virgola. Le informazioni di ogni volume includono: ID del volume, lettera di unità, flag di estensione (1 per estendere, 0 per saltare), Nuova dimensione in GB, area geografica e. AWS Reason/Action

      • Tipo: String

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

  4. Seleziona Esegui.

  5. L'automazione viene avviata.

  6. Il documento esegue i seguenti passaggi:

    • 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 istanza Amazon EC2 di destinazione è Windows Server.

    • CheckConcurrency:

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

    • CreateImage:

      Crea una 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 il volume EBS:

      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 file system dell'istanza di destinazione utilizzando comandi. PowerShell

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

Riferimenti

Systems Manager Automation