View a markdown version of this page

Aggiornamento di un servizio in modalità Amazon ECS Express - Amazon Elastic Container Service
Comportamento di distribuzioneProcedura

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

Aggiornamento di un servizio in modalità Amazon ECS Express

Il servizio Express Mode semplifica il processo di aggiornamento del servizio fornendo opzioni configurabili per il networking, il bilanciamento del carico e l'Application Auto Scaling e orchestrando le modifiche tra questi servizi.

È possibile aggiornare il servizio Express Mode per modificare le immagini dei contenitori, regolare l'allocazione delle risorse o modificare le impostazioni di configurazione. Gli aggiornamenti vengono distribuiti utilizzando distribuzioni canarie con allarmi di rollback basati sugli allarmi per mantenere la disponibilità.

Comportamento di distribuzione

Per impostazione predefinita, un servizio Express Mode utilizza le distribuzioni Canary per garantire aggiornamenti sicuri e ripristini rapidi:

  • Viene creato un nuovo ambiente e vengono distribuite le attività con le modifiche apportate

  • Il 5% del traffico viene spostato verso il nuovo ambiente

  • I rollback basati sugli allarmi si attivano se la somma della percentuale di errori 4xx e 5xx è > 1 per 2 punti dati entro 3 minuti

  • I controlli sanitari verificano che le nuove attività siano corrette

  • Dopo 3 minuti di cottura, il 100% del traffico viene spostato verso un nuovo ambiente

  • Dopo 3 minuti di tempo di cottura per il monitoraggio, le vecchie attività vengono gradualmente interrotte e sostituite

Per ulteriori informazioni, consulta Amazon ECS Canary deployments

Procedura

  1. Apri la console all'indirizzo. https://console.aws.amazon.com/ecs/v2

  2. Nel pannello di navigazione scegliere Cluster.

  3. Nella pagina Cluster, scegli il nome del cluster che contiene il servizio Express Mode.

  4. Nella pagina dei dettagli del cluster, scegli la scheda Servizi.

  5. Configura un filtro per visualizzare i servizi in modalità Express. Per il tipo di gestione delle risorse Filter, scegli ECS.

    Un servizio Express Mode ha un badge Express accanto al nome.

  6. In Configurazione:

    1. Specificate l'immagine da utilizzare per l'applicazione. Per l'URI dell'immagine, inserisci l'URI dell'immagine. Per sfogliare le tue immagini Amazon ECR, scegli Browse ECR images, quindi procedi come segue:

      1. Per Archivio privato, scegli l'archivio privato Amazon ECR.

      2. Per Image, scegli la tua immagine.

      3. Scegli come identificare l'immagine. Per Seleziona immagine per, scegli una delle seguenti opzioni:

        • AWS consiglia di scegliere Image digest.

        • Per usare il tag, scegli il tag Image, quindi scegli il tag.

    2. Per utilizzare un registro privato, seleziona Registro privato. Quindi, per Secrets Manager ARN o name, inserisci l'ARN di Secrets Manager che hai creato nei prerequisiti.

    3. Per il ruolo di esecuzione delle attività, scegli i ruoli o crea un nuovo ruolo e aggiorna. È possibile aggiornare il ruolo di esecuzione dell'attività quando è necessario aggiungere autorizzazioni aggiuntive.

  7. In Configurazioni aggiuntive, personalizza il tuo servizio.

    1. In Contenitore:

      1. Per Container port, aggiorna la porta su cui l'applicazione è in ascolto (l'impostazione predefinita è 80).

      2. Per Health check path, aggiorna il percorso per i controlli sanitari (ad esempio,/health).

    2. In Variabili di ambiente, aggiungi coppie chiave-valore per le variabili di ambiente di cui la tua applicazione ha bisogno:

      1. Per Key, inserisci il nome della variabile di ambiente.

      2. Per Tipo di valore, scegliete Variabile di ambiente o Segreto.

      3. Per Valore o valore da, inserite il valore o il riferimento.

      4. Scegliete Aggiungi variabile di ambiente per aggiungere altre variabili secondo necessità.

    3. Per Command, inserisci facoltativamente un comando personalizzato per sovrascrivere l'istruzione Docker CMD.

    4. Per il ruolo Task, aggiungi un ruolo IAM che concede le autorizzazioni all'applicazione in esecuzione nei tuoi contenitori. Ciò consente all'applicazione di effettuare chiamate API ai AWS servizi.

    5. In Compute:

      1. Per la CPU, aggiorna l'allocazione vCPU per le tue attività (ad esempio, 1 vCPU).

      2. Per Memoria, aggiorna l'allocazione di memoria per le tue attività (ad esempio, 2 GB).

    6. In Auto Scaling:

      1. Per la metrica del servizio ECS, scegli la metrica su cui basare la scalabilità (ad esempio, ECS Service Average Memory Utilization o Request count per target).

      2. Per Valore Target, inserisci l'obiettivo per la scalabilità (ad esempio, 60 o 1000).

      3. Per Numero minimo di attività e Numero massimo di attività, aggiorna i limiti di scalabilità.

    7. In Registri:

      1. Per i gruppi di CloudWatch log di Amazon, aggiorna il nome del gruppo di log per i log delle applicazioni. Tieni presente che questo non sposterà i log esistenti, ma inizierà a scrivere i log a partire dalla nuova revisione del servizio.

      2. Per il prefisso Amazon CloudWatch log stream, inserisci un nuovo prefisso per i flussi di log.

  8. Scegli Aggiorna per aggiornare il servizio Express Mode.

Aggiornamento con una definizione di attività personalizzata

È possibile aggiornare il servizio Express Mode con una definizione di attività personalizzata specificando il taskDefinitionArn parametro. Express Mode utilizza la definizione dell'attività così com'è e continua a gestire il resto dell'infrastruttura.

Negli aggiornamenti successivi, puoi:

  • Crea una nuova revisione della definizione dell'attività e aggiorna iltaskDefinitionArn. Express Mode utilizza la nuova revisione per la successiva distribuzione del servizio.

  • Aggiorna direttamente i parametri della modalità Express:

    • Per i parametri non correlati alla definizione dell'attività (ad esempio healthCheckPathnetworkConfiguration, oscalingTarget), Express Mode applica le modifiche senza modificare la definizione dell'attività.

    • Per i parametri relativi alla definizione delle attività (come immagine, CPU o memoria utilizzando primaryContainer ocpu/memory), la modalità Express crea una nuova definizione di attività gestita con le modifiche apportate, preservando al contempo l'altra configurazione a livello di attività.

Per eseguire l'aggiornamento con una definizione di attività personalizzata (console Amazon ECS)

  1. Apri la console Amazon ECS e accedi al servizio Express Mode.

  2. Scegli la freccia del menu a discesa accanto a Update service, quindi scegli Aggiorna con definizione di attività personalizzata.

  3. Per Famiglia di definizioni di attività, seleziona una famiglia di definizioni di attività esistente. Per creare una nuova definizione di attività, scegli il link Definizioni delle attività.

  4. Per la revisione della definizione delle attività, seleziona la revisione da utilizzare o lascia vuoto il campo per utilizzare la revisione più recente.

  5. (Facoltativo) Espandi le configurazioni aggiuntive per aggiornare il percorso del controllo dello stato, la rete o le impostazioni di ridimensionamento automatico.

  6. Scegliere Aggiorna.

Il AWS AWS CLI comando seguente aggiorna il servizio Express Mode con una definizione di attività personalizzata:

aws ecs update-express-gateway-service \
    --service-arn arn:aws:ecs:us-west-2:123456789012:service/default/my-service \
    --task-definition-arn arn:aws:ecs:us-west-2:123456789012:task-definition/my-td:4
Nota

Se utilizzi il servizio Express Mode CloudFormation e lo stai aggiungendo taskDefinitionArn per la prima volta, ridistribuisci prima lo stack una volta. Ciò garantisce la compatibilità con il rollback.