View a markdown version of this page

Hook del ciclo di vita per le implementazioni di servizi Amazon ECS - Amazon Elastic Container Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Hook del ciclo di vita per le implementazioni di servizi Amazon ECS

Quando una distribuzione inizia, procede attraverso le fasi del ciclo di vita. Ogni fase può trovarsi in uno stato come IN_PROGRESS o SUCCEEDED. È possibile configurare gli hook del ciclo di vita in fasi specifiche per eseguire una logica personalizzata o introdurre punti decisionali prima che la distribuzione proceda. Amazon ECS supporta due tipi di ganci del ciclo di vita:

ganci Lambda

Amazon ECS richiama una funzione Lambda in fasi specifiche di una distribuzione. La funzione contiene la logica personalizzata e deve restituire un oggetto JSON contenente un hookStatus di SUCCEEDED, FAILED, o IN_PROGRESS per indicare ad Amazon ECS come procedere. Puoi utilizzare questi hook per eseguire test di convalida, applicare politiche di governance o implementare passaggi di approvazione personalizzati prima che la distribuzione proceda. Per ulteriori informazioni, consulta Hook Lambda per distribuzioni di servizi Amazon ECS.

Metti in pausa gli hook

Amazon ECS sospende la distribuzione in una fase del ciclo di vita configurata e attende che tu chiami il ContinueServiceDeployment API per continuare o ripristinare. Mentre sei in pausa, puoi eseguire i tuoi flussi di lavoro esternamente, ad esempio approvazioni manuali, test di integrazione con strumenti esistenti, controlli di disponibilità operativa o CI/CD fasi della pipeline. Per ulteriori informazioni, consulta Metti in pausa gli hook per le distribuzioni dei servizi Amazon ECS.

Puoi configurare sia gli hook Lambda che gli hook di pausa nella stessa fase del ciclo di vita. Entrambi gli hook devono essere completati prima che la distribuzione proceda alla fase successiva.

Dettagli degli hook relativi al ciclo di vita

Quando gli hook sono attivi durante una distribuzione, puoi visualizzarne lo stato chiamando DescribeServiceDeployments. La risposta include un lifecycleHookDetails matrice con i seguenti campi per ogni hook attivo:

Campo Description
hookId L'identificatore univoco per questa esecuzione dell'hook. Usa questo valore quando chiami ContinueServiceDeployment per i ganci di pausa.
targetType Il tipo di gancio: AWS_LAMBDA o PAUSE.
targetArn L'ARN del bersaglio del gancio. Per gli hook Lambda, questo è l'ARN della funzione Lambda. Per i pause hook, questo campo non è impostato.
status Lo stato attuale del gancio: AWAITING_ACTION, IN_PROGRESS, SUCCEEDED, FAILED, o TIMED_OUT.
expiresAt La data e l'ora di scadenza dell'hook. (Esempio: 2026-05-06T12:06:49-07:00)
timeoutAction L'azione intrapresa da Amazon ECS al termine del timeout: ROLLBACK o CONTINUE.

Categorie della fase del ciclo di vita

Le fasi del ciclo di vita rientrano in due categorie:

  1. Fasi di invocazione singola - Amazon ECS richiama queste fasi solo una volta durante l'implementazione di un servizio:

    • RECONCILE_SERVICE

    • PRE_SCALE_UP

    • POST_SCALE_UP

    • TEST_TRAFFIC_SHIFT

    • POST_TEST_TRAFFIC_SHIFT

    • POST_PRODUCTION_TRAFFIC_SHIFT

  2. Fasi di richiamo ricorrenti - Amazon ECS può richiamare queste fasi più volte durante l'implementazione di un servizio. Per le distribuzioni lineari e canarie, queste fasi vengono richiamate in ogni fase di spostamento del traffico:

    • PRE_PRODUCTION_TRAFFIC_SHIFT

    • PRODUCTION_TRAFFIC_SHIFT

Nota

I pause hook non possono essere configurati in TEST_TRAFFIC_SHIFT o PRODUCTION_TRAFFIC_SHIFT perché queste fasi vengono richiamate anche durante il rollback. La pausa durante un rollback richiederebbe un'ulteriore ContinueServiceDeployment chiamata per completare il rollback.

Fasi supportate per tipo di gancio

Fase del ciclo di vita Ganci Lambda Metti in pausa i ganci
RECONCILE_SERVICE Sì Sì
PRE_SCALE_UP Sì Sì
POST_SCALE_UP Sì Sì
TEST_TRAFFIC_SHIFT Sì No
POST_TEST_TRAFFIC_SHIFT Sì Sì
PRE_PRODUCTION_TRAFFIC_SHIFT Sì Sì
PRODUCTION_TRAFFIC_SHIFT Sì No
POST_PRODUCTION_TRAFFIC_SHIFT Sì Sì