Hook del ciclo di vita 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 SUCCESSFUL. È possibile utilizzare gli hook del ciclo di vita, che sono funzioni Lambda che Amazon ECS esegue in fasi del ciclo di vita specifiche. Le funzioni possono essere le seguenti:

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

Al termine dell'esecuzione della funzione, essa deve restituire un hookStatus affinché l'implementazione continui. Se non viene restituito un hookStatus o se la funzione ha esito negativo, l'implementazione viene ripristinata. Di seguito sono riportati i valori hookStatus:

SUCCEEDED: l'implementazione continua fino alla fase successiva del ciclo di vita
FAILED: l'implementazione torna all'ultima 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 callBackDelay insieme a hookStatus.

Nell'esempio seguente viene illustrato come restituire un hookStatus con un ritardo di callback personalizzato. In questo esempio, Amazon ECS riproverebbe questo hook dopo 60 secondi invece dei 30 secondi predefiniti:



{
    "hookStatus": "IN_PROGRESS",
    "callBackDelay": 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

Payload del ciclo di vita

Quando si configurano gli hook del ciclo di vita per le implementazioni di servizi ECS, Amazon ECS richiama questi hook in fasi specifiche del processo di implementazione. Ogni fase del ciclo di vita fornisce un payload JSON con informazioni sullo stato attuale dell'implementazione. Questo documento descrive la struttura del payload per ogni fase del ciclo di vita.

Struttura comune del payload

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

serviceArn: il nome della risorsa Amazon (ARN) del servizio.
targetServiceRevisionArn: l'ARN della revisione del servizio target in fase di implementazione.
testTrafficWeights- Una mappa delle revisioni dei servizi 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.

Payload delle fasi del ciclo di vita

RECONCILE_SERVICE

Questa fase si verifica all'inizio del processo di implementazione quando il servizio viene riconciliato. Di seguito viene riportato 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
  }
}