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á.
AWSPremiumSupport-ChangeInstanceTypeIntelToAMD
Descrição
O runbook AWSPremiumSupport-ChangeInstanceTypeIntelToAMD
automatiza as migrações das instâncias do Amazon Elastic Compute Cloud (Amazon EC2) com tecnologia Intel para os tipos equivalentes de instâncias com tecnologia AMD. Este runbook oferece suporte a instâncias de uso geral (M), de uso geral intermitente (T), otimizadas para computação (C) e otimizadas para memória (R) criadas no sistema Nitro. Este runbook pode ser usado em instâncias que não são gerenciadas pelo Systems Manager.
Para reduzir o risco potencial de perda de dados e tempo de inatividade, o runbook verifica o comportamento de parada da instância, se a instância está em um grupo do Amazon EC2 Auto Scaling, a integridade da instância e se o tipo de instância equivalente com tecnologia AMD está disponível na mesma zona de disponibilidade. Por padrão, este runbook não alterará o tipo de instância se os volumes de armazenamento de instâncias estiverem anexados ou se a instância fizer parte de uma pilha do AWS CloudFormation. Se você quiser alterar esse comportamento, especifique yes
para um dos parâmetros AllowInstanceStoreInstances
e AllowCloudFormationInstances
.
Importante
O acesso aos runbooks da AWSPremiumSupport-*
requer uma assinatura do Enterprise ou Business Support. Para obter mais informações, consulte Comparar os planos do AWS Support
Considerações
-
Recomendamos fazer backup da sua instância antes de usar este runbook.
-
A alteração do tipo de instância exige que o runbook interrompa sua instância. Quando uma instância é interrompida, todos os dados armazenados na RAM ou nos volumes de armazenamento da instância são perdidos e o endereço IPv4 público automático é liberado. Para obter mais informações, consulte Interromper e iniciar sua instância.
-
Se você não especificar um valor para o parâmetro
TargetInstanceType
, o runbook tentará identificar a instância AMD equivalente em termos de CPUs virtuais e memória dentro da mesma família de instâncias. O runbook termina se não for capaz de identificar um tipo de instância AMD equivalente. -
Ao usar a opção
DryRun
, você pode capturar o tipo de instância AMD equivalente e validar os requisitos sem realmente alterar o tipo de instância.
Execute esta automação (console)
Tipo de documento
Automation
Proprietário
Amazon
Plataformas
Linux, macOS, Windows
Parâmetros
-
AutomationAssumeRole
Tipo: sequência
Descrição: (opcional) 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. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.
-
Reconhecer
Tipo: sequência
Descrição: (obrigatório) digite
yes
para confirmar que sua instância de destino será interrompida se estiver em execução. -
InstanceId
Tipo: sequência
Descrição: (obrigatório) o ID da instância do Amazon EC2 cujo tipo você deseja alterar.
-
TargetInstanceType
Tipo: sequência
Padrão: automático
Descrição: (opcional) o tipo de instância AMD para a qual você deseja alterar sua instância. O valor
automatic
padrão usa o tipo de instância equivalente em termos de CPUs virtuais e memória. Por exemplo, um m5.large seria alterado para m5a.large. -
AllowInstanceStoreInstances
Tipo: sequência
Valores válidos: não | sim
Padrão: não
Descrição: (opcional) se você especificar
yes
, o runbook é executado em instâncias que têm volumes de armazenamento de instâncias anexados. -
AllowCloudFormationInstances
Tipo: sequência
Valores válidos: não | sim
Padrão: não
Descrição: (opcional) se definido como
yes
, o runbook é executado em instâncias que fazem parte de uma pilha do AWS CloudFormation. -
AllowCrossGeneration
Tipo: sequência
Valores válidos: não | sim
Padrão: não
Descrição: (opcional) se definido como
yes
, o runbook tenta encontrar o tipo de instância AMD equivalente mais recente dentro da mesma família de instâncias. -
DryRun
Tipo: sequência
Valores válidos: não | sim
Padrão: não
Descrição: (opcional) se definido como
yes
, o runbook retorna o tipo de instância AMD equivalente e valida os requisitos de migração sem fazer alterações no tipo de instância. -
SleepWait
Tipo: sequência
Padrão: PT3S
Descrição: (opcional) o tempo que o runbook deve esperar antes de iniciar uma nova automação. O valor fornecido para esse parâmetro deve corresponder ao padrão ISO 8601. Para obter mais informações sobre a criação de sequências de caracteres ISO 8601, consulte Formatar strings de data e hora para o Systems Manager.
Permissões obrigatórias do IAM
O parâmetro AutomationAssumeRole
requer as seguintes ações para usar o runbook com êxito.
-
ssm:DescribeAutomationExecutions
-
ssm:GetAutomationExecution
-
ssm:StartAutomationExecution
-
ec2:GetInstanceTypesFromInstanceRequirements
-
ec2:DescribeInstanceAttribute
-
ec2:DescribeInstances
-
ec2:DescribeInstanceStatus
-
ec2:DescribeInstanceTypeOfferings
-
ec2:DescribeInstanceTypes
-
ec2:DescribeTags
-
ec2:ModifyInstanceAttribute
-
ec2:StartInstances
-
ec2:StopInstances
Etapas do documento
-
aws:assertAwsResourceProperty
: confirma que o status da instância de destino do Amazon EC2 érunning
,pending
,stopped
oustopping
. Caso contrário, a automação termina. -
aws:executeAwsApi
: reúne propriedades da instância de destino do Amazon EC2. -
aws:branch
: ramifica a automação com base no estado da instância do Amazon EC2.-
Se
stopped
oustopping
, a automação executaaws:waitForAwsResourceProperty
até que a instância do Amazon EC2 seja totalmente interrompida. -
Se
running
oupending
, a automação executaaws:waitForAwsResourceProperty
até que a instância do Amazon EC2 passe as verificações de status.
-
-
aws:assertAwsResourceProperty
: confirma que a instância do Amazon EC2 não faz parte de um grupo do Auto Scaling verificando se a tagaws:autoscaling:groupName
está aplicada. -
aws:executeAwsApi
: reúne as propriedades do tipo de instância atual para encontrar o tipo de instância AMD equivalente. -
aws:assertAwsResourceProperty
: confirma que um código de produto do AWS Marketplace não está associado à instância do Amazon EC2. Alguns produtos não estão disponíveis em todos os tipos de instâncias. -
aws:branch
: ramifica a automação dependendo se você deseja que a automação verifique se a instância do Amazon EC2 faz parte de uma pilha do AWS CloudFormation-
Se a tag
aws:cloudformation:stack-name
for aplicada à instância, a automação executaaws:assertAwsResourceProperty
para confirmar que a instância não faz parte de uma pilha do AWS CloudFormation.
-
-
aws:branch
: ramifica a automação com base no fato de o tipo de volume raiz da instância ser Amazon Elastic Block Store (Amazon EBS). -
aws:assertAwsResourceProperty
: confirma se o comportamento de desligamento da instância éstop
, e nãoterminate
. -
aws:executeScript
: confirma que há apenas uma automação desse runbook direcionada à instância atual. Se outra automação já estiver em andamento visando a mesma instância, ela retornará um erro e terminará. -
aws:executeAwsApi
: retorna uma lista dos tipos de instância AMD com a mesma quantidade de memória e vCPUs. -
aws:executeScript
: verifica se o tipo de instância atual é compatível e retorna o tipo de instância AMD equivalente. Se não houver equivalente, a automação termina. -
aws:executeScript
: confirma que o tipo de instância AMD está disponível na mesma zona de disponibilidade e verifica as permissões do IAM fornecidas. -
aws:branch
: ramifica a automação com base no valor do parâmetroDryRun
seryes
. -
aws:branch
: verifica se o tipo de instância original e de destino são iguais. Se forem iguais, a automação termina. -
aws:executeAwsApi
: obtém o estado atual da instância. -
aws:changeInstanceState
: interrompe a instância do Amazon EC2. -
aws:changeInstanceState
: força a instância a parar se ela estiver presa no estado de parada. -
aws:executeAwsApi
: altera o tipo de instância para o tipo de instância AMD de destino. -
aws:sleep
: espera três segundos após alterar o tipo de instância para uma eventual consistência. -
aws:branch
: ramifica a automação com base no estado anterior da instância. Se foirunning
, a instância é iniciada.-
aws:changeInstanceState
: inicia a instância do Amazon EC2 se ela estava em execução antes de alterar o tipo de instância. -
aws:waitForAwsResourceProperty
: espera que a instância do Amazon EC2 passe nas verificações de status. Se a instância não passar nas verificações de status, altere-a de volta para seu tipo original.-
aws:changeInstanceState
: interrompe a instância do Amazon EC2 antes de alterá-la para seu tipo original. -
aws:changeInstanceState
: força a instância do Amazon EC2 a parar antes de alterá-la para o tipo de instância original, caso ela fique presa em um estado de parada. -
aws:executeAwsApi
: altera a instância do Amazon EC2 para seu tipo original. -
aws:sleep
: espera três segundos após alterar o tipo de instância para uma eventual consistência. -
aws:changeInstanceState
: inicia a instância do Amazon EC2 se ela estava em execução antes de alterar o tipo de instância. -
aws:waitForAwsResourceProperty
: espera que a instância do Amazon EC2 passe nas verificações de status.
-
-
-
aws:sleep
: espera antes de terminar o runbook.