AWSPremiumSupport-ChangeInstanceTypeIntelToAMD - 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.

AWSPremiumSupport-ChangeInstanceTypeIntelToAMD

Descripción

El manual de procedimientos AWSPremiumSupport-ChangeInstanceTypeIntelToAMDautomatiza las migraciones desde instancias de Amazon Elastic Compute Cloud (Amazon EC2) con tecnología Intel a tipos de instancias equivalentes con tecnología AMD. Este manual de procedimientos admite instancias de uso general (M), de desempeño con ráfagas (T), optimizadas para cómputo (C) y optimizadas para memoria (R) creadas en el sistema Nitro. Este manual de procedimientos se puede usar en instancias que no estén administradas por Systems Manager.

Para reducir el posible riesgo de pérdida de datos y tiempo de inactividad, el manual de procedimientos comprueba el comportamiento de parada de la instancia, si la instancia está en un grupo de Amazon EC2 Auto Scaling, el estado de la instancia y si el tipo de instancia equivalente con tecnología AMD está disponible en la misma zona de disponibilidad. De forma predeterminada, este manual de procedimientos no cambiará el tipo de instancia si hay volúmenes de almacén de instancias adjuntos o si la instancia forma parte de una pila AWS CloudFormation. Si desea cambiar este comportamiento, especifique yespara cualquiera de los parámetros AllowInstanceStoreInstancesy AllowCloudFormationInstances.

importante

El acceso a los manuales de procedimientos de AWSPremiumSupport-* requiere una suscripción Enterprise o Business Support. Para obtener más información, consulte Comparar AWS Supportplanes.

Consideraciones

  • Recomendamos hacer una copia de seguridad de la instancia antes de usar este manual de procedimientos.

  • Para cambiar el tipo de instancia, es necesario que el manual de procedimientos detenga su instancia. Cuando se detiene una instancia, se pierden todos los datos almacenados en la RAM o en los volúmenes del almacén de instancias y se libera la dirección IPv4 pública automática. Para obtener más información, consulte Detenimiento e inicio de la instancia.

  • Si no especifica un valor para el parámetro TargetInstanceType, el manual de procedimientos intenta identificar la instancia AMD equivalente en términos de CPU virtuales y memoria dentro de la misma familia de instancias. El manual de procedimientos finaliza si no es capaz de identificar un tipo de instancia AMD equivalente.

  • Al usar la opción DryRun, puede capturar el tipo de instancia AMD equivalente y validar los requisitos sin cambiar realmente el tipo de instancia.

Ejecuta esta automatización (consola)

Tipo de documento

 Automation

Propietario

Amazon

Plataformas

Linux, macOS, Windows

Parámetros

  • AutomationAssumeRole

    Tipo: String

    Descripción: (Opcional) el Nombre de recurso de Amazon (ARN) del rol (IAM) AWS Identity and Access Managementque permite a System Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utilizará los permisos del usuario que ejecuta este manual de procedimientos.

  • Acknowledge

    Tipo: String

    Descripción: (Obligatorio) Introduzca yespara confirmar que la instancia de destino se detendrá si se está ejecutando.

  • InstanceId

    Tipo: String

    Descripción: (Obligatorio) El ID de la instancia de Amazon EC2 cuyo tipo desea cambiar.

  • TargetInstanceType

    Tipo: String

    Predeterminado: automatic

    Descripción: (Opcional) El tipo de instancia AMD al que desea cambiar su instancia. El valor predeterminado automaticusa el tipo de instancia equivalente en términos de CPU virtuales y memoria. Por ejemplo, un m5.large se cambiaría a m5a.large.

  • AllowInstanceStoreInstances

    Tipo: String

    Valores válidos: no | yes

    Valor predeterminado: no

    Descripción: (Opcional) Si especifica yes, el manual de procedimientos se ejecuta en instancias que tienen volúmenes de almacén de instancias adjuntos.

  • AllowCloudFormationInstances

    Tipo: String

    Valores válidos: no | yes

    Valor predeterminado: no

    Descripción: (Opcional) Si se establece en yes, el manual de procedimientos se ejecuta en las instancias que forman parte de una pila AWS CloudFormation.

  • AllowCrossGeneration

    Tipo: String

    Valores válidos: no | yes

    Valor predeterminado: no

    Descripción: (Opcional) Si se establece en yes, el manual de procedimientos intenta encontrar el tipo de instancia AMD equivalente más reciente dentro de la misma familia de instancias.

  • DryRun

    Tipo: String

    Valores válidos: no | yes

    Valor predeterminado: no

    Descripción: (Opcional) Si se establece en yes, el manual de procedimientos regresa el tipo de instancia AMD equivalente y valida los requisitos de migración sin realizar cambios en el tipo de instancia.

  • SleepWait

    Tipo: String

    Predeterminado: PT3S

    Descripción: (Opcional) El tiempo que debe esperar el manual de procedimientos antes de iniciar una nueva automatización. El valor que proporcione para este parámetro debe coincidir con la norma ISO 8601. Para obtener más información sobre la creación de cadenas ISO 8601, consulte Formatear cadenas de fecha y hora para Systems Manager.

Permisos de IAM necesarios

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

  • ssm:DescribeAutomationExecutions

  • ssm:GetAutomationExecution

  • ssm:StartAutomationExecution

  • ec2:GetInstanceTypesFromInstanceRequirements

  • ec2:DescribeInstanceAttribute

  • ec2:DescribeInstances

  • ec2:DescribeInstanceStatus

  • ec2:DescribeInstanceTypeOfferings

  • ec2:DescribeInstanceTypes

  • ec2:DescribeTags

  • ec2:ModifyInstanceAttribute

  • ec2:StartInstances

  • ec2:StopInstances

Pasos de documentos

  1. aws:assertAwsResourceProperty: Confirma que el estado de la instancia de Amazon EC2 de destino es running, pending, stopped o stopping. De lo contrario, la automatización finaliza.

  2. aws:executeAwsApi: Reúne las propiedades de la instancia de Amazon EC2 de destino.

  3. aws:branch: Ramifica la automatización en función del estado de la instancia de Amazon EC2.

    1. En caso de stoppedo stopping, la automatización se ejecuta aws:waitForAwsResourcePropertyhasta que la instancia de Amazon EC2 se detenga por completo.

    2. En caso de runningo pending, la automatización se ejecuta aws:waitForAwsResourcePropertyhasta que la instancia de Amazon EC2 supere las comprobaciones de estado.

  4. aws:assertAwsResourceProperty: Confirma que la instancia de Amazon EC2 no forma parte de un grupo de escalado automático comprobando si la etiqueta aws:autoscaling:groupNameestá aplicada.

  5. aws:executeAwsApi: Reúne las propiedades del tipo de instancia actual para buscar el tipo de instancia AMD equivalente.

  6. aws:assertAwsResourceProperty: Confirma que el código de producto AWS Marketplaceno está asociado a la instancia de Amazon EC2. Algunos productos no están disponibles en todos los tipos de instancias.

  7. aws:branch: Ramifica la automatización en función de si desea que la automatización compruebe si la instancia de Amazon EC2 forma parte de una pila AWS CloudFormation

    1. Si la etiqueta aws:cloudformation:stack-namese aplica a la instancia, la automatización se ejecuta aws:assertAwsResourcePropertypara confirmar que la instancia no forma parte de una pila AWS CloudFormation.

  8. aws:branch: Ramifica la automatización en función de si el tipo de volumen raíz de la instancia es Amazon Elastic Block Store (Amazon EBS).

  9. aws:assertAwsResourceProperty: Confirma que el comportamiento de cierre de la instancia sea stopy no terminate.

  10. aws:executeScript: Confirma que solo hay una automatización de este manual de procedimientos dirigida a la instancia actual. Si ya hay otra automatización en curso dirigida a la misma instancia, regresa un error y finaliza.

  11. aws:executeAwsApi: Regresa una lista de los tipos de instancia AMD con la misma cantidad de memoria y vCPU.

  12. aws:executeScript: Comprueba si el tipo de instancia actual es compatible y regresa su tipo de instancia AMD equivalente. Si no hay un equivalente, la automatización finaliza.

  13. aws:executeScript: Confirma que el tipo de instancia AMD está disponible en la misma zona de disponibilidad y verifica los permisos de IAM proporcionados.

  14. aws:branch: Ramifica la automatización en función de si el valor del parámetro DryRunes yes.

  15. aws:branch: Comprueba si el tipo de instancia original y el de destino son iguales. Si son iguales, la automatización finaliza.

  16. aws:executeAwsApi: Obtiene el estado actual de la instancia.

  17. aws:changeInstanceState: Crea la instancia de Amazon EC2.

  18. aws:changeInstanceState: Obliga a la instancia a detenerse si está atascada en el estado de parada.

  19. aws:executeAwsApi: Cambia el tipo de instancia por el tipo de instancia AMD de destino.

  20. aws:sleep: Espera 3 segundos después de cambiar el tipo de instancia para lograr una coherencia definitiva.

  21. aws:branch: Ramifica la automatización en función del estado de la instancia anterior. Si se estaba running, se inicia la instancia.

    1. aws:changeInstanceState: Inicia la instancia de Amazon EC2 si se estaba ejecutando antes de cambiar el tipo de instancia.

    2. aws:waitForAwsResourceProperty: Espera a que la instancia de Amazon EC2 supere las comprobaciones de estado. Si la instancia no supera las comprobaciones de estado, la instancia cambia de regreso a su tipo de instancia original.

      1. aws:changeInstanceState: Detiene la instancia de Amazon EC2 antes de cambiarla a su tipo de instancia original.

      2. aws:changeInstanceState: Obliga a la instancia de Amazon EC2 a detenerse antes de cambiarla a su tipo de instancia original en caso de que se quede atascada en un estado de parada.

      3. aws:executeAwsApi: Cambia la instancia de Amazon EC2 a su tipo original.

      4. aws:sleep: Espera 3 segundos después de cambiar el tipo de instancia para lograr una coherencia definitiva.

      5. aws:changeInstanceState: Inicia la instancia de Amazon EC2 si se estaba ejecutando antes de cambiar el tipo de instancia.

      6. aws:waitForAwsResourceProperty: Espera a que la instancia de Amazon EC2 supere las comprobaciones de estado.

  22. aws:sleep: Espera antes de finalizar el manual de procedimientos.