View a markdown version of this page

AWSSupport-CloneXenEC2InstanceAndMigrateToNitro - AWS Systems Manager Referencia del manual de procedimientos 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-CloneXenEC2InstanceAndMigrateToNitro runbook clona, prepara y migra la instancia Linux clonada de Amazon Elastic Compute Cloud (Amazon EC2), que actualmente se ejecuta en la plataforma Amazon EC2 Xen, para ejecutarla en la plataforma Amazon EC2 Nitro. https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances 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 aprobar la detención de 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 asociada una dirección IP elástica, la dirección IPv4 pública automática cambiará una vez que la instancia se detenga e inicie.

importante

Descargo de responsabilidad: la ejecución de este manual de operaciones puede generar cargos adicionales en su cuenta por la instancia Amazon EC2, Amazon EBS Volumes & s. AMI Consulte los precios de Amazon EC2 y los precios de 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 dependenciaskernel-devel, como,,,,,,,,,,, gccpatch, y unzip utilizar el administrador de paquetes rpm-build wget dracut makelinux-headers, 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 SUSE15SP (5,6)

¿Cómo funciona?

El runbook 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 un AMI para garantizar que la migración se realice correctamente.

  • Activa el atributo Enhanced Networking (ENA) e instala los controladores ENA más recientes.

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

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

  • Deshabilita la nomenclatura predecible de las interfaces y elimina las reglas de red persistentes.

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

  • Crea una 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 el Administrador de sistemas, AWSSupport-CloneXenEC2InstanceAndMigrateToNitro en la sección 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 M5, M6, C5, C6, R5, R6 y T3 de Nitro (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}$

    • Aprobador IAM (obligatorio):

      • Descripción: (Obligatorio) Proporcione una lista de los directores AWS autenticados que pueden 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 necesario para reanudar la automatización. Valor predeterminado: 1.

      • Tipo: entero

      • Valor predeterminado: 1

    • DeleteResourcesOnFailure (Opcional):

      • Descripción: (opcional) Indica si se debe terminar la instancia clonada de Amazon EC2 y AMI si la automatización falla.

      • Tipo: Boolean

      • Valores permitidos: [true, false]

      • Valor predeterminado: true

    • Reconocimiento (obligatorio):

      • Descripción: (Obligatorio) Lea todos los detalles de las acciones realizadas en este manual de automatización y escriba «Sí, entiendo y reconozco» si acepta 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 se detiene la instancia. 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 Nitro de destino es compatible en la misma zona de disponibilidad que la instancia 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 AMI a partir de la instancia proporcionada para realizar una copia de seguridad.

    • launchInstanceInSameSubnet:

      Lanza una nueva instancia de Amazon EC2 a partir de la copia de seguridad AMI con la misma configuración que la instancia de 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 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 sus UUID.

    • setNitroInstanceTypeForClonedInstance:

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

    • approvalForCreatingImageAfterDriversInstallation:

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

    • createImageAfterDriversInstallation:

      Crea una imagen a partir de 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, revise la sección Resultados para ver los resultados detallados de la ejecución.

Referencias

AWS Systems Manager Automation