

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-CloneXenEC2InstanceAndMigrateToNitro`
<a name="automation-awssupport-clonexenec2instanceandmigratetonitro"></a>

 **Descrição** 

[Os **AWSSupport-CloneXenEC2 InstanceAndMigrateToNitro** runbooks clonam, preparam e migram a instância Linux clonada do Amazon Elastic Compute Cloud (Amazon EC2), atualmente em execução na plataforma Amazon EC2 Xen, para ser executada na plataforma Amazon EC2 Nitro.](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html#ec2-nitro-instances) Essa automação é dividida em três ramos diferentes:
+ **Verificações preliminares**: avalia todos os pré-requisitos para continuar com a migração, incluindo verificar se a instância de destino do Amazon EC2 já está sendo executada na plataforma Nitro, determinando o status do ciclo de vida, validando o sistema operacional e verificando a conectividade do Systems Manager.
+ **Teste**: cria um teste a AMI partir da instância de destino do Amazon EC2 e lança uma instância de teste do Amazon EC2 para validar o processo de migração antes de continuar.
+ **CloneAndMigrate**: cria um clone da instância de destino do Amazon EC2, instala os drivers necessários, configura o sistema para a plataforma Nitro e altera o tipo de instância para o tipo Nitro desejado.

**Importante**  
Antes de fornecer aprovação para interromper a instância de destino do Amazon EC2, certifique-se de que todos os aplicativos em execução na instância estejam normalmente fechados. Se a instância do Amazon EC2 não tiver um endereço IP elástico associado, o IPv4 endereço público automático mudará quando a instância for interrompida e iniciada.

**Importante**  
**Aviso**: a execução deste runbook pode gerar cobranças adicionais em sua conta para a instância do Amazon EC2, Amazon EBS Volumes & s. AMI Consulte os preços do [Amazon EC2 e os preços do](https://aws.amazon.com/ec2/pricing/) [Amazon EBS para obter](https://aws.amazon.com/ebs/pricing/) mais detalhes.

**Importante**  
 **Pré-requisitos**   
A instância de destino do Amazon EC2 exige acesso externo aos repositórios para instalar drivers e dependências`kernel-devel`, como,,,,,,, `gcc` `patch``rpm-build`, e `unzip` usar o gerenciador de pacotes `wget` `dracut` `make``linux-headers`, se necessário.

 **Sistemas operacionais compatíveis** 
+ Red Hat Enterprise Linux (RHEL) 8 e 9
+ Amazon Linux 2 e AL2023
+ Ubuntu Server 18.04 LTS, 20.04 e 22.04
+ Debian 11 e 12 (somente AWS partição)
+ SUSE12SP5 e SUSE15 SP (5,6)

 **Como funciona?** 

O runbook executa as seguintes etapas de alto nível:
+ Valida os pré-requisitos e verifica se a instância é adequada para migração.
+ Cria e testa um AMI para garantir que a migração seja bem-sucedida.
+ Ativa o atributo Enhanced Networking (ENA) e instala os drivers ENA mais recentes.
+ Verifica e configura o NVMe módulo no initramfs.
+ Analisa e modifica /etc/fstab para substituir os nomes dos dispositivos por. UUIDs
+ Desativa a nomenclatura previsível da interface e remove as regras de rede persistentes.
+ Altera o tipo de instância clonada para o tipo Nitro desejado.
+ Cria uma final AMI que pode ser usada como uma imagem dourada para iniciar instâncias do Nitro.

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

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux

**Parâmetros**

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

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+ `autoscaling:DescribeAutoScalingInstances`
+ `ec2:CreateImage`
+ `ec2:CreateTags`
+ `ec2:DescribeImages`
+ `ec2:DescribeInstanceAttribute`
+ `ec2:DescribeInstances`
+ `ec2:DescribeInstanceStatus`
+ `ec2:DescribeInstanceTypeOfferings`
+ `ec2:DescribeInstanceTypes`
+ `ec2:DeregisterImage`
+ `ec2:ModifyInstanceAttribute`
+ `ec2:RunInstances`
+ `ec2:StartInstances`
+ `ec2:StopInstances`
+ `ec2:TerminateInstances`
+ `iam:PassRole`
+ `sns:Publish`
+ `ssm:DescribeAutomationExecutions`
+ `ssm:DescribeInstanceInformation`
+ `ssm:SendCommand`

Exemplo de política do IAM:

```
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "autoscaling:DescribeAutoScalingInstances",
                "ec2:CreateImage",
                "ec2:CreateTags",
                "ec2:DescribeImages",
                :ec2:DescribeInstanceAttribute:,
                "ec2:DescribeInstances",
                "ec2:DescribeInstanceStatus",
                "ec2:DescribeInstanceTypes",
                "ec2:DeregisterImage",
                "ec2:ModifyInstanceAttribute",
                "ec2:RunInstances",
                "ec2:StartInstances",
                "ec2:StopInstances",
                "ec2:TerminateInstances",
                "iam:PassRole",
                "ssm:DescribeAutomationExecutions",
                "ssm:DescribeInstanceInformation",
                "ssm:SendCommand"
            ],
            "Resource": "*"
        }
    ]
}
```

 **Instruções** 

Siga estas etapas para configurar a automação:

1. Navegue até [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CloneXenEC2InstanceAndMigrateToNitro/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CloneXenEC2InstanceAndMigrateToNitro/description)em Systems Manager em Documentos.

1. Selecione **`Execute automation`**.

1. Para os parâmetros de entrada, insira o seguinte:
   + **AutomationAssumeRole (Opcional):**
     + Descrição: (Opcional) O ARN da função AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation execute as ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.
     + Tipo: `AWS::IAM::Role::Arn`
   + **TargetInstanceId (Obrigatório):**
     + Descrição: (Obrigatório) ID da instância de destino do Amazon EC2 que você deseja migrar para a plataforma Nitro.
     + Tipo: `AWS::EC2::Instance::Id`
   + **NitroInstanceType (Opcional):**
     + Descrição: (Opcional) Insira o tipo de instância Nitro de destino. Somente as instâncias Nitro M5, M6, C5, C6, R5, R6 e T3 são suportadas (por exemplo, t3.small). Padrão: m5.xlarge.
     + Tipo: `String`
     + Allowed-pattern: `^(m5a?z?d?n?|c5a?d?n?|r5a?d?n?b?|(c|m|r)6(a|i)?d?)\\.(2|4|8|12|16|24|32)?xlarge$|^t3a?\\.((x|2x)?large|nano|micro|small|medium)$`
     + Padrão: `m5.xlarge`
   + **SNSTopicArn (obrigatório):**
     + Descrição: (Obrigatório) Forneça o ARN do tópico do Amazon SNS para notificação de aprovação. Esse tópico do Amazon SNS é usado para enviar notificações de aprovação durante a execução da automação.
     + Tipo: `String`
     + Allowed-pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-iso(-[a-z])?):sns:(us(-gov|-isob?)?|ap|ca|af|me|cn|eu|sa)-(central|(north|south)?(east|west)?)-\\d:\\d{12}:[a-zA-Z0-9_.-]{1,256}$`
   + **ApprovERIA (obrigatório):**
     + Descrição: (Obrigatório) Forneça uma lista de diretores AWS autenticados que possam aprovar ou rejeitar a ação. O número máximo de aprovadores é 10.
     + Tipo: `StringList`
     + Allowed-pattern: `^[a-zA-Z0-9_+=,.@\\-\/]{1,128}$|^arn:(aws|aws-cn|aws-us-gov|aws-iso(-[a-z])?):(sts|iam)::[0-9]{12}:[a-zA-Z0-9_+=,.@\\-\/]{1,256}$`
   + **MinimumRequiredApprovals (Opcional):**
     + Descrição: (Opcional) O número mínimo de aprovações necessárias para retomar a automação. Padrão: 1.
     + Tipo: inteiro
     + Padrão: 1
   + **DeleteResourcesOnFailure (Opcional):**
     + Descrição: (Opcional) Se a instância clonada do Amazon EC2 deve ser encerrada AMI e se a automação falhar.
     + Tipo: `Boolean`
     + Valores permitidos: `[true, false]`
     + Padrão: `true`
   + **Reconhecimento (obrigatório):**
     + Descrição: (Obrigatório) Leia os detalhes completos das ações realizadas por este runbook de automação e escreva “Sim, eu entendo e reconheço” se você reconhece as etapas.
     + Tipo: `String`
     + Allowed-pattern: `^Yes, I understand and acknowledge$`
   + **AllowInstanceStoreInstances (Opcional):**
     + Descrição: (opcional) se você especificar `yes`, o runbook é executado em instâncias que têm volumes de armazenamento de instâncias anexados. **Aviso:** os dados nos volumes de armazenamento de instâncias são perdidos quando a instância é interrompida. Esse parâmetro ajuda a evitar a perda acidental de dados.
     + Tipo: `Boolean`
     + Valores permitidos: `[yes, no]`
     + Padrão: `no`

1. Selecione **Executar**.

1. A automação é iniciada.

1. O bucket realiza as seguintes etapas:
   + **`checkConcurrency`**:

     Garante que haja apenas uma execução desse runbook direcionada à instância atual do Amazon EC2.
   + **`getTargetInstanceProperties`**:

     Busca os detalhes da instância de destino do Amazon EC2.
   + **`checkIfNitroInstanceTypeIsSupportedInAZ`**:

     Determina se o tipo de instância Nitro de destino é suportado na mesma zona de disponibilidade da instância de destino do Amazon EC2.
   + **`createTestImage`**:

     Cria um teste AMI a partir da instância fornecida.
   + **`launchTestInstanceInSameSubnet`**:

     Lança uma instância de teste do Amazon EC2 a partir do teste AMI usando a mesma configuração da instância de destino do Amazon EC2.
   + **`approvalToStopTargetInstance`**:

     Aguarda a aprovação dos diretores designados para interromper a instância de destino.
   + **`createBackupImage`**:

     Cria um a AMI partir da instância fornecida para backup.
   + **`launchInstanceInSameSubnet`**:

     Lança uma nova instância do Amazon EC2 a partir do backup AMI usando a mesma configuração da instância de origem do Amazon EC2.
   + **`checkAndInstallENADrivers`**:

     Determina a disponibilidade dos drivers do Enhanced Networking Adapter (ENA) na instância do Amazon EC2 e instala, se estiverem ausentes.
   + **`checkAndAddNVMEDrivers`**:

     Determina a disponibilidade dos drivers NVMe na instância clonada do Amazon EC2 e instala, se estiverem ausentes.
   + **`checkAndModifyFSTABEntries`**:

     Determina se o nome do dispositivo é usado `/etc/fstab` e o substitui pelo nome deles UUIDs, se encontrado.
   + **`setNitroInstanceTypeForClonedInstance`**:

     Define o tipo de instância do Amazon EC2 de destino fornecido para a instância clonada do Amazon EC2.
   + **`approvalForCreatingImageAfterDriversInstallation`**:

     Aguarda a aprovação do usuário se a instância clonada do Amazon EC2 for inicializada com sucesso na plataforma Nitro.
   + **`createImageAfterDriversInstallation`**:

     Cria uma imagem da nova instância do Amazon EC2 somente se a nova instância do Amazon EC2 for inicializada com sucesso na plataforma Nitro.

1. Depois de concluído, revise a seção **Saídas** para obter os resultados detalhados da execução.

**Referências**

AWS Systems Manager Automation
+ [Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CloneXenEC2InstanceAndMigrateToNitro/description)
+ [Executar uma automação](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Configurar a automação](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Fluxos de trabalho de automação de suporte](https://aws.amazon.com/premiumsupport/technology/saw/)