Preparar para adicionar um gancho do ciclo de vida a um grupo do Auto Scaling

Crie uma função do Lambda usando o console do Lambda e observe seu nome de recurso da Amazon (ARN). Por exemplo, arn:aws:lambda:region:123456789012:function:my-function. Você precisa do ARN para criar um destino do EventBridge. Para obter mais informações, consulte Conceitos básicos do Lambda no Guia do desenvolvedor do AWS Lambda.

Para criar uma regra que faça a correspondência com eventos para inicialização de instâncias, use o seguinte comando put-rule.

aws events put-rule --name my-rule --event-pattern file://pattern.json --state ENABLED

O exemplo a seguir mostra o pattern.json de uma ação do ciclo de vida de execício ução de instância. Substitua o texto em itálico pelo nome do grupo do Auto Scaling.

{
  "source": [ "aws.autoscaling" ],
  "detail-type": [ "EC2 Instance-launch Lifecycle Action" ],
  "detail": {
      "AutoScalingGroupName": [ "my-asg" ]
   }
}

Se o comando for executado com êxito, o EventBridge responderá com o ARN da regra. Anote esse ARN. Você vai precisar dele na etapa 4.

Para criar uma regra que faça a correspondência com outros eventos, modifique o padrão de evento. Para obter mais informações, consulte Usar o EventBridge para lidar com eventos do Auto Scaling.

Para especificar a função do Lambda a ser usada como destino para a regra, use o seguinte comando put-targets.

aws events put-targets --rule my-rule --targets Id=1,Arn=arn:aws:lambda:region:123456789012:function:my-function

No comando anterior, my-rule é o nome que você especificou para a regra na etapa 2, enquanto o valor para o parâmetro Arn é o ARN da função que você criou na etapa 1.

Para adicionar permissões que deixem a regra invocar sua função do Lambda, use o seguinte comando add-permission do Lambda. Esse comando confia na entidade principal do serviço do EventBridge (events.amazonaws.com) e nas permissões de escopo para a regra especificada.

aws lambda add-permission --function-name my-function --statement-id my-unique-id \
  --action 'lambda:InvokeFunction' --principal events.amazonaws.com --source-arn arn:aws:events:region:123456789012:rule/my-rule

No comando anterior:

Se o comando for executado com êxito, você receberá um resultado semelhante a este.

{
  "Statement": "{\"Sid\":\"my-unique-id\",
    \"Effect\":\"Allow\",
    \"Principal\":{\"Service\":\"events.amazonaws.com\"},
    \"Action\":\"lambda:InvokeFunction\",
    \"Resource\":\"arn:aws:lambda:us-west-2:123456789012:function:my-function\",
    \"Condition\":
      {\"ArnLike\":
        {\"AWS:SourceArn\":
         \"arn:aws:events:us-west-2:123456789012:rule/my-rule\"}}}"
}

O valor de Statement é uma versão da string JSON da instrução adicionada à política da função do Lambda.

Depois que você tiver seguido estas instruções, prossiga para Preparar para adicionar um gancho do ciclo de vida a um grupo do Auto Scaling como próxima etapa.

Crie um tópico do Amazon SNS usando o console do Amazon SNS ou o seguinte comando create-topic. Verifique se o tópico está na mesma região do grupo do Auto Scaling que você está usando. Para obter mais informações, consulte Conceitos básicos do Amazon SNS no Guia do desenvolvedor do Amazon Simple Notification Service.

aws sns create-topic --name my-sns-topic

Observe o nome de recurso da Amazon (ARN) do tópico, por exemplo, arn:aws:sns:region:123456789012:my-sns-topic. Você precisa dele para criar o gancho do ciclo de vida.

Crie uma função de serviço do IAM para dar ao Amazon EC2 Auto Scaling acesso ao seu destino de notificação do Amazon SNS.

Para dar ao Amazon EC2 Auto Scaling acesso ao seu tópico do SNS

1. Abra o console do IAM, em https://console.aws.amazon.com/iam/.

2. No painel de navegação à esquerda, escolha Roles (Funções).

3. Selecione Criar perfil.

4. Em Select trusted entity (Selecionar entidade confiável), escolha AWS service (serviço).

5. Para seu caso de uso, em Use cases for other AWS services (Casos de uso de outros produtos), escolha EC2 Auto Scaling e depois EC2 Auto Scaling Notification Access (Acesso à notificação do EC2 Auto Scaling).

6. Escolha Next (Próximo) duas vezes para ir até a página Name, review, and create (Nomear, revisar e criar).

7. Em Role name (Nome da função), insira um nome para a função (por exemplo, my-notification-role) e escolha Create role (Criar função).

8. Na página Roles (Funções), escolha a função recém-criada para abrir a página Summary (Resumo). Anote o Role ARN (ARN da função). Por exemplo, arn:aws:iam::123456789012:role/my-notification-role. Você precisa dele para criar o gancho do ciclo de vida.

Depois que você tiver seguido estas instruções, prossiga para Adicionar ganchos do ciclo de vida (AWS CLI) como próxima etapa.

Crie uma fila do Amazon SQS usando o console do Amazon SQS. Verifique se a fila está na mesma região do grupo do Auto Scaling que você está usando. Para obter mais informações, consulte Conceitos básicos do Amazon SQS no Guia do desenvolvedor do Amazon Simple Queue Service.

Observe o ARN da fila, por exemplo, arn:aws:sqs:us-west-2:123456789012:my-sqs-queue. Você precisa dele para criar o gancho do ciclo de vida.

Crie uma função de serviço do IAM para dar ao Amazon EC2 Auto Scaling acesso ao seu destino de notificação do Amazon SQS.

Para dar ao Amazon EC2 Auto Scaling acesso à sua fila do SQS

1. Abra o console do IAM, em https://console.aws.amazon.com/iam/.

2. No painel de navegação à esquerda, escolha Roles (Funções).

3. Selecione Criar perfil.

4. Em Select trusted entity (Selecionar entidade confiável), escolha AWS service (serviço).

5. Para seu caso de uso, em Use cases for other AWS services (Casos de uso de outros produtos), escolha EC2 Auto Scaling e depois EC2 Auto Scaling Notification Access (Acesso à notificação do EC2 Auto Scaling).

6. Escolha Next (Próximo) duas vezes para ir até a página Name, review, and create (Nomear, revisar e criar).

7. Em Role name (Nome da função), insira um nome para a função (por exemplo, my-notification-role) e escolha Create role (Criar função).

8. Na página Roles (Funções), escolha a função recém-criada para abrir a página Summary (Resumo). Anote o Role ARN (ARN da função). Por exemplo, arn:aws:iam::123456789012:role/my-notification-role. Você precisa dele para criar o gancho do ciclo de vida.

Depois que você tiver seguido estas instruções, prossiga para Adicionar ganchos do ciclo de vida (AWS CLI) como próxima etapa.

Abra a página Functions (Funções) no console do Lambda.

Escolha a função do Lambda que você deseja.

Se você quiser criar uma nova função do Lambda, consulte Criar a função do Lambda

Escolha a guia Configuração e, em seguida, Permissões.

Role para baixo até Resource-based policy (Política baseada em recurso) e, em seguida, escolha Add permissions (Adicionar permissões). Uma política baseada em recurso é usada para conceder permissões para invocar sua função no principal que é especificado na política. Neste caso, o principal será o perfil vinculado ao serviço do Amazon EC2 Auto Scaling que está associada ao grupo do Auto Scaling.

Na seção Policy statement (Declaração da política), configure suas permissões:

1. Selecione Conta da AWS.

2. Em Principal insira o ARN da função vinculada a serviço de chamada, por exemplo, arn:aws:iam::<aws-account-id>:role/aws-service-role/autoscaling.amazonaws.com/AWSServiceRoleForAutoScaling.

3. Em Action (Ação), escolha lambda:InvokeFunction.

4. Em Statement ID (ID da instrução), insira um ID de instrução exclusivo, como AllowInvokeByAutoScaling.

5. Escolha Salvar.

Depois que você tiver seguido estas instruções, prossiga para Adicionar ganchos do ciclo de vida (AWS CLI) como próxima etapa.