Aggiornamento di un servizio Amazon ECS Express Mode

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 implementazioni Canary con allarmi di rollback basati sugli allarmi per mantenere la disponibilità.

Comportamento di distribuzione

Un servizio Express Mode utilizza le distribuzioni Canary per impostazione predefinita per garantire aggiornamenti sicuri e rollback rapidi:

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

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

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

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

• Dopo 3 minuti di attesa, il 100% del traffico viene trasferito in un nuovo ambiente

• Dopo 3 minuti di attesa 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 Clusters, scegli il nome del cluster che contiene il tuo 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 del filtro, 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 Image URI, inserisci l'URI dell'immagine. Per sfogliare le tue immagini Amazon ECR, scegli Browse ECR images, quindi procedi come segue:

      1. Per l'archivio privato, scegli il repository 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 utilizzare il tag, scegli il tag Image, quindi scegli il tag.

   2. Per utilizzare un registro privato, seleziona Registro privato. Quindi, per l'ARN o il nome di Secrets Manager, 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 la porta Container, aggiorna la porta su cui l'applicazione è in ascolto (l'impostazione predefinita è 80).

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

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

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

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

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

      4. Scegliete Aggiungi variabile di ambiente per aggiungere altre variabili in base alle esigenze.

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

   4. Per il ruolo Task, aggiungi un ruolo IAM che conceda 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 quanto riguarda la CPU, aggiorna l'allocazione della vCPU per le tue attività (ad esempio, 1 vCPU).

      2. Per quanto riguarda la 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 ridimensionare (ad esempio, ECS Service Average Memory Utilization o Request count per target).

      2. Per Valore target, inserisci l'obiettivo per il ridimensionamento (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 Amazon CloudWatch log group, aggiorna il nome del gruppo di log per i log delle tue applicazioni. Tieni presente che questo non sposterà i log esistenti, ma inizierà a scrivere i log dalla nuova revisione del servizio.

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

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 delle 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. La modalità Express utilizza la nuova revisione per la prossima distribuzione del servizio.

• Aggiorna direttamente i parametri della modalità Express:

  • Per i parametri non correlati alla definizione dell'attività (comehealthCheckPath, oscalingTarget)networkConfiguration, la modalità Express applica le modifiche senza modificare la definizione dell'attività.

  • Per i parametri relativi alla definizione delle attività (ad esempio 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 a discesa accanto al servizio di aggiornamento, quindi scegli Aggiorna con definizione di attività personalizzata.

3. Per la famiglia di definizioni di attività, seleziona una famiglia di definizioni di attività esistente. Per creare una nuova definizione di attività, scegliete il link Definizioni di attività.

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

5. (Facoltativo) Espandi le configurazioni aggiuntive per aggiornare il percorso di 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.