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](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/canary-deployment.html) deployments
## Procedura
1. Apri la console all'indirizzo. [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2)
1. Nel pannello di navigazione scegliere **Cluster**.
1. Nella pagina **Cluster**, scegli il nome del cluster che contiene il servizio Express Mode.
1. Nella pagina dei dettagli del cluster, scegli la scheda **Servizi**.
1. 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.
1. 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.
1. Per **Image, scegli la tua immagine**.
1. 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.
1. 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.
1. 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.
1. 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).
1. Per **Health check path**, aggiorna il percorso per i controlli sanitari (ad esempio,`/health`).
1. 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.
1. Per **Tipo di valore**, scegliete **Variabile di ambiente** o **Segreto**.
1. Per **Valore o valore da**, inserite il valore o il riferimento.
1. **Scegliete Aggiungi variabile di ambiente** per aggiungere altre variabili secondo necessità.
1. Per **Command**, inserisci facoltativamente un comando personalizzato per sovrascrivere l'istruzione Docker CMD.
1. 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.
1. In **Compute**:
1. Per **la CPU**, aggiorna l'allocazione vCPU per le tue attività (ad esempio, 1 vCPU).
1. Per **Memoria**, aggiorna l'allocazione di memoria per le tue attività (ad esempio, 2 GB).
1. 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).**
1. ****Per **Valore Target**, inserisci l'obiettivo per la scalabilità (ad esempio, 60 o 1000).****
1. Per **Numero minimo di attività** e **Numero massimo di attività**, aggiorna i limiti di scalabilità.
1. 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.
1. Per il **prefisso Amazon CloudWatch log stream**, inserisci un nuovo prefisso per i flussi di log.
1. 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 il`taskDefinitionArn`. 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 `healthCheckPath``networkConfiguration`, o`scalingTarget`), 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` o`cpu`/`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.
1. Scegli la freccia del menu a discesa accanto a **Update service**, quindi scegli **Aggiorna con definizione di attività personalizzata**.
1. 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à**.
1. Per la **revisione della definizione delle attività**, seleziona la revisione da utilizzare o lascia vuoto il campo per utilizzare la revisione più recente.
1. (Facoltativo) Espandi **le configurazioni aggiuntive** per aggiornare il percorso del controllo dello stato, la rete o le impostazioni di ridimensionamento automatico.
1. 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.