

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-ExtendVolumesOnLinux`
<a name="automation-awspremiumsupport-extendvolumesonlinux"></a>

 **Descrizione** 

Il `AWSPremiumSupport-ExtendVolumesOnLinux` 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. ](https://docs.aws.amazon.com/ebs/latest/userguide/monitoring-volume-modifications.html)
**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. ](https://aws.amazon.com/ebs/pricing) 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. I dispositivi RAID e i volumi LVM non sono supportati.
**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 recuperati dalle istantanee dell'AMI associata come descritto in [ Sostituire un volume Amazon EBS utilizzando un'istantanea. ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html)

 **Come funziona? ** 

Questo runbook esegue le seguenti operazioni:
+ Verifica che l'istanza di destinazione sia gestita da Systems Manager e stia eseguendo Linux
+ 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 comandi di shell script

**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. ](https://aws.amazon.com/premiumsupport/plans/)

 [Esegui questa automazione (console) ](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-ExtendVolumesOnLinux) 

**Tipo di documento **

Automazione

**Proprietario**

Amazon

**Piattaforme**

Linux

**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:ListCommandInvocations",
                 "ssm:DescribeInstanceInformation",
                 "ssm:DescribeAutomationExecutions",
                 "ssm:GetAutomationExecution"
             ],
             "Resource": "*"
         }
     ]
 }
```

 **Istruzioni** 

Segui questi passaggi per configurare l'automazione:

1. Apri [ AWSPremiumSupport-ExtendVolumesOnLinux ](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnLinux/description) in Systems Manager sotto Documenti.

1. Scegli **Esegui automazione**.

1. Per i parametri di input, inserisci quanto segue:
   + **AutomationAssumeRole (Facoltativo): **
     + Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (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-[a-z0-9]{8,17}$`
   + **VolumeExpansionCapSize (Obbligatorio): **
     + Descrizione: (Obbligatorio) Dimensione massima (in GiB) a 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, partizione, flag di estensione (1 per estendere, 0 per saltare), Nuova dimensione in GB, regione e. AWS Reason/Action
     + Tipo: `String`
     + Permetti modello: `^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$`

1. Scegli **Esegui**.

1. L'automazione viene avviata.

1. Il runbook esegue i seguenti passaggi:
   + **AssertInstanceIsManagedInstance**:

     Verifica che l'istanza di destinazione sia gestita da Systems Manager.
   + **DescribeInstance**:

     Recupera le `Platform` informazioni dell'istanza Amazon EC2 di destinazione.
   + **BranchOnPlatform**:

     Conferma che la piattaforma di istanze Amazon EC2 di destinazione è Linux.
   + **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 collegati all'istanza di destinazione.
   + **ExtendFilesystem**:

     Estende i file system dell'istanza di destinazione utilizzando comandi di shell script.

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

**Riferimenti**

Systems Manager Automation
+ [Esegui questa automazione (console) ](https://console.aws.amazon.com/systems-manager/documents/AWSPremiumSupport-ExtendVolumesOnLinux/description)
+ [Esegui un'automazione ](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-executing.html)
+ [Configurazione di un'automazione ](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-setup.html)
+ [Supporta i flussi di lavoro di automazione ](https://aws.amazon.com/premiumsupport/technology/saw/)
+ [Richiedi modifiche ai volumi di Amazon EBS ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/requesting-ebs-volume-modifications.html)