

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

[I **AWSSupport-CloneXenEC2 InstanceAndMigrateToNitro** runbook clonano, preparano e migrano l'istanza Linux clonata di Amazon Elastic Compute Cloud (Amazon EC2) Elastic Cloud (Amazon EC2), attualmente in esecuzione sulla piattaforma Amazon EC2 Xen, per l'esecuzione sulla piattaforma Amazon EC2 Nitro.](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 nel tipo Nitro desiderato.

**Importante**  
Prima di fornire l'approvazione per interrompere 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' IPv4 indirizzo pubblico automatico cambierà una volta arrestata e avviata l'istanza.

**Importante**  
**Avvertenza**: l'esecuzione di questo runbook può comportare costi aggiuntivi sul tuo account per l'istanza Amazon EC2, Amazon EBS Volumes & s. AMI Per ulteriori dettagli, consulta [i prezzi di Amazon EC2](https://aws.amazon.com/ec2/pricing/) e [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``rpm-build`, e `unzip` utilizzare il gestore di pacchetti `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 partizione)AWS 
+ SUSE12SP5 e SUSE15 SP (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 file AMI per garantire che la migrazione abbia esito positivo.
+ Abilita l'attributo Enhanced networking (ENA) e installa i driver ENA più recenti.
+ Verifica e configura il NVMe modulo in initramfs.
+ Analizza e modifica /etc/fstab per sostituire i nomi dei dispositivi con. UUIDs
+ Disattiva la denominazione prevedibile delle interfacce e rimuove le regole di rete persistenti.
+ Modifica il tipo di istanza clonata nel tipo Nitro desiderato.
+ Crea una versione finale AMI che può essere utilizzata come immagine dorata per il lancio di 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. Accedere [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CloneXenEC2InstanceAndMigrateToNitro/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CloneXenEC2InstanceAndMigrateToNitro/description)a Systems Manager nella sezione Documenti.

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

1. Per i parametri di input, immettete 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 istanza 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). Impostazione predefinita: m5.xlarge.
     + Tipo: `String`
     + Modello 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 (richiesto):**
     + Descrizione: (Obbligatorio) Fornisci l'ARN dell'argomento Amazon SNS per la notifica di approvazione. Questo argomento di Amazon SNS viene utilizzato per inviare notifiche di approvazione durante l'esecuzione dell'automazione.
     + Tipo: `String`
     + Modello 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}$`
   + **ApproverIam (obbligatorio):**
     + Descrizione: (Obbligatorio) Fornisci un elenco di responsabili AWS autenticati in grado di approvare o rifiutare l'azione. Il numero massimo di approvatori è 10.
     + Tipo: `StringList`
     + Modello 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 riconosco» se riconosci i passaggi.
     + Tipo: `String`
     + Modello consentito: `^Yes, I understand and acknowledge$`
   + **AllowInstanceStoreInstances (Facoltativo):**
     + Descrizione: (Facoltativo) Se si specifica`yes`, il runbook viene eseguito su istanze a cui sono collegati volumi di Instance Store. **Avviso:** i dati nei volumi dell'Instance Store 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 le seguenti operazioni:
   + **`checkConcurrency`**:

     Assicura che vi sia una sola esecuzione di questo runbook destinata all'istanza corrente di Amazon EC2.
   + **`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 AMI test utilizzando la stessa configurazione dell'istanza Amazon EC2 di destinazione.
   + **`approvalToStopTargetInstance`**:

     Attende l'approvazione dei responsabili 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 AMI backup 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 mancano.
   + **`checkAndAddNVMEDrivers`**:

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

     Determina se il nome del dispositivo viene utilizzato `/etc/fstab` e lo sostituisce con il nome corrispondente, se trovato. UUIDs
   + **`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 si avvia 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)
+ [Flussi di lavoro di Support Automation](https://aws.amazon.com/premiumsupport/technology/saw/)