View a markdown version of this page

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

AWSSupport-CloneXenEC2InstanceAndMigrateToNitro

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 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 e i prezzi di Amazon EBS.

Importante

Prerequisiti

L'istanza Amazon EC2 di destinazione richiede l'accesso in uscita ai repository per installare driver e dipendenze comekernel-devel,,,,,, gccpatch, e unzip l'utilizzo del gestore di pacchetti rpm-build wget dracut makelinux-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)

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 a Systems Manager in Documenti.

  2. Seleziona Execute automation.

  3. 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 specifichiyes, 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

  4. Seleziona Esegui.

  5. L'automazione viene avviata.

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

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

Riferimenti

Automazione di AWS Systems Manager