AWSSupport-CopyEC2Instance - 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-CopyEC2Instance

Descripción

El manual de procedimientos AWSSupport-CopyEC2Instanceproporciona una solución automatizada para el procedimiento descrito en el artículo del Centro de Conocimiento ¿Cómo muevo mi instancia EC2 a otra subred, zona de disponibilidad o VPC? La automatización se ramifica en función de los valores que especifique para los parámetros Regiony SubnetId.

Si especifica un valor para el parámetro SubnetIdpero no un valor para el parámetro Region, la automatización crea una Amazon Machine Image(AMI) de la instancia de destino y lanza una nueva instancia desde la AMIen la subred que especificó.

Si especifica un valor para el parámetro SubnetIdy el parámetro Region, la automatización crea una instancia AMIde destino, copia la AMIen la Región de AWSque especificó y lanza una nueva instancia desde la AMIen la subred que especificó.

Si especifica un valor para el parámetro Regionpero no un valor para el parámetro SubnetId, la automatización crea una AMIde las instancias de destino, copia la AMIen la región que especificó y lanza una nueva instancia desde la AMIen la subred predeterminada de su nube privada virtual (VPC) en la región de destino.

Si no se especifica ningún valor para los parámetros Regiono SubnetId, la automatización crea una AMIde las instancias de destino y lanza una nueva instancia desde la AMIen la subred predeterminada de su VPC.

Para copiar una AMIa una región diferente, debe proporcionar un valor para el parámetro AutomationAssumeRole. Si se agota el tiempo de espera de la automatización durante el paso waitForAvailableDestinationAmi, es posible que la AMIaún esté copiando. En este caso puede esperar a que se complete la copia y lanzar la instancia manualmente.

Antes de ejecutar esta automatización, tenga en cuenta lo siguiente:

  • Las AMIse basan en instantáneas de Amazon Elastic Block Store (Amazon EBS). En el caso de sistemas de archivos de gran tamaño sin una instantánea previa, la creación de AMIpuede tardar varias horas. Para reducir el tiempo de creación de AMI, cree una instantánea de Amazon EBS antes de crear laAMI.

  • Al crear una AMIno se crea una instantánea para el almacén de instancias en la instancia. Para obtener información sobre cómo realizar copias de seguridad de los volúmenes del almacén de instancias en Amazon EBS, consulte ¿Cómo puedo hacer una copia de seguridad de un volumen de almacén de instancias de mi instancia de Amazon EC2 en Amazon EBS?

  • La nueva instancia de Amazon EC2 tiene una dirección IP IPv4 privada o IPv6 pública diferente. Debe actualizar todas las referencias a las direcciones IP antiguas (por ejemplo, en las entradas de DNS) con las nuevas direcciones IP asignadas a la nueva instancia. Si utiliza una dirección IP elástica en la instancia de origen, asegúrese de adjuntarla a la nueva instancia.

  • Se pueden producir problemas con el identificador de seguridad de dominio (SID) cuando la copia se lanza e intenta contactar con el dominio. Antes de capturar la AMI, utilice Sysprep o elimine la instancia unida al dominio del dominio para evitar problemas de conflicto. Para obtener más información, consulte ¿Cómo puedo usar Sysprep para crear e instalar AMI de Windows personalizadas y reutilizables?

Ejecuta esta automatización (consola)

importante

No recomendamos usar este manual de procedimientos para copiar instancias del controlador de dominio de Microsoft Active Directory.

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.

  • InstanceId

    Tipo: String

    Descripción: (Obligatorio) ID de la instancia de que desea reiniciar.

  • KeyPair

    Tipo: String

    Descripción: (Opcional) El par de claves que desea asociar con la nueva instancia copiada. Si va a copiar la instancia a una región diferente, asegúrese de que el par de claves existe en la región especificada.

  • Región

    Tipo: String

    Descripción: (Opcional) La región a la que quiere copiar la instancia. Si especifica un valor para este parámetro, pero no especifica valores para los parámetros SubnetIdy SecurityGroupIds, la automatización intentará lanzar la instancia en la VPC predeterminada con el grupo de seguridad predeterminado. Si EC2-Classic está activado en la región de destino, se producirá un error en el lanzamiento.

  • SubnetId

    Tipo: String

    Descripción: (Opcional) El ID de la subred en la que desea copiar la instancia. Si EC2-Classic está activado en la región de destino, debe proporcionar un valor para este parámetro.

  • InstanceType

    Tipo: String

    Descripción: (Opcional) el tipo de instancia EC2 que se va iniciar. Si no especifica un valor para este parámetro, se utiliza el tipo de instancia de origen. Si el tipo de instancia de origen no es compatible con la región en la que se está copiando la instancia, se produce un error en la automatización.

  • SecurityGroupIds

    Tipo: String

    Descripción: (Opcional) Una lista separada por comas de los identificadores de grupo de seguridad que desea asociar con la instancia copiada. Si no especifica un valor para este parámetro y la instancia no se copia en una región diferente, se utilizan los grupos de seguridad asociados a la instancia de origen. Si va a copiar la instancia a una región diferente, se utiliza el grupo de seguridad predeterminado para la VPC predeterminada de la región de destino.

  • KeepImageSourceRegion

    Tipo: booleano

    Valores válidos: true | false

    Valor predeterminado: true

    Descripción: (Opcional) Si especifica truepara este parámetro, la automatización no elimina la AMIde la instancia de origen. Si especifica false para este parámetro, la automatización anula el registro de AMI y elimina las instantáneas asociadas.

  • KeepImageDestinationRegion

    Tipo: booleano

    Valores válidos: true | false

    Valor predeterminado: true

    Descripción: (Opcional) Si especifica truepara este parámetro, la automatización no elimina la AMIque se haya copiado en la región que especificó. Si especifica false para este parámetro, la automatización anula el registro de AMI y elimina las instantáneas asociadas.

  • NoRebootInstanceBeforeTakingImage

    Tipo: booleano

    Valores válidos: true | false

    Valor predeterminado: falso

    Descripción: (Opcional) Si especifica truepara este parámetro, la instancia de origen no se reiniciará antes de crear la AMI. Cuando se utiliza esta opción, no se puede garantizar la integridad del sistema de archivos en la imagen creada.

Permisos de IAM necesarios

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

  • ec2:CreateImage

  • ec2:DeleteSnapshot

  • ec2:DeregisterImage

  • ec2:DescribeInstances

  • ec2:DescribeImages

  • ec2:RunInstances

Si está copiando la instancia en una región diferente, también necesitará los siguientes permisos.

  • ec2:CopyImage

Pasos de documentos

  • describeOriginalInstanceDetails - Recopila los detalles de la instancia que se va a copiar.

  • assertRootVolumeIsEbs - Comprueba si el tipo de dispositivo de volumen raíz es ebsy, de no ser así, finaliza la automatización.

  • evalInputParameters - Evalúa los valores proporcionados para los parámetros de entrada.

  • createLocalAmi - Crea una AMIde la instancia de origen.

  • tagLocalAmi - Etiqueta la AMIcreada en el paso anterior.

  • branchAssertRegionIsSame - Se ramifica en función de si la instancia se está copiando en la misma región o en una región diferente.

  • branchAssertSameRegionWithKeyPair - Se ramifica en función de si se ha proporcionado un valor para el parámetro KeyPairde una instancia que se está copiando en la misma región.

  • sameRegionLaunchInstanceWithKeyPair - Lanza una instancia de Amazon EC2 desde la AMIde la instancia de origen de la misma subred o de la subred que especifique mediante el par de claves que especificó.

  • sameRegionLaunchInstanceWithoutKeyPair - Lanza una instancia de Amazon EC2 desde la AMIde la instancia de origen de la misma subred o de la subred que especifique sin un par de claves.

  • copyAmiToRegion - Copia la AMIpara la región de destino.

  • waitForAvailableDestinationAmi - Espera a que el estado copiado de AMIpase a ser available.

  • destinationRegionLaunchInstance - Lanza una instancia de Amazon EC2 utilizando la AMIcopiada.

  • branchAssertDestinationAmiToDelete - Se ramifica en función del valor que haya proporcionado para el parámetro KeepImageDestinationRegion.

  • deregisterDestinationAmiAndDeleteSnapshots - Anula el registro de la AMIcopiada y elimina las instantáneas asociadas.

  • branchAssertSourceAmiTodelete - Se ramifica en función del valor que haya proporcionado para el parámetro KeepImageSourceRegion.

  • deregisterSourceAmiAndDeleteSnapshots - Anula el registro de la AMIcreada en la instancia de origen y elimina las instantáneas asociadas.

  • sleep - Suspende la automatización durante 2 segundos. Se trata de un estado terminal.

Salidas

sameRegionLaunchInstanceWithKeyPair.InstanceIds

sameRegionLaunchInstanceWithoutKeyPair.InstanceIds

destinationRegionLaunchInstance.DestinationInstanceId