Lifecycle hook per le implementazioni di servizi Amazon ECS

Quando inizia un'implementazione, passa attraverso le fasi del ciclo di vita. Queste fasi possono trovarsi in stati come IN_PROGRESS o in stato di successo. Puoi utilizzare i lifecycle hook, che sono funzioni Lambda che Amazon ECS esegue per tuo conto in fasi specifiche del ciclo di vita. Le funzioni possono essere una delle seguenti:

Un'API asincrona che convalida il controllo sanitario entro 15 minuti.
Un'API di sondaggio che avvia un altro processo asincrono che valuta il completamento del ciclo di vita dell'hook.

Al termine dell'esecuzione, la funzione deve restituire a affinché la distribuzione continui. hookStatus Se a non hookStatus viene restituito o se la funzione fallisce, la distribuzione viene ripristinata. I seguenti sono i hookStatus valori:

SUCCEEDED- l'implementazione continua fino alla fase successiva del ciclo di vita
FAILED— la distribuzione torna all'ultima implementazione riuscita.
IN_PROGRESS— Amazon ECS esegue nuovamente la funzione dopo un breve periodo di tempo. Per impostazione predefinita, si tratta di un intervallo di 30 secondi, tuttavia questo valore è personalizzabile restituendo un callBackDelaySeconds insieme a. hookStatus

L'esempio seguente mostra come restituire un hookStatus con un ritardo di callback personalizzato. In questo esempio, Amazon ECS riproverebbe questo hook in 60 secondi invece dei 30 secondi predefiniti:



{
    "hookStatus": "IN_PROGRESS",
    "callBackDelaySeconds": 60
}

Quando si verifica un rollback, Amazon ECS esegue gli hook del ciclo di vita per le seguenti fasi del ciclo di vita:

PRODUCTION_TRAFFIC_SHIFT
TEST_TRAFFIC_SHIFT

Carichi utili relativi al ciclo di vita

Quando configuri i lifecycle hook per le tue distribuzioni di servizi ECS, Amazon ECS richiama questi hook in fasi specifiche del processo di distribuzione. Ogni fase del ciclo di vita fornisce un payload JSON con informazioni sullo stato corrente della distribuzione. Questo documento descrive la struttura del payload per ogni fase del ciclo di vita.

Struttura comune del carico utile

I payload in tutte le fasi del ciclo di vita includono i seguenti campi comuni:

serviceArn- L'Amazon Resource Name (ARN) del servizio.
targetServiceRevisionArn- L'ARN della revisione del servizio di destinazione in fase di implementazione.
testTrafficWeights- Una mappa della revisione del servizio in base ARNs alle corrispondenti percentuali di peso del traffico di test.
productionTrafficWeights- Una mappa della revisione dei servizi in base ARNs alle corrispondenti percentuali di peso del traffico di produzione.

Carichi utili in fase di ciclo di vita

RECONCILE_SERVICE

Questa fase si verifica all'inizio del processo di distribuzione quando il servizio viene riconciliato. Di seguito viene illustrato un esempio di payload per questa fase del ciclo di vita.



{
  "serviceArn": "arn:aws:ecs:us-west-2:1234567890:service/myCluster/myService",
  "targetServiceRevisionArn": "arn:aws:ecs:us-west-2:1234567890:service-revision/myCluster/myService/01275892",
  "testTrafficWeights": {
    "arn:aws:ecs:us-west-2:1234567890:service-revision/myCluster/myService/01275892": 100,
    "arn:aws:ecs:us-west-2:1234567890:service-revision/myCluster/myService/78652123": 0
  },
  "productionTrafficWeights": {
    "arn:aws:ecs:us-west-2:1234567890:service-revision/myCluster/myService/01275892": 100,
    "arn:aws:ecs:us-west-2:1234567890:service-revision/myCluster/myService/78652123": 0
  }
}