

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Mettre à jour l'agent de conteneur Amazon ECS sur un Amazon ECS-optimized AMI

Si vous utilisez un Amazon ECS-optimized AMI, plusieurs options s'offrent à vous pour obtenir la dernière version de l'agent de conteneur Amazon ECS (présentée par ordre de recommandation) :
+ Mettez fin à l'instance de conteneur et lancez la dernière version d'Amazon ECS-optimized AMI Amazon Linux 2 (manuellement ou en mettant à jour votre configuration de lancement Auto Scaling avec la dernière AMI). Cette opération fournit une instance de conteneur propre avec les versions les plus récemment testées et validées d'Amazon Linux, de Docker, d'`ecs-init` et de l'agent de conteneur Amazon ECS. Pour plus d’informations, consultez [Amazon ECS-optimized AMI Linux](ecs-optimized_AMI.md).
+ Connectez-vous à l'instance avec SSH et mettez à jour le package `ecs-init` (et ses dépendances) vers la dernière version. Cette opération fournit les versions les plus récemment testées et validées de Docker et d'`ecs-init` disponibles dans les référentiels Amazon Linux et la dernière version de l'agent de conteneur Amazon ECS. Pour plus d’informations, consultez [Pour mettre à jour le `ecs-init` colis sur Amazon ECS-optimized AMI](#procedure_update_ecs-init).
+ Mettez à jour l'agent de conteneur avec `UpdateContainerAgent` Fonctionnement de l'API, soit via la console, soit avec AWS CLI ou AWS SDK. Pour plus d’informations, consultez [Mise à jour de l'agent de conteneur Amazon ECS avec l'opération d'API `UpdateContainerAgent`](#agent-update-api).

**Note**  
Les mises à jour de l'agent ne s'appliquent pas aux instances de conteneur Windows. Nous vous recommandons de lancer de nouvelles instances de conteneur pour mettre à jour le version de l'agent dans vos clusters Windows.<a name="procedure_update_ecs-init"></a>

**Pour mettre à jour le `ecs-init` colis sur Amazon ECS-optimized AMI**

1. Connectez-vous à votre instance de conteneur via SSH.

1. Mettez à jour le package `ecs-init` avec la commande suivante.

   ```
   sudo yum update -y ecs-init
   ```
**Note**  
Le package `ecs-init` et l'agent de conteneur Amazon ECS sont mis à jour immédiatement. Cependant, les versions les plus récentes de Docker ne sont pas chargées tant que le démon Docker n'est pas redémarré. Redémarrez en relançant l'instance ou en exécutant les commandes suivantes sur votre instance :  
Amazon ECS-optimized AMI Amazon Linux 2 :  

     ```
     sudo systemctl restart docker
     ```
Amazon ECS-optimized AMI Amazon Linux :  

     ```
     sudo service docker restart && sudo start ecs
     ```

## Mise à jour de l'agent de conteneur Amazon ECS avec l'opération d'API `UpdateContainerAgent`
<a name="agent-update-api"></a>

**Important**  
Le `UpdateContainerAgent` L'API n'est prise en charge que sur les variantes Linux d'Amazon ECS-optimized AMI, à l'exception de l'Amazon ECS-optimized AMI Amazon Linux 2 (arm64). Pour les instances de conteneurs utilisant Amazon ECS-optimized AMI Amazon Linux 2 (arm64), mettez à jour `ecs-init` package pour mettre à jour l'agent. Pour les instances de conteneur qui exécutent d'autres systèmes d'exploitation, consultez la page [Mise à jour manuelle de l'agent de conteneur Amazon ECS (pour les non-Amazon) ECS-Optimized AMI)](manually_update_agent.md). Si vous utilisez des instances de conteneur Windows, nous vous recommandons de lancer de nouvelles instances de conteneur pour mettre à jour le version de l'agent dans vos clusters Windows.

Le `UpdateContainerAgent` Le processus d'API commence lorsque vous demandez une mise à jour de l'agent, soit via la console, soit à l'aide du AWS CLI ou AWS SDK. Amazon ECS vérifie la version actuelle de votre agent par rapport à la dernière version disponible, et détermine si une mise à jour est possible. Si aucune mise à jour n'est disponible, si l'agent exécute déjà par exemple la version la plus récente, le message `NoUpdateAvailableException` est renvoyé.

Les étapes du processus de mise à jour sont les suivantes :

`PENDING`  
Une mise à jour de l'agent est disponible, et le processus de mise à jour a commencé.

`STAGING`  
L'agent a commencé le téléchargement de la mise à jour. Si l'agent ne peut pas télécharger la mise à jour, ou si le contenu de la mise à jour est incorrect ou endommagé, l'agent envoie une notification de l'échec et la mise à jour passe en état `FAILED`.

`STAGED`  
Le téléchargement est terminé et le contenu de l'agent a été vérifié.

`UPDATING`  
Le service `ecs-init` est redémarré et il récupère la nouvelle version de l'agent. Si, pour une raison quelconque, l'agent est incapable de redémarrer, la mise à jour passe à l'état `FAILED`. Dans le cas contraire, l'agent indique à Amazon ECS que la mise à jour est terminée.

**Note**  
Les mises à jour de l'agent ne s'appliquent pas aux instances de conteneur Windows. Nous vous recommandons de lancer de nouvelles instances de conteneur pour mettre à jour le version de l'agent dans vos clusters Windows.

**Pour mettre à jour l'agent de conteneur Amazon ECS sur un Amazon ECS-optimized AMI dans la console**

1. Ouvrez la console à [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. Dans la barre de navigation, choisissez la région dans laquelle votre instance externe est inscrite.

1. Dans le panneau de navigation, choisissez **Clusters** et sélectionnez le cluster.

1. Sur le **Cluster : {{name}}** page, choisissez **Infrastructures** onglet.

1. Sous **Instances de conteneur**, sélectionnez les instances à mettre à jour, puis choisissez **Actions** et **Mettre à jour l'agent**.