View a markdown version of this page

Mise à jour de l'agent de conteneur Amazon ECS sur une ECS-optimized AMI Amazon - Amazon Elastic Container Service
Mise à jour de l'agent de conteneur Amazon ECS avec l'opération d'API UpdateContainerAgent

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.

Mise à jour de l'agent de conteneur Amazon ECS sur une ECS-optimized AMI Amazon

Si vous utilisez une ECS-optimized AMI Amazon, plusieurs options s'offrent à vous pour obtenir la dernière version de l'agent de conteneur Amazon ECS (indiqué par ordre de recommandation) :

  • Mettez fin à l'instance de conteneur et lancez la dernière version de l'AMI ECS-optimized Amazon Linux 2 (soit manuellement, soit 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 de plus amples informations, veuillez consulter AMI Amazon ECS-optimized Linux.

  • 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 de plus amples informations, veuillez consulter Pour mettre à jour le ecs-init package sur une Amazon ECS-optimized AMI.

  • 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 de plus amples informations, veuillez consulter 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 ecs-init package sur une Amazon ECS-optimized AMI

  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 ECS-optimized Amazon Amazon Linux 2 :

      sudo systemctl restart docker

    • AMI ECS-optimized Amazon 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

Important

L'UpdateContainerAgentAPI n'est prise en charge que sur les variantes Linux de l' ECS-optimized AMI Amazon, à l'exception de l'AMI ECS-optimized Amazon Amazon Linux 2 (arm64). Pour les instances de conteneur utilisant l'AMI ECS-optimized Amazon Amazon Linux 2 (arm64), mettez à jour le 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 ECS-Optimized AMI autres qu'Amazon). 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 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 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 ECS-optimized AMI Amazon dans la console

  1. Ouvrez la console à 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 name page Cluster :, choisissez l'onglet Infrastructure.

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