

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à.

# `AWSSupport-CloneXenEC2InstanceAndMigrateToNitro`
<a name="automation-awssupport-clonexenec2instanceandmigratetonitro"></a>

 **Descrizione** 

Il ** AWSSupport-CloneXenEC2InstanceAndMigrateToNitro ** runbook clona, prepara e migra l'istanza Linux Amazon Elastic Compute Cloud (Amazon EC2) clonata, attualmente in esecuzione sulla piattaforma Amazon EC2 Xen, per eseguirla sulla piattaforma Amazon EC2 Nitro. [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances) Questa automazione è suddivisa in tre diversi rami:
+ **Controlli preliminari**: valuta tutti i prerequisiti per procedere con la migrazione, incluso il controllo se l'istanza Amazon EC2 di destinazione è già in esecuzione sulla piattaforma Nitro, la determinazione dello stato del ciclo di vita, la convalida del sistema operativo e la verifica della connettività di Systems Manager.
+ **Test**: crea un test AMI dall'istanza Amazon EC2 di destinazione e avvia un'istanza Amazon EC2 di test per convalidare il processo di migrazione prima di procedere.
+ **CloneAndMigrate**: crea un clone dell'istanza Amazon EC2 di destinazione, installa i driver necessari, configura il sistema per la piattaforma Nitro e modifica il tipo di istanza con il tipo Nitro desiderato.

**Importante**  
Prima di fornire l'approvazione per arrestare l'istanza Amazon EC2 di destinazione, assicurati che tutte le applicazioni in esecuzione sull'istanza siano chiuse correttamente. Se all'istanza Amazon EC2 non è associato un indirizzo IP elastico, l'indirizzo IPv4 pubblico automatico cambierà una volta arrestata e avviata l'istanza.

**Importante**  
**Dichiarazione di non responsabilità**: l'esecuzione di questo runbook può comportare costi aggiuntivi sul tuo account per l'istanza Amazon EC2, Amazon EBS Volumes & s. AMI Per maggiori dettagli, consulta i prezzi di [ Amazon EC2 ](https://aws.amazon.com/ec2/pricing/) e [ i prezzi di Amazon EBS. ](https://aws.amazon.com/ebs/pricing/)

**Importante**  
 **Prerequisiti**   
L'istanza Amazon EC2 di destinazione richiede l'accesso in uscita ai repository per installare driver e dipendenze come`kernel-devel`,,,,,, `gcc``patch`, e `unzip` l'utilizzo del gestore di pacchetti `rpm-build` `wget` `dracut` `make``linux-headers`, se necessario.

 **Sistemi operativi supportati** 
+ Red Hat Enterprise Linux (RHEL) 8 e 9
+ Amazon Linux 2 e AL2023
+ Ubuntu Server 18.04 LTS, 20.04 e 22.04
+ Debian 11 e 12 (solo partizioni)AWS 
+ SUSE12SP5 e SUSE15SP (5,6)

 **Come funziona? ** 

Il runbook esegue i seguenti passaggi di alto livello:
+ Convalida i prerequisiti e verifica se l'istanza è adatta alla migrazione.
+ Crea e verifica un documento AMI per garantire che la migrazione abbia esito positivo.
+ Abilita l'attributo ENA (Enhanced networking) e installa i driver ENA più recenti.
+ Verifica e configura il modulo NVMe in initramfs.
+ Analizza e modifica/per sostituire i nomi dei dispositivi con gli UUID. etc/fstab 
+ Disabilita la denominazione prevedibile delle interfacce e rimuove le regole di rete persistenti.
+ Cambia il tipo di istanza clonata nel tipo Nitro desiderato.
+ Crea una finale AMI che può essere utilizzata come Golden Image per avviare le istanze Nitro.

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

**Tipo di documento **

Automazione

**Proprietario**

Amazon

**Piattaforme**

Linux

**Parametri**

**Autorizzazioni IAM richieste **

Il `AutomationAssumeRole` parametro richiede le seguenti azioni per utilizzare correttamente il runbook.
+ `autoscaling:DescribeAutoScalingInstances`
+ `ec2:CreateImage`
+ `ec2:CreateTags`
+ `ec2:DescribeImages`
+ `ec2:DescribeInstanceAttribute`
+ `ec2:DescribeInstances`
+ `ec2:DescribeInstanceStatus`
+ `ec2:DescribeInstanceTypeOfferings`
+ `ec2:DescribeInstanceTypes`
+ `ec2:DeregisterImage`
+ `ec2:ModifyInstanceAttribute`
+ `ec2:RunInstances`
+ `ec2:StartInstances`
+ `ec2:StopInstances`
+ `ec2:TerminateInstances`
+ `iam:PassRole`
+ `sns:Publish`
+ `ssm:DescribeAutomationExecutions`
+ `ssm:DescribeInstanceInformation`
+ `ssm:SendCommand`

Policy IAM di esempio:

```
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "autoscaling:DescribeAutoScalingInstances",
                "ec2:CreateImage",
                "ec2:CreateTags",
                "ec2:DescribeImages",
                :ec2:DescribeInstanceAttribute:,
                "ec2:DescribeInstances",
                "ec2:DescribeInstanceStatus",
                "ec2:DescribeInstanceTypes",
                "ec2:DeregisterImage",
                "ec2:ModifyInstanceAttribute",
                "ec2:RunInstances",
                "ec2:StartInstances",
                "ec2:StopInstances",
                "ec2:TerminateInstances",
                "iam:PassRole",
                "ssm:DescribeAutomationExecutions",
                "ssm:DescribeInstanceInformation",
                "ssm:SendCommand"
            ],
            "Resource": "*"
        }
    ]
}
```

 **Istruzioni** 

Segui questi passaggi per configurare l'automazione:

1. Accedi [`AWSSupport-CloneXenEC2InstanceAndMigrateToNitro`](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CloneXenEC2InstanceAndMigrateToNitro/description) a Systems Manager in Documenti.

1. Seleziona **`Execute automation`**.

1. Per i parametri di input, inserisci quanto segue:
   + **AutomationAssumeRole (Facoltativo): **
     + Descrizione: (Facoltativo) L'ARN del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per conto dell'utente. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.
     + Tipo: `AWS::IAM::Role::Arn`
   + **TargetInstanceId (Obbligatorio): **
     + Descrizione: (obbligatorio) ID dell'istanza Amazon EC2 di destinazione che desideri migrare sulla piattaforma Nitro.
     + Tipo: `AWS::EC2::Instance::Id`
   + **NitroInstanceType (Facoltativo): **
     + Descrizione: (Facoltativo) Inserisci il tipo di istanza Nitro di destinazione. Sono supportate solo le istanze Nitro M5, M6, C5, C6, R5, R6 e T3 (ad esempio t3.small). Predefinito: m5.xlarge.
     + Tipo: `String`
     + Schema consentito: `^(m5a?z?d?n?|c5a?d?n?|r5a?d?n?b?|(c|m|r)6(a|i)?d?)\\.(2|4|8|12|16|24|32)?xlarge$|^t3a?\\.((x|2x)?large|nano|micro|small|medium)$`
     + Impostazione predefinita: `m5.xlarge`
   + **SNSTopicArn (Obbligatorio): **
     + Descrizione: (Obbligatorio) Fornisci l'ARN dell'argomento Amazon SNS per la notifica di approvazione. Questo argomento Amazon SNS viene utilizzato per inviare notifiche di approvazione durante l'esecuzione dell'automazione.
     + Tipo: `String`
     + Schema consentito: `^arn:(aws|aws-cn|aws-us-gov|aws-iso(-[a-z])?):sns:(us(-gov|-isob?)?|ap|ca|af|me|cn|eu|sa)-(central|(north|south)?(east|west)?)-\\d:\\d{12}:[a-zA-Z0-9_.-]{1,256}$`
   + **Approvazione IAM (obbligatorio): **
     + Descrizione: (Obbligatorio) Fornisci un elenco di committenti AWS autenticati in grado di approvare o rifiutare l'azione. Il numero massimo di approvatori è 10.
     + Tipo: `StringList`
     + Schema consentito: `^[a-zA-Z0-9_+=,.@\\-\/]{1,128}$|^arn:(aws|aws-cn|aws-us-gov|aws-iso(-[a-z])?):(sts|iam)::[0-9]{12}:[a-zA-Z0-9_+=,.@\\-\/]{1,256}$`
   + **MinimumRequiredApprovals (Facoltativo): **
     + Descrizione: (Facoltativo) Il numero minimo di approvazioni richieste per riprendere l'automazione. Default: 1.
     + Tipo: numero intero
     + Impostazione predefinita: 1
   + **DeleteResourcesOnFailure (Facoltativo): **
     + Descrizione: (Facoltativo) Se terminare l'istanza Amazon EC2 clonata e AMI se l'automazione fallisce.
     + Tipo: `Boolean`
     + Valori consentiti: `[true, false]`
     + Impostazione predefinita: `true`
   + **Riconoscimento (obbligatorio): **
     + Descrizione: (Obbligatorio) Leggi i dettagli completi delle azioni eseguite da questo runbook di automazione e scrivi «Sì, ho capito e confermo» se confermi i passaggi.
     + Tipo: `String`
     + Schema consentito: `^Yes, I understand and acknowledge$`
   + **AllowInstanceStoreInstances (Facoltativo): **
     + Descrizione: (Facoltativo) Se specifichi`yes`, il runbook viene eseguito su istanze a cui sono collegati volumi di Instance Store. **Avviso: ** i dati contenuti nei volumi dell'istanza vengono persi quando l'istanza viene interrotta. Questo parametro aiuta a evitare la perdita accidentale di dati.
     + Tipo: `Boolean`
     + Valori consentiti: `[yes, no]`
     + Impostazione predefinita: `no`

1. Seleziona **Esegui**.

1. L'automazione viene avviata.

1. Il documento esegue i seguenti passaggi:
   + **`checkConcurrency`**:

     Assicura che ci sia una sola esecuzione di questo runbook destinata all'istanza Amazon EC2 corrente.
   + **`getTargetInstanceProperties`**:

     Recupera i dettagli dell'istanza Amazon EC2 di destinazione.
   + **`checkIfNitroInstanceTypeIsSupportedInAZ`**:

     Determina se il tipo di istanza Nitro di destinazione è supportato nella stessa zona di disponibilità dell'istanza Amazon EC2 di destinazione.
   + **`createTestImage`**:

     Crea un test AMI dall'istanza fornita.
   + **`launchTestInstanceInSameSubnet`**:

     Avvia un'istanza Amazon EC2 di prova dal test AMI utilizzando la stessa configurazione dell'istanza Amazon EC2 di destinazione.
   + **`approvalToStopTargetInstance`**:

     Attende l'approvazione dei principali designati per interrompere l'istanza di destinazione.
   + **`createBackupImage`**:

     Crea un file AMI dall'istanza fornita per il backup.
   + **`launchInstanceInSameSubnet`**:

     Avvia una nuova istanza Amazon EC2 dal backup AMI utilizzando la stessa configurazione dell'istanza Amazon EC2 di origine.
   + **`checkAndInstallENADrivers`**:

     Determina la disponibilità dei driver Enhanced Networking Adapter (ENA) sull'istanza Amazon EC2 e li installa, se mancanti.
   + **`checkAndAddNVMEDrivers`**:

     Determina la disponibilità dei driver NVMe sull'istanza Amazon EC2 clonata e li installa, se mancanti.
   + **`checkAndModifyFSTABEntries`**:

     Determina se i nomi dei dispositivi sono utilizzati `/etc/fstab` e li sostituisce con i relativi UUID, se presenti.
   + **`setNitroInstanceTypeForClonedInstance`**:

     Imposta il tipo di istanza Amazon EC2 di destinazione fornito per l'istanza Amazon EC2 clonata.
   + **`approvalForCreatingImageAfterDriversInstallation`**:

     Attende l'approvazione dell'utente se l'istanza Amazon EC2 clonata viene avviata correttamente sulla piattaforma Nitro.
   + **`createImageAfterDriversInstallation`**:

     Crea un'immagine dalla nuova istanza Amazon EC2 solo se la nuova istanza Amazon EC2 si avvia correttamente sulla piattaforma Nitro.

1. Al termine, consulta la ** sezione ** Output per i risultati dettagliati dell'esecuzione.

**Riferimenti**

Automazione di AWS Systems Manager 
+ [Esegui questa automazione (console) ](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CloneXenEC2InstanceAndMigrateToNitro/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/)