Tutorial : Configurazione di un hook del ciclo di vita che richiama una funzione Lambda

Nella console IAM, apri Policies (Policy), quindi seleziona Create policy (Crea policy).

Scegli la scheda JSON.

Nella casella Policy Document (Documento policy), incolla il documento della policy nella casella, sostituendo il testo in corsivo con il numero di account e il nome del gruppo con scalabilità automatica.

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

Seleziona Successivo.

In Policy name (Nome policy), inserisci LogAutoScalingEvent-policy. Scegli Create Policy (Crea policy).

Nel riquadro di navigazione sulla sinistra, scegliere Roles (Ruoli).

Scegli Crea ruolo.

In Seleziona tipo di entità attendibile, scegli Servizio AWS .

Per il tuo caso d'uso, scegli Lambda quindi scegli Successivo.

In Aggiungi autorizzazioni, scegli la politica che hai creato (LogAutoScalingEvent-policy) e la politica denominata. AWSLambdaBasicExecutionRole Quindi, seleziona Next (Successivo).

Nella pagina Nome, revisione e creazione, per Nome ruolo, inserisci LogAutoScalingEvent-role e scegli Crea ruolo.

Aprire la pagina Functions (Funzioni) nella console Lambda.

Scegli Create function (Crea funzione) e Author from scratch (Crea da zero).

In Basic information (Informazioni di base) , per Function name (Nome funzione) , inserisci LogAutoScalingEvent.

Per Runtime, scegli Node.js 18.x.

Scorri verso il basso e scegli Cambia ruolo di esecuzione predefinito e in Ruolo di esecuzione scegli Utilizza un ruolo esistente.

Per Ruolo esistente, scegli -role. LogAutoScalingEvent

Non modificare gli altri valori di default.

Scegli Crea funzione. Verrai riportato alla configurazione e al codice della funzione.

Con la funzione LogAutoScalingEvent ancora aperta nella console, in Codice della funzione, nell'editor, incolla il seguente codice di esempio nel file denominato 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;
};

Questo codice registra semplicemente l'evento in modo che, alla fine di questo tutorial, sia possibile vedere apparire un evento nel flusso di log CloudWatch Logs associato a questa funzione Lambda.

Seleziona Deploy (Implementa).

Apri la EventBridge console.

Nel pannello di navigazione, scegli Regole.

Scegli Crea regola.

Per Define rule detail (Definisci dettagli della regola), effettua le seguenti operazioni:

1. Per Nome, immetti LogAutoScalingEvent-rule.

2. Per Event bus (Bus di eventi), scegli default. Quando un Servizio AWS utente genera un evento, questo passa sempre al bus eventi predefinito del tuo account.

3. Per Rule type (Tipo di regola), scegli Rule with an event pattern (Regola con un modello di eventi).

4. Seleziona Successivo.

Per Build event pattern (Crea modello di eventi), procedi come segue:

1. Per Event source, scegli AWS eventi o eventi EventBridge partner.

2. Scorri verso il basso fino a Modello di evento ed esegui le seguenti operazioni:

3. 1. In Event source (Origine eventi), selezionare Servizi AWS.

   2. Per Servizio AWS, scegli Auto Scaling (Scalabilità automatica).

   3. In Event Type (Tipo di evento), seleziona Instance Launch and Terminate (Avvio e arresto dell'istanza).

   4. Per impostazione predefinita, la regola corrisponde a qualsiasi evento di aumento o riduzione orizzontale. Per creare una regola che ti avvisa quando esiste un evento di dimensionamento e un'istanza viene messa in stato di attesa a causa di un hook del ciclo di vita, scegli Specific instance event(s) (Evento/i di istanza specifici) e seleziona EC2 Instance-launch Lifecycle Action (Operazione del ciclo di vita per l'avvio dell'istanza EC2).

   5. Per impostazione predefinita, la regola corrisponde a qualsiasi gruppo con scalabilità automatica nella Regione. Affinché la regola corrisponda a un gruppo con dimensionamento automatico specifico, seleziona Nomi gruppi specifici, quindi seleziona il gruppo.

   6. Seleziona Successivo.

Per Select target(s) (Seleziona destinazione/i), esegui queste operazioni:

1. Per Target types (Tipi di target), scegli Servizio AWS.

2. Per Select a target (Seleziona destinazione), scegli Lambda function (Funzione Lambda).

3. Per Funzione, scegli LogAutoScalingEvent.

4. Scegliere Next (Successivo) due volte.

Nella pagina Rivedi e crea, scegli Crea regola.

Apri la pagina Gruppi con dimensionamento automatico nella console Amazon EC2.

Seleziona la casella di controllo accanto al gruppo con dimensionamento automatico. Si aprirà un riquadro diviso nella parte inferiore della pagina.

Nel riquadro inferiore, nella scheda Instance management (Gestione istanze) in Lifecycle hooks (Hook del ciclo di vita), scegli Create lifecycle hook (Crea hook del ciclo di vita).

Per definire un hook del ciclo di vita per il dimensionamento orizzontale (avvio delle istanze), procedi come descritto di seguito:

1. In Lifecycle hook name (Nome hook del ciclo di vita), inserisciLogAutoScalingEvent-hook.

2. In Lifecycle transition (Transizione ciclo di vita), scegli Instance launch (Avvia istanza).

3. In Heartbeat timeout (Timeout heartbeat), inserisci 300 per il numero di secondi di attesa della richiamata dalla funzione Lambda.

4. In Default result (Risultato di default), scegli ABANDON (ABBANDONA). Ciò significa che se l'hook va in timeout senza ricevere un callback dalla funzione Lambda, il gruppo con scalabilità automatica terminerà una nuova istanza.

5. (Facoltativo) Lascia Notification metadata (Metadati delle notifiche) vuoto. I dati degli eventi a cui passiamo EventBridge contengono tutte le informazioni necessarie per richiamare la funzione Lambda.

Scegli Crea.

Apri la pagina Gruppi con dimensionamento automatico nella console Amazon EC2.

Seleziona la casella di controllo accanto al gruppo con scalabilità automatica per visualizzare i dettagli in un riquadro inferiore e visualizzare ancora le righe superiori del riquadro superiore.

Nel riquadro inferiore, nella scheda Details (Dettagli) scegli Group details (Dettagli gruppo), Edit (Modifica).

Per Desired capacity (Capacità desiderata), aumentare il valore corrente di 1.

Scegli Aggiorna. Durante l'avvio o la terminazione di un'istanza, la colonna Status (Stato) visualizza lo stato Updating capacity (Aggiornamento della capacità.

Apri la pagina Log groups della CloudWatch console.

Seleziona il nome del gruppo di log per la funzione Lambda (/aws/lambda/LogAutoScalingEvent).

Seleziona il nome del flusso di log per visualizzare i dati forniti dalla funzione per l'istanza avviata.

Dalla pagina Auto Scaling groups (Gruppi Auto Scaling), seleziona il gruppo.

Nella scheda Activity (Attività) in Activity history (Cronologia attività), la colonna Status (Stato) indica se il gruppo con scalabilità automatica ha avviato correttamente le istanze.

Apri la pagina Gruppi con dimensionamento automatico nella console Amazon EC2.

Seleziona la casella di controllo accanto al gruppo con dimensionamento automatico.

Nella scheda Instance management (Gestione istanze) in Lifecycle hooks (Hook del ciclo di vita), scegli Create lifecycle hook (Crea hook del ciclo di vita)(LogAutoScalingEvent-hook).

Scegli Actions (Operazioni), Delete (Elimina).

Per confermare, scegli di nuovo Delete (Elimina).

Apri la pagina delle regole nella EventBridge console Amazon.

In Event bus (Bus di eventi), seleziona il bus di eventi associato alla regola (Default).

Seleziona la casella di controllo accanto alla regola (LogAutoScalingEvent-rule).

Scegli Elimina.

Quando viene richiesta la conferma, digita il nome della regola e scegli Delete (Elimina).

Aprire la pagina Functions (Funzioni) nella console Lambda.

Scegli la funzione (LogAutoScalingEvent).

Scegli Operazioni > Elimina.

Quando viene richiesta la conferma, digita delete per confermare l'eliminazione della funzione specificata e scegli Delete (Elimina).

Apri la pagina Log groups della CloudWatch console.

Scegli il gruppo di log della funzione (/aws/lambda/LogAutoScalingEvent).

Scegli Actions (Azioni), Delete log group(s) (Elimina gruppo/i di log).

Nella finestra di dialogo Delete log group(s) (Elimina gruppo/i di log) scegli Delete (Elimina).

Apri la pagina Roles (Ruoli) della console IAM.

Seleziona il ruolo della funzione (LogAutoScalingEvent-role).

Scegli Elimina.

Quando viene richiesta la conferma, digita il nome del ruolo e scegli Delete (Elimina).

Apri la pagina Policies (Policy) nella console IAM.

Seleziona la policy creata (LogAutoScalingEvent-policy).

Scegli Operazioni > Elimina.

Quando viene richiesta la conferma, digita il nome della policy e scegli Delete (Elimina).