Mise à jour de l'agent de conteneur Amazon ECS sur une AMI optimisée pour Amazon ECS

Si vous utilisez l'AMI optimisée pour Amazon ECS, vous disposez de plusieurs options pour obtenir la dernière version de l'agent de conteneur Amazon ECS (présentées dans l'ordre de recommandation) :

• Résiliez l'instance de conteneur et lancez la dernière version de l'AMI Amazon Linux 2 optimisée pour Amazon ECS (manuellement ou en mettant à jour votre configuration du 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 AMI Linux optimisées pour Amazon ECS.

• 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 package ecs-init sur une AMI optimisée pour Amazon ECS.

• Mettez à jour l'agent de conteneur avec le fonctionnement de l'UpdateContainerAgentAPI, soit via la console, soit avec les AWS CLI kits de AWS développement logiciel (SDK). Pour plus d’informations, consultez Mise à jour de l'agent de conteneur Amazon ECS avec l'opération d'API UpdateContainerAgent.

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 le package ecs-init sur une AMI optimisée pour Amazon ECS

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

2. 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 :

   • AMI Amazon Linux 2 optimisée pour Amazon ECS :

     sudo systemctl restart docker

   • AMI Amazon Linux optimisée pour Amazon ECS :

     sudo service docker restart && sudo start ecs

Mise à jour de l'agent de conteneur Amazon ECS avec l'opération d'API UpdateContainerAgent

Important

L'API UpdateContainerAgent n'est prise en charge que sur les variantes Linux de l'AMI optimisée pour Amazon ECS, à l'exception de l'AMI Amazon Linux 2 (arm64) optimisée pour Amazon ECS. Pour les instances de conteneur utilisant l'AMI Amazon Linux 2 (arm64) optimisée pour Amazon ECS, mettez à jour le package ecs-init 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 des AMI non optimisées pour Amazon ECS). 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 processus UpdateContainerAgent d'API commence lorsque vous demandez une mise à jour de l'agent, soit par le biais de la console, soit à l' AWS CLI aide des kits de AWS développement logiciel (SDK). Amazon ECS compare la version actuelle de votre agent à la dernière version d'agent disponible et vérifie 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 ci-dessus 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 une AMI optimisée pour Amazon ECS dans la console

1. Ouvrez la console à partir de l'adresse https://console.aws.amazon.com/ecs/v2.

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

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

4. Sur la page Cluster : name (Cluster : nom), choisissez l'onglet Infrastructure.

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