

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-MigrateEC2ClassicToVPC`
<a name="automation-awssupport-migrate-ec2-classic-to-vpc"></a>

**Descripción**

El `AWSSupport-MigrateEC2ClassicToVPC` manual migra una instancia de Amazon Elastic Compute Cloud EC2 (Amazon) de EC2 -Classic a una nube privada virtual (VPC). Este runbook admite la migración de EC2 instancias de Amazon del tipo de virtualización de máquinas virtuales de hardware (HVM) con volúmenes raíz de Amazon Elastic Block Store (Amazon EBS).

[Ejecuta esta automatización (consola)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-MigrateEC2ClassicToVPC)

**Tipo de documento**

Automatización

**Propietario**

Amazon

**Plataformas**

Linux

**Parámetros**
+ AutomationAssumeRole

  Tipo: cadena

  Descripción: (obligatorio) el Nombre de recurso de Amazon (ARN) del rol de AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre.
+ ApproverIAM

  Tipo:  StringList

  Descripción: (opcional) Los nombres de los recursos de Amazon (ARNs) de los usuarios de IAM que pueden aprobar o denegar la acción. Este parámetro solo se aplica si especifica un valor `CutOver` para el parámetro `MigrationType`.
+ DestinationSecurityGroupId

  Tipo:  StringList

  Descripción: (opcional) El ID del grupo de seguridad que quieres asociar a la EC2 instancia de Amazon que se lanza en tu VPC. Si no especificas un valor para este parámetro, la automatización crea un grupo de seguridad en la VPC y copia las reglas del grupo de seguridad en EC2 -Classic. Si las reglas no se copian en el nuevo grupo de seguridad, el grupo de seguridad predeterminado de la VPC se asocia a la instancia de Amazon EC2 .
+ DestinationSubnetId

  Tipo: cadena

  Descripción: (opcional) El ID de la subred a la que quieres migrar tu EC2 instancia de Amazon. Si no especifica un valor para este parámetro, la automatización elige de forma aleatoria una subred de la VPC.
+ InstanceId

  Tipo: cadena

  Descripción: (Obligatorio) El ID de la EC2 instancia de Amazon que quieres migrar.
+ MigrationType

  Tipo: cadena

  Valores válidos: CutOver \$1 Prueba

  Descripción: (obligatorio) el tipo de migración que desea realizar.

  La `CutOver` opción requiere aprobación para detener la EC2 instancia de Amazon que se ejecuta en EC2 -Classic. Una vez aprobada esta acción, la EC2 instancia de Amazon se detiene y la automatización crea un Amazon Machine Image (AMI). Cuando el AMI el estado es `available` que se lanza una nueva EC2 instancia de Amazon desde este AMI en el `DestinationSubnetId` que especifique en su VPC. Si la EC2 instancia de Amazon que se ejecuta en EC2 -Classic tiene una dirección IP elástica adjunta, la instancia se moverá a la EC2 instancia de Amazon recién creada en la VPC. Si la EC2 instancia de Amazon que se está lanzando en su VPC no se crea por algún motivo, se cancelará y se solicitará la aprobación para iniciar la EC2 instancia de Amazon en EC2 -Classic.

  La `Test` opción crea un AMI de tu EC2 instancia de Amazon que se ejecuta en EC2 -Classic sin reiniciarse. Como la EC2 instancia de Amazon no se reinicia, no podemos garantizar la integridad del sistema de archivos de la imagen creada. Cuando el AMI el estado es `available` que se lanza una nueva EC2 instancia de Amazon desde este AMI en el `DestinationSubnetId` que especifique en su VPC. Si tu EC2 instancia de Amazon que se ejecuta en EC2 -Classic tiene una dirección IP elástica adjunta, la automatización verifica que la que `DestinationSubnetId` especifiques sea pública. Si la EC2 instancia de Amazon que se está lanzando en tu VPC no se crea por algún motivo, se cancela y finaliza la automatización.
+ SNSNotificationARNforAprobación

  Tipo: cadena

  Descripción: (opcional) se establece el ARN del tema de Amazon Simple Notification Service (Amazon SNS) al que desea enviar las solicitudes de aprobación. Este parámetro solo se aplica si especifica un valor `CutOver` para el parámetro `MigrationType`.
+ TargetInstanceType

  Tipo: cadena

  Predeterminado: t2.2xlarge

  Descripción: (opcional) El tipo de EC2 instancia de Amazon que quieres lanzar en tu VPC. Solo se admiten los tipos de instancias basados en Xen, como T2, M4 o C4.

**Permisos de IAM necesarios**

El parámetro `AutomationAssumeRole` requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.
+ `ssm:GetDocument`
+ `ssm:ListDocumentVersions`
+ `ssm:ListDocuments`
+ `ssm:StartAutomationExecution`
+ `sns:GetTopicAttributes`
+ `sns:ListSubscriptions`
+ `sns:ListTopics`
+ `sns:Publish`
+ `ec2:AssociateAddress`
+ `ec2:AuthorizeSecurityGroupIngress`
+ `ec2:CreateImage`
+ `ec2:CreateSecurityGroup`
+ `ec2:DeleteSecurityGroup`
+ `ec2:MoveAddressToVpc`
+ `ec2:RunInstances`
+ `ec2:StopInstances`
+ `ec2:CreateTags`
+ `ec2:DescribeAddresses`
+ `ec2:DescribeInstanceAttribute`
+ `ec2:DescribeInstances`
+ `ec2:DescribeInstanceStatus`
+ `ec2:DescribeRouteTables`
+ `ec2:DescribeSecurityGroupReferences`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeSubnets`
+ `ec2:DescribeTags`
+ `ec2:DescribeVpcs`
+ `ec2:DescribeInstanceTypes`
+ `ec2:DescribeImages`

**Pasos de documentos**
+ `aws:executeAwsApi`- Recopila detalles sobre la EC2 instancia de Amazon que especificas en el `InstanceId` parámetro.
+ `aws:assertAwsResourceProperty`: confirma que el tipo de instancia que especifica en el parámetro `TargetInstanceType` está basado en Xen.
+ `aws:assertAwsResourceProperty`- Confirma que la EC2 instancia de Amazon que especificó en el `InstanceId` parámetro es del tipo de virtualización HVM.
+ `aws:assertAwsResourceProperty`- Confirma que la EC2 instancia de Amazon que especificó en el `InstanceId` parámetro tiene un volumen raíz de Amazon EBS.
+ `aws:executeScript`: crea un grupo de seguridad según sea necesario en función del valor que especifique para el parámetro `DestinationSecurityGroupId`.
+ `aws:branch`: se ramifica en función del valor que especifique en el parámetro `DestinationSubnetId`.
+ `aws:executeAwsApi`: identifica la VPC predeterminada en la Región de AWS donde se ejecuta esta automatización.
+ `aws:executeAwsApi`: elige aleatoriamente el ID de una subred ubicada en la VPC predeterminada.
+ `aws:createImage`- Crea un AMI sin reiniciar la instancia de Amazon EC2.
+ `aws:branch`: se ramifica en función del valor que especifique para el parámetro `MigrationType`.
+ `aws:branch`: se ramifica en función del valor que especifique para el parámetro `DestinationSubnetId`.
+ `aws:runInstances`- Lanza una nueva instancia desde AMI creado sin reiniciar la EC2 instancia de Amazon en EC2 -Classic.
+ `aws:changeInstanceState`- Termina la EC2 instancia de Amazon recién lanzada si el paso anterior falla por cualquier motivo.
+ `aws:runInstances`- Lanza una nueva instancia desde AMI creado sin reiniciar la EC2 instancia de Amazon en EC2 -Classic en el `DestinationSubnetId` si se proporciona.
+ `aws:changeInstanceState`- Termina la EC2 instancia de Amazon recién lanzada si el paso anterior falla por cualquier motivo.
+ `aws:assertAwsResourceProperty`- Confirma el comportamiento de parada de la EC2 instancia de Amazon que se ejecuta en EC2 -Classic.
+ `aws:approve`- Espera la aprobación para detener la EC2 instancia de Amazon.
+ `aws:changeInstanceState`- Detiene la ejecución de la EC2 instancia de Amazon en EC2 -Classic.
+ `aws:changeInstanceState`- Force detiene la EC2 instancia de Amazon que se ejecuta en EC2 -Classic si es necesario.
+ `aws:createImage`- Crea un AMI de la EC2 instancia de Amazon después de que se haya detenido.
+ `aws:branch`: se ramifica en función del valor especificado para el parámetro `DestinationSubnetId`.
+ `aws:runInstances`- Lanza una nueva instancia desde AMI creado a partir de la EC2 instancia de Amazon detenida en EC2 -Classic.
+ `aws:approve`- Espera la aprobación para finalizar la instancia recién lanzada e inicia la instancia de Amazon EC2 en EC2 -Classic si el paso anterior falla por algún motivo.
+ `aws:changeInstanceState`- Termina la EC2 instancia de Amazon recién lanzada.
+ `aws:runInstances`- Lanza una nueva instancia desde AMI creado a partir de la EC2 instancia de Amazon detenida en EC2 -Classic a partir del `DestinationSubnetId` parámetro.
+ `aws:approve`- Espera la aprobación para finalizar la instancia recién lanzada e inicia la instancia de Amazon EC2 en EC2 -Classic si el paso anterior falla por algún motivo.
+ `aws:changeInstanceState`- Termina la EC2 instancia de Amazon recién lanzada.
+ `aws:changeInstanceState`- Inicia la EC2 instancia de Amazon que se detuvo en EC2 -Classic.
+ `aws:branch`- Se ramifica en función de si la EC2 instancia de Amazon tiene una dirección IP pública.
+ `aws:executeAwsApi`: verifica si la dirección IP pública es una dirección IP elástica.
+ `aws:branch`: se ramifica en función del valor que especifique en el parámetro `MigrationType`.
+ `aws:executeAwsApi`: mueve la dirección IP elástica a la VPC.
+ `aws:executeAwsApi`: recopila el ID de asignación de la dirección IP elástica que se trasladó a la VPC.
+ `aws:branch`- Se ramifica en función de la subred en la que se lanzó la EC2 instancia de Amazon que se ejecuta en la VPC.
+ `aws:executeAwsApi`: adjunta la dirección IP elástica a la instancia recién lanzada en la VPC.
+ `aws:executeScript`- Confirma que la subred que acaba de lanzar su EC2 instancia de Amazon y que se ejecuta en su VPC es pública.

**Salidas**

g`etInstanceProperties.virtualizationType`: el tipo de virtualización de la EC2 instancia de Amazon que se ejecuta en EC2 -Classic.

`getInstanceProperties.rootDeviceType`- El tipo de dispositivo raíz de la EC2 instancia de Amazon que se ejecuta en EC2 -Classic.

`createAMIWithoutReboot.ImageId`- El ID del AMI creado sin reiniciar la EC2 instancia de Amazon que se ejecuta en EC2 -Classic.

`getDefaultVPC.VpcId`- El ID de la VPC predeterminada en la que se lanza la nueva EC2 instancia de Amazon si no se proporciona un valor para el `DestinationSubnetId` parámetro.

`getSubnetIdinDefaultVPC.subnetIdFromDefaultVpc`- El ID de la subred de la VPC predeterminada en la que se lanza la nueva instancia de EC2 Amazon si no se proporciona un valor para `DestinationSubnetId` el parámetro.



`launchTestInstanceDefaultVPC.InstanceIds`- El ID de la EC2 instancia de Amazon recién lanzada en tu VPC predeterminada durante el tipo de `Test` migración.

`launchTestInstanceProvidedSubnet.InstanceIds`- El ID de la EC2 instancia de Amazon recién lanzada `DestinationSubnetId` que especificó durante el tipo de `Test` migración.

`createAMIAfterStoppingInstance.ImageId`- El ID de la AMI creado después de detener la ejecución de la EC2 instancia de Amazon en EC2 -Classic.

`launchCutOverInstanceProvidedSubnet.InstanceIds`- El ID de la EC2 instancia de Amazon recién lanzada `DestinationSubnetId` que especificó durante el tipo de `CutOver` migración.

`launchCutOverInstanceDefaultVPC.InstanceIds`- El ID de la EC2 instancia de Amazon recién lanzada en tu VPC predeterminada durante el tipo de `CutOver` migración.

`verifySubnetIsPublicTestDefaultVPC.IsSubnetPublic`: si la subred elegida por la automatización en tu VPC predeterminada es pública.

`verifySubnetIsPublicTestProvidedSubnet.IsSubnetPublic`: si la subred que especificó en `DestinationSubnetId` es pública.