AWSSupport-MigrateEC2ClassicToVPC - AWS Systems Manager Referência do runbook de automação

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

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)

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