

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# `AWSSupport-MigrateEC2ClassicToVPC`
<a name="automation-awssupport-migrate-ec2-classic-to-vpc"></a>

**Descrição**

O `AWSSupport-MigrateEC2ClassicToVPC` runbook migra uma instância do Amazon Elastic Compute Cloud (Amazon EC2) do EC2 -Classic para uma nuvem privada virtual (VPC). Este runbook oferece suporte à migração de EC2 instâncias da Amazon do tipo de virtualização de máquina virtual de hardware (HVM) com volumes raiz do Amazon Elastic Block Store (Amazon EBS).

[Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-MigrateEC2ClassicToVPC)

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux

**Parâmetros**
+ AutomationAssumeRole

  Tipo: string

  Descrição: (obrigatório) O nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome.
+ ApproverIAM

  Tipo: StringList

  Descrição: (Opcional) Os nomes de recursos da Amazon (ARNs) dos usuários do IAM que podem aprovar ou negar a ação. Esse parâmetro só é aplicável se você especificar o valor `CutOver` para o parâmetro `MigrationType`.
+ DestinationSecurityGroupId

  Tipo: StringList

  Descrição: (Opcional) O ID do grupo de segurança que você deseja associar à EC2 instância da Amazon que é executada em sua VPC. Se você não especificar um valor para esse parâmetro, a automação cria um grupo de segurança em sua VPC e copia as regras do grupo de segurança em EC2 -Classic. Se as regras não forem copiadas para o novo grupo de segurança, o grupo de segurança padrão da sua VPC será associado à instância da Amazon EC2 .
+ DestinationSubnetId

  Tipo: string

  Descrição: (Opcional) O ID da sub-rede para a qual você deseja migrar sua EC2 instância da Amazon. Se você não especificar um valor para esse parâmetro, a automação escolherá aleatoriamente uma sub-rede da VPC.
+ InstanceId

  Tipo: string

  Descrição: (Obrigatório) O ID da EC2 instância da Amazon que você deseja migrar.
+ MigrationType

  Tipo: string

  Valores válidos: CutOver \$1 Teste

  Descrição: (obrigatório) o tipo de migração que você deseja executar.

  A `CutOver` opção exige aprovação para interromper sua EC2 instância da Amazon que está sendo executada em EC2 -Classic. Depois que essa ação é aprovada, a EC2 instância da Amazon é interrompida e a automação cria um Amazon Machine Image (AMI). Quando o AMI o status é`available`, uma nova EC2 instância da Amazon é iniciada a partir desta AMI no `DestinationSubnetId` que você especifica em sua VPC. Se sua EC2 instância da Amazon que está sendo executada em EC2 -Classic tiver um endereço IP elástico anexado, a instância será movida para a EC2 instância Amazon recém-criada em sua VPC. Se a EC2 instância da Amazon iniciada em sua VPC falhar na criação por qualquer motivo, ela será encerrada e a aprovação será solicitada para iniciar sua EC2 instância da Amazon em -Classic. EC2

  A `Test` opção cria um AMI da sua EC2 instância Amazon que está sendo executada em EC2 -Classic sem reinicialização. Como a EC2 instância da Amazon não é reinicializada, não podemos garantir a integridade do sistema de arquivos da imagem criada. Quando o AMI o status é`available`, uma nova EC2 instância da Amazon é iniciada a partir desta AMI no `DestinationSubnetId` que você especifica em sua VPC. Se sua EC2 instância da Amazon que está sendo executada em EC2 -Classic tiver um endereço IP elástico anexado, a automação verificará se o que `DestinationSubnetId` você especificou é público. Se a EC2 instância da Amazon iniciada em sua VPC falhar na criação por qualquer motivo, ela será encerrada e a automação será encerrada.
+ SNSNotificationARNforAprovação

  Tipo: string

  Descrição: (opcional) o ARN do tópico do Amazon Simple Notification Service (Amazon SNS) para o qual você deseja enviar solicitações de aprovação. Esse parâmetro só é aplicável se você especificar o valor `CutOver` para o parâmetro `MigrationType`.
+ TargetInstanceType

  Tipo: string

  Padrão: t2.2xlarge

  Descrição: (Opcional) O tipo de EC2 instância da Amazon que você deseja iniciar em sua VPC. Somente tipos de instância baseados em Xen, como T2, M4 ou C4, são suportados.

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+ `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`

**Etapas do documento**
+ `aws:executeAwsApi`- Reúne detalhes sobre a EC2 instância da Amazon que você especifica no `InstanceId` parâmetro.
+ `aws:assertAwsResourceProperty`: confirma que o tipo de instância que você especifica no parâmetro `TargetInstanceType` é baseado em Xen.
+ `aws:assertAwsResourceProperty`- Confirma que a EC2 instância da Amazon que você especifica no `InstanceId` parâmetro é do tipo de virtualização HVM.
+ `aws:assertAwsResourceProperty`- Confirma que a EC2 instância da Amazon que você especifica no `InstanceId` parâmetro tem um volume raiz do Amazon EBS.
+ `aws:executeScript`: cria um grupo de segurança conforme necessário, dependendo do valor que você especificar para o parâmetro `DestinationSecurityGroupId`.
+ `aws:branch`: ramifica com base no valor que você especifica no parâmetro `DestinationSubnetId`.
+ `aws:executeAwsApi`: identifica a VPC padrão na Região da AWS em que você executa essa automação.
+ `aws:executeAwsApi`: escolhe aleatoriamente o ID de uma sub-rede localizada na VPC padrão.
+ `aws:createImage`- Cria um AMI sem reiniciar a instância da Amazon EC2.
+ `aws:branch`: ramifica com base no valor que você especifica para o parâmetro `MigrationType`.
+ `aws:branch`: ramifica com base no valor que você especifica para o parâmetro `DestinationSubnetId`.
+ `aws:runInstances`- Lança uma nova instância a partir do AMI criado sem reiniciar a EC2 instância da Amazon em EC2 -Classic.
+ `aws:changeInstanceState`- Encerra a EC2 instância Amazon recém-lançada se a etapa anterior falhar por qualquer motivo.
+ `aws:runInstances`- Lança uma nova instância a partir do AMI criado sem reiniciar a EC2 instância da Amazon em EC2 -Classic no, se fornecido. `DestinationSubnetId`
+ `aws:changeInstanceState`- Encerra a EC2 instância Amazon recém-lançada se a etapa anterior falhar por qualquer motivo.
+ `aws:assertAwsResourceProperty`- Confirma o comportamento de parada da EC2 instância Amazon em execução em EC2 -Classic.
+ `aws:approve`- Aguarda a aprovação para interromper a EC2 instância da Amazon.
+ `aws:changeInstanceState`- Interrompe a execução da EC2 instância Amazon em EC2 -Classic.
+ `aws:changeInstanceState`- Force a interrupção da execução da EC2 instância Amazon em EC2 -Classic, se necessário.
+ `aws:createImage`- Cria um AMI da EC2 instância da Amazon depois que ela foi interrompida.
+ `aws:branch` :Ramificações com base no valor especificado para o parâmetro `DestinationSubnetId`.
+ `aws:runInstances`- Lança uma nova instância a partir do AMI criado da EC2 instância Amazon interrompida em EC2 -Classic.
+ `aws:approve`- Aguarda a aprovação para encerrar a instância recém-lançada e inicia a EC2 instância Amazon em EC2 -Classic se a etapa anterior falhar por algum motivo.
+ `aws:changeInstanceState`- Encerra a EC2 instância Amazon recém-lançada.
+ `aws:runInstances`- Lança uma nova instância a partir do AMI criado da EC2 instância Amazon parada em EC2 -Classic a partir do `DestinationSubnetId` parâmetro.
+ `aws:approve`- Aguarda a aprovação para encerrar a instância recém-lançada e inicia a EC2 instância Amazon em EC2 -Classic se a etapa anterior falhar por algum motivo.
+ `aws:changeInstanceState`- Encerra a EC2 instância Amazon recém-lançada.
+ `aws:changeInstanceState`- Inicia a EC2 instância da Amazon que foi interrompida em EC2 -Classic.
+ `aws:branch`- Ramificações com base no fato de a EC2 instância da Amazon ter um endereço IP público.
+ `aws:executeAwsApi`: verifica se o endereço IP público é um endereço IP elástico.
+ `aws:branch`: ramifica com base no valor que você especifica no parâmetro `MigrationType`.
+ `aws:executeAwsApi`: move o endereço IP elástico para sua VPC.
+ `aws:executeAwsApi`: coleta o ID de alocação do endereço IP elástico que foi movido para a VPC.
+ `aws:branch`- Ramificações com base em qual sub-rede a EC2 instância da Amazon em execução em sua VPC foi lançada.
+ `aws:executeAwsApi`: anexa o endereço IP elástico à instância recém-iniciada em sua VPC.
+ `aws:executeScript`- Confirma que a sub-rede que sua EC2 instância Amazon recém-lançada em execução em sua VPC é pública.

**Saídas**

g `etInstanceProperties.virtualizationType` - O tipo de virtualização da EC2 instância da Amazon em execução em EC2 -Classic.

`getInstanceProperties.rootDeviceType`- O tipo de dispositivo raiz da EC2 instância Amazon em execução em EC2 -Classic.

`createAMIWithoutReboot.ImageId`- O ID do AMI criado sem reiniciar a EC2 instância da Amazon em execução em EC2 -Classic.

`getDefaultVPC.VpcId`- O ID da VPC padrão em que a nova EC2 instância da Amazon é iniciada se um valor para o `DestinationSubnetId` parâmetro não for fornecido.

`getSubnetIdinDefaultVPC.subnetIdFromDefaultVpc`- O ID da sub-rede na VPC padrão em que a nova instância da EC2 Amazon é iniciada se um valor para `DestinationSubnetId` o parâmetro não for fornecido.



`launchTestInstanceDefaultVPC.InstanceIds`- O ID da EC2 instância Amazon recém-lançada em sua VPC padrão durante o tipo de `Test` migração.

`launchTestInstanceProvidedSubnet.InstanceIds`- O ID da EC2 instância Amazon recém-lançada na `DestinationSubnetId` que você especificou durante o tipo de `Test` migração.

`createAMIAfterStoppingInstance.ImageId`- O ID do AMI criado após interromper a execução da EC2 instância da Amazon em EC2 -Classic.

`launchCutOverInstanceProvidedSubnet.InstanceIds`- O ID da EC2 instância Amazon recém-lançada na `DestinationSubnetId` que você especificou durante o tipo de `CutOver` migração.

`launchCutOverInstanceDefaultVPC.InstanceIds`- O ID da EC2 instância Amazon recém-lançada em sua VPC padrão durante o tipo de `CutOver` migração.

`verifySubnetIsPublicTestDefaultVPC.IsSubnetPublic`: se a sub-rede escolhida pela automação em sua VPC padrão é pública.

`verifySubnetIsPublicTestProvidedSubnet.IsSubnetPublic`: se a sub-rede que você especificou no `DestinationSubnetId` é pública.