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 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 ](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/canary-deployment.html)
## 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 ** Clusters, scegli il nome del cluster che contiene il tuo 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 del ** filtro**, 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 ** 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.
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 utilizzare il tag, scegli il tag ** ** Image, quindi scegli il tag.
1. 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.
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 la porta ** Container**, aggiorna la porta su cui l'applicazione è in ascolto (l'impostazione predefinita è 80).
1. Per ** Health check path**, aggiorna il percorso per i controlli di integrità (ad esempio,`/health`).
1. 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.
1. Per Tipo di ** valore**, scegli Variabile di ** ambiente ** o ** Segreto**.
1. In ** Valore o valore da**, inserite il valore o il riferimento.
1. **Scegliete Aggiungi variabile ** di ambiente per aggiungere altre variabili in base alle esigenze.
1. Per ** Command**, facoltativamente, inserisci un comando personalizzato per sovrascrivere l'istruzione Docker CMD.
1. 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.
1. In ** Compute**:
1. Per quanto riguarda ** la CPU**, aggiorna l'allocazione della vCPU per le tue attività (ad esempio, 1 vCPU).
1. Per quanto riguarda la ** 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 ridimensionare (ad esempio, ** ECS Service Average Memory Utilization ** o ** Request count per target). **
1. Per Valore ** target**, inserisci l'obiettivo per il ridimensionamento (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 ** 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.
1. Per il prefisso ** Amazon CloudWatch log stream**, inserisci un nuovo prefisso per i log stream.
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 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 il`taskDefinitionArn`. 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à (come`healthCheckPath`, o`scalingTarget`)`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` 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 a discesa accanto al servizio di ** aggiornamento**, quindi scegli ** Aggiorna con definizione di attività personalizzata. **
1. 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à.
1. Per la revisione della definizione delle ** attività**, seleziona la revisione da utilizzare o lascia vuoto per utilizzare la revisione più recente.
1. (Facoltativo) Espandi le configurazioni ** aggiuntive ** per aggiornare il percorso di 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.