AWSSupport-CloneXenEC2InstanceAndMigrateToNitro - AWS Systems Manager Referencia del manual de automatización

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWSSupport-CloneXenEC2InstanceAndMigrateToNitro

Descripción

El AWSSupport-CloneXenEC2 InstanceAndMigrateToNitro runbook clona, prepara y migra la instancia Linux clonada de Amazon Elastic Compute Cloud (Amazon EC2) (Amazon EC2) Linux, que actualmente se ejecuta en la plataforma Amazon EC2 Xen, para que se ejecute en la plataforma Amazon EC2 Nitro. Esta automatización se divide en tres ramas diferentes:

  • Comprobaciones preliminares: evalúa todos los requisitos previos para continuar con la migración, incluida la comprobación de si la instancia Amazon EC2 de destino ya se está ejecutando en la plataforma Nitro, la determinación del estado del ciclo de vida, la validación del sistema operativo y la verificación de la conectividad de Systems Manager.

  • Prueba: crea una prueba AMI a partir de la instancia Amazon EC2 de destino y lanza una instancia Amazon EC2 de prueba para validar el proceso de migración antes de continuar.

  • CloneAndMigrate: crea un clon de la instancia Amazon EC2 de destino, instala los controladores necesarios, configura el sistema para la plataforma Nitro y cambia el tipo de instancia por el tipo Nitro deseado.

importante

Antes de conceder la aprobación para detener la instancia Amazon EC2 de destino, asegúrese de que todas las aplicaciones que se ejecutan en la instancia estén cerradas correctamente. Si la instancia Amazon EC2 no tiene una dirección IP elástica asociada, la IPv4 dirección pública automática cambiará una vez que la instancia se detenga e inicie.

importante

Descargo de responsabilidad: la ejecución de este runbook puede implicar cargos adicionales en su cuenta para la instancia de Amazon EC2, Amazon EBS Volumes & s. AMI Consulte los precios de Amazon EC2 y Amazon EBS para obtener más información.

importante

Requisitos previos

La instancia Amazon EC2 de destino requiere acceso saliente a los repositorios para instalar controladores y dependencias comokernel-devel,,,,,,, gcc patch rpm-build wget dracut makelinux-headers, y unzip usar un administrador de paquetes si es necesario.

Sistemas operativos compatibles

  • Red Hat Enterprise Linux (RHEL) 8 y 9

  • Amazon Linux 2 y AL2023

  • Ubuntu Server 18.04 LTS, 20.04 y 22.04

  • Debian 11 y 12 (solo particiones)AWS

  • SUSE12SP5 y SUSE15 SP (5,6)

¿Cómo funciona?

El manual de instrucciones realiza los siguientes pasos de alto nivel:

  • Valida los requisitos previos y comprueba si la instancia es adecuada para la migración.

  • Crea y prueba una AMI para garantizar que la migración se realice correctamente.

  • Activa el atributo de red mejorada (ENA) e instala los controladores ENA más recientes.

  • Verifica y configura el NVMe módulo en initramfs.

  • Analiza y modifica /etc/fstab para reemplazar los nombres de los dispositivos por. UUIDs

  • Desactiva los nombres predecibles de las interfaces y elimina las reglas de red persistentes.

  • Cambia el tipo de instancia clonada al tipo Nitro deseado.

  • Crea una imagen final AMI que se puede usar como imagen dorada para lanzar instancias de Nitro.

Ejecuta esta automatización (consola)

Tipo de documento

Automatización

Propietario

Amazon

Plataformas

Linux

Parámetros

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

  • 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

Política de IAM de ejemplo:


{
    "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": "*"
        }
    ]
}

Instrucciones

Siga estos pasos para configurar la automatización:

  1. Navegue hasta AWSSupport-CloneXenEC2InstanceAndMigrateToNitroSystems Manager, en Documentos.

  2. Seleccione Execute automation.

  3. Para los parámetros de entrada, introduzca lo siguiente:

    • AutomationAssumeRole (Opcional):

      • Descripción: (opcional) El ARN del rol AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.

      • Tipo: AWS::IAM::Role::Arn

    • TargetInstanceId (Obligatorio):

      • Descripción: (obligatorio) ID de instancia de la instancia Amazon EC2 de destino que desea migrar a la plataforma Nitro.

      • Tipo: AWS::EC2::Instance::Id

    • NitroInstanceType (Opcional):

      • Descripción: (opcional) Introduzca el tipo de instancia de Nitro de destino. Solo se admiten las instancias Nitro M5, M6, C5, R5, R6 y T3 (por ejemplo, t3.small). Predeterminado: m5.xlarge.

      • Tipo: String

      • Valor permitido: ^(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)$

      • Valor predeterminado: m5.xlarge

    • SNSTopicArn (obligatorio):

      • Descripción: (Obligatorio) Proporcione el ARN del tema de Amazon SNS para la notificación de aprobación. Este tema de Amazon SNS se utiliza para enviar notificaciones de aprobación durante la ejecución de la automatización.

      • Tipo: String

      • Valor permitido: ^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}$

    • ID de aprobación (obligatorio):

      • Descripción: (obligatorio) Proporcione una lista de los directores AWS autenticados que puedan aprobar o rechazar la acción. El número máximo de aprobadores es 10.

      • Tipo: StringList

      • Valor permitido: ^[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 (Opcional):

      • Descripción: (opcional) El número mínimo de aprobaciones necesarias para reanudar la automatización. Valor predeterminado: 1.

      • Tipo: entero

      • Valor predeterminado: 1

    • DeleteResourcesOnFailure (Opcional):

      • Descripción: (opcional) Si se debe terminar la instancia de Amazon EC2 clonada AMI y si se produce un error en la automatización.

      • Tipo: Boolean

      • Valores permitidos: [true, false]

      • Valor predeterminado: true

    • Reconocimiento (obligatorio):

      • Descripción: (Obligatorio) Lee todos los detalles de las acciones que se llevan a cabo en este manual de automatización y escribe «Sí, entiendo y reconozco» si aceptas los pasos.

      • Tipo: String

      • Valor permitido: ^Yes, I understand and acknowledge$

    • AllowInstanceStoreInstances (Opcional):

      • Descripción: (opcional) si especifica yes, el manual de procedimientos se ejecuta en instancias que tienen volúmenes de almacén de instancias adjuntos. Advertencia: los datos de los volúmenes del almacén de instancias se pierden cuando la instancia se detiene. Este parámetro ayuda a evitar la pérdida accidental de datos.

      • Tipo: Boolean

      • Valores permitidos: [yes, no]

      • Valor predeterminado: no

  4. Seleccione Ejecutar.

  5. Se inicia la automatización.

  6. Este documento realiza los siguientes pasos:

    • checkConcurrency:

      Garantiza que solo haya una ejecución de este runbook dirigida a la instancia actual de Amazon EC2.

    • getTargetInstanceProperties:

      Obtiene los detalles de la instancia Amazon EC2 de destino.

    • checkIfNitroInstanceTypeIsSupportedInAZ:

      Determina si el tipo de instancia de Nitro de destino se admite en la misma zona de disponibilidad que la instancia de Amazon EC2 de destino.

    • createTestImage:

      Crea una prueba a AMI partir de la instancia proporcionada.

    • launchTestInstanceInSameSubnet:

      Lanza una instancia Amazon EC2 de prueba a partir de la prueba AMI con la misma configuración que la instancia Amazon EC2 de destino.

    • approvalToStopTargetInstance:

      Espera la aprobación de los directores designados para detener la instancia de destino.

    • createBackupImage:

      Crea una copia AMI de seguridad a partir de la instancia proporcionada.

    • launchInstanceInSameSubnet:

      Lanza una nueva instancia de Amazon EC2 desde la copia de seguridad AMI con la misma configuración que la instancia Amazon EC2 de origen.

    • checkAndInstallENADrivers:

      Determina la disponibilidad de los controladores del adaptador de red mejorado (ENA) en la instancia de Amazon EC2 y los instala si faltan.

    • checkAndAddNVMEDrivers:

      Determina la disponibilidad de los controladores NVMe en la instancia de Amazon EC2 clonada y los instala, si faltan.

    • checkAndModifyFSTABEntries:

      Determina si el nombre del dispositivo se utiliza /etc/fstab y, si lo encuentra, lo reemplaza por el suyo UUIDs.

    • setNitroInstanceTypeForClonedInstance:

      Establece el tipo de instancia Amazon EC2 de destino proporcionado para la instancia de Amazon EC2 clonada.

    • approvalForCreatingImageAfterDriversInstallation:

      Espera la aprobación del usuario si la instancia clonada de Amazon EC2 se inicia correctamente en la plataforma Nitro.

    • createImageAfterDriversInstallation:

      Crea una imagen desde la nueva instancia de Amazon EC2 solo si la nueva instancia de Amazon EC2 se inicia correctamente en la plataforma Nitro.

  7. Una vez finalizada, consulte la sección de resultados para ver los resultados detallados de la ejecución.

Referencias

AWS Systems Manager Automation