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

Escolha 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"
    }
  ]
}

Selecione Next: Tags (Próximo: Tags) e, em seguida,Next: Review (Próximo: Análise).

Em Name (Nome), insira LogAutoScalingEvent-policy. Escolha Create policy (Criar política).

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

Selecione Create role (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 o nome da política AWSLambdaBasicExecutionRole. Em seguida, escolha Next (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.

Escolha Change default execution role (Alterar a função de execução padrão) e, em Execution role (Função de execução), escolha Use an existing role (Usar uma função existente).

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

Deixe os outros valores padrão.

Escolha Create function (Criar função). Você é retornado ao código e configuração da função.

Com sua função LogAutoScalingEvent ainda aberta no console, em Function code (Código da função), no editor, cole o seguinte código de exemplo no arquivo chamado index.js.

var aws = require("aws-sdk");
exports.handler = (event, context, callback) => {
    console.log('LogAutoScalingEvent');
    console.log('Received event:', JSON.stringify(event, null, 2));
    var autoscaling = new aws.AutoScaling({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; 
    autoscaling.completeLifecycleAction(params, function(err, data) {
        if (err) { 
            console.log(err, err.stack); // an error occurred
            response = {
                statusCode: 500,
                body: JSON.stringify('ERROR'),
            };
        } else {
            console.log(data);           // successful response
            response = {
                statusCode: 200,
                body: JSON.stringify('SUCCESS'),
            };
        }
    });
    return response;
};

Esse código simplesmente registra o evento para que, no final deste tutorial, você possa ver um evento aparecendo no fluxo de CloudWatch logs que está associado a essa função do Lambda.

Escolha Implantar.

Abra o console do EventBridge.

No painel de navegação, escolha Rules (Regras).

Escolha Create rule (Criar regra).

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

1. Em Name (Nome), insira LogAutoScalingEvent-rule.

2. Em Event Bus (Barramento de eventos), escolha default (padrão). Quando um AWS service (Serviço da AWS) em sua conta gerar um evento, ele sempre irá para o barramento de eventos padrão da sua conta.

3. Em Rule type (Tipo de regra), escolha Rule with an event pattern (Regra com um padrão de evento).

4. Escolha Next (Próximo).

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

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

2. Em Event pattern (Padrão de evento), faça o seguinte:

   1. Para Event source (Origem do evento), 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 do Auto Scaling específico, escolha Specific group name(s) (Nomes de grupos específicos) e selecione um ou mais grupos do Auto Scaling.

   6. Escolha Next (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 Review and create (Revisar e criar), escolha Create (Criar).

Abra a página Auto Scaling groups (grupos do Auto Scaling) no 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 Auto Scaling groups (Grupos do Auto Scaling).

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, faça o seguinte:

1. Em Lifecycle hook 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 do Lambda.

Escolha Create (Criar).

Abra a página Auto Scaling groups (grupos do Auto Scaling) no 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.

Escolha Update (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 de 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 Auto Scaling groups (grupos do Auto Scaling) no 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 Actions, Delete.

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 Delete (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 Actions, Delete.

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 de grupos de registros do CloudWatch console.

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

Escolha 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 Delete (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 Actions, Delete.

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