Tutorial: Configurar um gancho do ciclo de vida que invoca uma função do Lambda

Abra a página Policies (Políticas) do console do IAM e escolha Create policy (Criar política).

Selecione a guia JSON.

Na caixa Policy Document (Documento da política), cole o documento de política a seguir na caixa, substituindo o texto em itálico pelo o número de conta e o nome do grupo do Auto Scaling.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "autoscaling:CompleteLifecycleAction"
      ],
      "Resource": "arn:aws:autoscaling:*:123456789012:autoScalingGroup:*:autoScalingGroupName/my-asg"
    }
  ]
}

Escolha Próximo.

Em Nome da política, insira LogAutoScalingEvent-policy. Escolha Criar política.

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

Selecione Criar função.

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

Para seu caso de uso, escolha Lambda e escolha Next (Próximo).

Em Adicionar permissões, escolha a política que você criou (LogAutoScalingEvent-policy) e a política nomeada AWSLambdaBasicExecutionRole. Em seguida, escolha Próximo.

Na página Name, review, and create (Nomear, revisar e criar), em Role name (Nome da função), insira LogAutoScalingEvent-role e escolha Create role (Criar função).

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

Escolha Create function (Criar função) e Author from scratch (Criar desde o início).

Em Basic information (Informações básicas), em Function name (Nome da função), insira LogAutoScalingEvent.

Em Runtime, selecione Node.js 18.x.

Role para baixo e escolha Alterar função de execução padrão e, em seguida, para Função de execução, escolha Usar uma função existente.

Em Função existente, escolha LogAutoScalingEvent-role.

Deixe os outros valores padrão.

Escolha a opção Criar função. Você é retornado ao código e configuração da função.

Com sua LogAutoScalingEvent função ainda aberta no console, em Código-fonte, no editor, cole o código de exemplo a seguir no arquivo denominado index.mjs.

import { AutoScalingClient, CompleteLifecycleActionCommand } from "@aws-sdk/client-auto-scaling";
export const handler = async(event) => {
  console.log('LogAutoScalingEvent');
  console.log('Received event:', JSON.stringify(event, null, 2));
  var autoscaling = new AutoScalingClient({ region: event.region });
  var eventDetail = event.detail;
  var params = {
    AutoScalingGroupName: eventDetail['AutoScalingGroupName'], /* required */
    LifecycleActionResult: 'CONTINUE', /* required */
    LifecycleHookName: eventDetail['LifecycleHookName'], /* required */
    InstanceId: eventDetail['EC2InstanceId'],
    LifecycleActionToken: eventDetail['LifecycleActionToken']
  };
  var response;
  const command = new CompleteLifecycleActionCommand(params);
  try {
    var data = await autoscaling.send(command);
    console.log(data); // successful response
    response = {
      statusCode: 200,
      body: JSON.stringify('SUCCESS'),
    };
  } catch (err) {
    console.log(err, err.stack); // an error occurred
    response = {
      statusCode: 500,
      body: JSON.stringify('ERROR'),
    };
  }
  return response;
};

Esse código simplesmente registra o evento para que, no final deste tutorial, você possa ver um evento aparecer no stream de CloudWatch registros de registros associado a essa função Lambda.

Escolha Implantar.

Abra o console de EventBridge.

No painel de navegação, escolha Regras.

Escolha Criar Regra.

Em Define rule detail (Definir detalhe da regra), faça o seguinte:

1. Em Nome, digite LogAutoScalingEvent-rule.

2. Em Event Bus (Barramento de eventos), escolha default (padrão). Quando um AWS service (Serviço da AWS) em sua conta gera um evento, ele sempre vai para o ônibus de eventos padrão da sua conta.

3. Em Tipo de Regra, escolha Regra com Padrão de Evento.

4. Escolha Próximo.

Em Build event pattern (Criar padrão de evento), faça o seguinte:

1. Em Origem do evento, escolha AWS eventos ou eventos de EventBridge parceiros.

2. Role para baixo até o Padrão de eventos e faça o seguinte:

3. 1. Em Event source, escolha Serviços da AWS.

   2. Em AWS service (Serviço da AWS), escolha Auto Scaling.

   3. Em Event type (Tipo de evento), selecione Instance Launch and Terminate (Inicialização e encerramento de instância).

   4. Por padrão, a regra faz a correspondência com qualquer evento de aumento ou redução horizontal da escala. Para criar uma regra que notifique você quando houver um evento de aumento horizontal da escala e uma instância for colocada em estado de espera devido a um gancho do ciclo de vida, escolhaSpecific instance event(s) (Eventos específicos de instância) e selecione EC2 Instance-launch Lifecycle Action (Ação de ciclo de vida de inicialização de instância do EC2).

   5. Por padrão, a regra corresponde a qualquer grupo do Auto Scaling na região. Para fazer com que a regra corresponda a um grupo específico do Auto Scaling, escolha Nome(s) de grupo específico(s) e selecione o grupo.

   6. Escolha Próximo.

Em Select target(s) (Selecionar destino(s)), faça o seguinte:

1. Em Target types (Tipos de destino), escolha AWS service (Serviço da AWS).

2. Em Select a target (Selecionar um destino), escolha Lambda function (Função do Lambda).

3. Em Função, escolha LogAutoScalingEvent.

4. Escolha Next (Próximo) duas vezes.

Na página Revisar e criar, escolha Criar regra.

Abra a página de grupos do Auto Scaling do console do Amazon EC2.

Marque a caixa de seleção ao lado do seu grupo do Auto Scaling. Um painel dividido é aberto na parte inferior da página.

No painel inferior, na guia Instance management (Gerenciamento de instâncias), em Lifecycle hooks (Ganchos do ciclo de vida), escolha Create lifecycle hook (Criar gancho do ciclo de vida).

Para definir um gancho do ciclo de vida para expansão (execução de instâncias), faça o seguinte:

1. Em Lifecycle gancho name (Nome do gancho do ciclo de vida), insira LogAutoScalingEvent-hook.

2. Em Lifecycle transition (Transição do ciclo de vida), escolha Instance launch (Início da instância).

3. Em Heartbeat timeout (Tempo limite de pulsação), insira 300 para o número de segundos de espera por um retorno de chamada da sua função do Lambda.

4. Em Default result (Resultado padrão), escolha ABANDON (Abandono). Isso significa que o grupo do Auto Scaling terminará uma nova instância se o gancho expirar sem receber um retorno de chamada de sua função do Lambda.

5. (Opcional) Deixe Notification metadata (Metados da notificação) vazio. Os dados do evento para os quais passamos EventBridge contêm todas as informações necessárias para invocar a função Lambda.

Escolha Criar.

Abra a página de grupos do Auto Scaling do console do Amazon EC2.

Marque a caixa de seleção ao lado do seu grupo do Auto Scaling para visualizar detalhes em um painel inferior e ainda ver as linhas superiores do painel superior.

No painel inferior, na guia Details (Detalhes), escolha Group details (Detalhes do grupo, Edit (Editar).

Em Desired capacity (Capacidade desejada), aumente o valor atual em 1.

Selecione Atualizar. Enquanto a instância está sendo iniciada ou terminada, a coluna Status no painel superior exibe um status Updating capacity (Atualizando capacidade).

Abra a página Grupos de registros do CloudWatch console.

Selecione o nome do grupo de logs para sua função do Lambda (/aws/lambda/LogAutoScalingEvent).

Selecione o nome do fluxo de logs para visualizar os dados fornecidos pela função para a ação do ciclo de vida.

Retorne á página Auto Scaling groups (Grupos do Auto Scaling) e selecione seu grupo.

Na guia Activity (Atividade), em Activity history (Histórico de atividades), a coluna Status exibe se o seu grupo do Auto Scaling iniciou uma instância com êxito.

Abra a página de grupos do Auto Scaling do console do Amazon EC2.

Marque a caixa de seleção ao lado do seu grupo do Auto Scaling.

Na guia Instance management (Gerenciamento de instâncias), em Lifecycle hooks (Ganchos do ciclo de vida), escolha o gancho do ciclo de vida (LogAutoScalingEvent-hook).

Escolha Ações, Excluir.

Para confirmar, escolha Delete (Excluir) novamente.

Abra a página de regras no EventBridge console da Amazon.

Em Event bus (Barramento de eventos), escolha o barramento de eventos associado à regra (Default).

Marque a caixa de seleção ao lado da sua regra (LogAutoScalingEvent-rule).

Escolha Excluir.

Quando for solicitada confirmação, digite o nome da regra e escolha Excluir.

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

Escolha a função (LogAutoScalingEvent).

Escolha Ações, Excluir.

Quando for solicitada confirmação, digite delete para confirmar a exclusão do modelo de execução especificado e, em seguida, escolha Excluir.

Abra a página Grupos de registros do CloudWatch console.

Selecione o grupo de logs da função (/aws/lambda/LogAutoScalingEvent).

Selecione Actions (Ações), Delete log group(s) (Excluir grupo(s) de log).

Na caixa de diálogo Delete log group(s) (Excluir grupo(s) de logs), escolha Delete (Excluir).

Abra a página Roles (Funções) no console do IAM.

Selecione o papel da função (LogAutoScalingEvent-role).

Escolha Excluir.

Quando for solicitada confirmação, digite o nome da função e escolha Excluir.

Abra a página Policies (Políticas) do console do IAM.

Selecione a política que você criou (LogAutoScalingEvent-policy).

Escolha Ações, Excluir.

Quando for solicitada confirmação, digite o nome da política e escolha Excluir.