AWSSupport-CloneXenEC2InstanceAndMigrateToNitro - AWS Systems Manager Riferimento all'Automation Runbook

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

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

Importante

Prerequisiti

L'istanza Amazon EC2 di destinazione richiede l'accesso in uscita ai repository per installare driver e dipendenze comekernel-devel,,,,,, gcc patchrpm-build, e unzip utilizzare il gestore di pacchetti 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 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)

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 AWSSupport-CloneXenEC2InstanceAndMigrateToNitroa Systems Manager nella sezione Documenti.

  2. Seleziona Execute automation.

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

  4. Seleziona Esegui.

  5. L'automazione viene avviata.

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

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

Riferimenti

Automazione di AWS Systems Manager