Come aggiornare l'agente del container Amazon ECS su un'AMI ottimizzata per Amazon ECS

Se utilizzi l'AMI ottimizzata per Amazon ECS, hai diverse opzioni per ottenere la versione più recente dell'agente del container di Amazon ECS (mostrato in ordine di raccomandazione):

• Termina l'istanza di container e avvia la versione più recente dell'AMI Amazon Linux 2 ottimizzata per Amazon ECS (manualmente o tramite l'aggiornamento della configurazione di avvio di Auto Scaling con l'AMI più recente). Questo fornisce una nuova istanza di container con le versioni testate e convalidate più aggiornate di Amazon Linux, Docker, ecs-init e l'agente del container di Amazon ECS. Per ulteriori informazioni, consulta AMI Linux ottimizzate per Amazon ECS.

• Connettiti all'istanza con SSH e aggiorna il pacchetto ecs-init (e le relative dipendenze) alla versione più recente. Questa operazione fornisce le versioni testate e convalidate più aggiornate di Docker e ecs-init che sono disponibili nei repository di Amazon Linux e la versione più recente dell'agente del container di Amazon ECS. Per ulteriori informazioni, consulta Come aggiornare il pacchetto ecs-init su un'AMI ottimizzata per Amazon ECS.

• Aggiorna l'agente del contenitore con l'operazione UpdateContainerAgent API, tramite la console o con gli AWS SDK AWS CLI o. Per ulteriori informazioni, consulta Aggiornamento dell'agente del container di Amazon ECS con l'operazione API UpdateContainerAgent.

Nota

Gli aggiornamenti dell'agente non si applicano alle istanze di container di Windows. Consigliamo di avviare nuove istanze di container per aggiornare la versione dell'agente nei cluster Windows.

Come aggiornare il pacchetto ecs-init su un'AMI ottimizzata per Amazon ECS

1. Accedi alla tua istanza di container con SSH.

2. Aggiorna il pacchetto ecs-init con il comando seguente.

   sudo yum update -y ecs-init

   Nota

   Il pacchetto ecs-init e l'agente del container di Amazon ECS vengono aggiornati immediatamente. Tuttavia, le versioni più recenti di Docker non vengono caricate finché il daemon Docker non viene riavviato. Utilizza il riavvio dell'istanza oppure esegui i comandi seguenti sull'istanza:

   • AMI Amazon Linux 2 ottimizzata per Amazon ECS:

     sudo systemctl restart docker

   • AMI Amazon Linux ottimizzata per Amazon ECS:

     sudo service docker restart && sudo start ecs

Aggiornamento dell'agente del container di Amazon ECS con l'operazione API UpdateContainerAgent

Importante

L'API UpdateContainerAgent è supportata solo sulle varianti Linux dell'AMI ottimizzata per Amazon ECS, ad eccezione dell'AMI Amazon Linux 2 (arm64) ottimizzata per Amazon ECS. Per le istanze di container che utilizzano l'AMI Amazon Linux 2 (arm64) ottimizzata per Amazon ECS, aggiorna il pacchetto ecs-init per aggiornare l'agente. Per le istanze di container che eseguono altri sistemi operativi, consulta Aggiornamento manuale dell'agente del container di Amazon ECS (per AMI non ottimizzate per Amazon ECS). Se utilizzi istanze di container Windows, ti consigliamo di avviare nuove istanze di container per aggiornare la versione dell'agente nei tuoi cluster Windows.

Il processo UpdateContainerAgent API inizia quando richiedi l'aggiornamento di un agente, tramite la console o con gli AWS CLI AWS SDK. Amazon ECS verifica la versione corrente dell'agente confrontandola con l'ultima versione disponibile dell'agente e verifica se è possibile effettuare un aggiornamento. Se non è disponibile alcun aggiornamento, ad esempio se l'agente sta già eseguendo la versione più recente, allora viene restituito NoUpdateAvailableException.

Le fasi del processo di aggiornamento riportate in precedenza sono le seguenti:

PENDING

È disponibile un aggiornamento dell'agente e il processo di aggiornamento è stato avviato.

STAGING

L'agente ha iniziato a scaricare il relativo aggiornamento. Se l'agente non è in grado di scaricare l'aggiornamento, oppure se i contenuti dell'aggiornamento non sono corretti o sono danneggiati, l'agente invia una notifica dell'errore e l'aggiornamento passa allo stato FAILED.

STAGED

Il download dell'agente è stato completato e i contenuti dell'agente sono stati verificati.

UPDATING

Il servizio ecs-init è stato riavviato e ottiene la nuova versione dell'agente. Se l'agente non è in grado di riavviarsi per qualsiasi motivo, l'aggiornamento passa allo stato FAILED. In caso contrario, l'agente segnala ad Amazon ECS che l'aggiornamento è completo.

Nota

Gli aggiornamenti dell'agente non si applicano alle istanze di container di Windows. Consigliamo di avviare nuove istanze di container per aggiornare la versione dell'agente nei cluster Windows.

Come aggiornare l'agente del container Amazon ECS su un'AMI ottimizzata per Amazon ECS nella console

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

2. Dalla barra di navigazione, scegli la Regione in cui l'istanza esterna è registrata.

3. Nel pannello di navigazione, seleziona Clusters (Cluster), quindi seleziona il cluster.

4. Alla pagina Cluster : name (Cluster: nome), scegli la scheda Infrastructure (Infrastruttura).

5. In Istanze di container, seleziona le istanze da aggiornare, quindi scegli Operazioni, Aggiorna agente.