Événements Amazon ECS - Amazon Elastic Container Service

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.

Événements Amazon ECS

Amazon ECS suit l'état de chacune de vos tâches et de chacun de vos services. Si l'état d'une tâche ou d'un service change, un événement est généré et envoyé à Amazon EventBridge. Ces événements sont considérés comme des événements de changement d'état de tâche et des événements d'action de service. Ces événements et leurs causes possibles sont détaillés dans les sections suivantes.

Amazon ECS génère et envoie les types d'événements suivants à EventBridge :

  • Modification de l'état de l'instance de conteneur

  • Modification de l'état de la tâche

  • Deployment state change (Changement d'état du déploiement)

  • Action de service

Note

Amazon ECS pourrait ajouter d'autres types d'événements, sources et informations à l'avenir. Si vous désérialisez des données JSON d'événements dans du code, assurez-vous que votre application est prête à gérer les propriétés inconnues afin d'éviter les problèmes si et quand ces propriétés supplémentaires sont ajoutées.

Dans certains cas, plusieurs événements sont générés pour la même activité. Par exemple, lorsqu'une tâche est démarrée sur une instance de conteneur, un événement de modification de l'état de tâche est généré pour la nouvelle tâche. Un événement de changement d'état d'instance de conteneur est généré pour prendre en compte le changement dans les ressources disponibles, comme le processeur, la mémoire et les ports disponibles, dans l'instance de conteneur. De même, si une instance de conteneur est mise hors service, des événements sont générés pour l'instance de conteneur, l'état de connexion de l'agent de conteneur et chaque tâche en cours d'exécution sur l'instance de conteneur.

Les événements de changement d'état de conteneur et de changement d'état de tâche contiennent deux champs version : un dans le corps principal de l'événement et l'autre dans l'objet detail de l'événement. Les différences entre ces deux champs sont décrites ci-dessous :

  • Le champ version du corps de l'événement est défini sur 0 pour tous les événements. Pour plus d'informations sur EventBridge les paramètres, consultez les métadonnées des événements de AWS service dans le guide de EventBridge l'utilisateur Amazon.

  • Le champ version dans l'objet detail de l'événement décrit la version de la ressource associée. Chaque fois qu'une ressource change d'état, cette version est incrémentée. Comme les événements peuvent être envoyés plusieurs fois, ce champ vous permet d'identifier les événements en double. Les événements en double présentent la même version dans l'objet detail. Si vous répliquez votre instance de conteneur Amazon ECS et l'état de votre tâche avec EventBridge, vous pouvez comparer la version d'une ressource signalée par Amazon ECS APIs avec la version signalée EventBridge pour la ressource (à l'intérieur de l'detailobjet) afin de vérifier que la version de votre flux d'événements est à jour.

Les événements d'action de service contiennent uniquement le champ version dans le corps principal.

Les événements d'action de service spécifient le service dans deux champs différents :

  • Pour les événements générés parcreate-service, le service est serviceName sur le terrain.

  • Pour les événements générés parupdate-service, le service est service sur le terrain.

Si vous utilisez des outils automatisés pour les événements de service, vous devez coder pour les deux champs.

Pour plus d'informations sur la création d'une règle pour les événements liés aux actions de service, consultezÉvénements liés aux actions du service Amazon ECS.

Pour plus d'informations sur la manière d'intégrer Amazon ECS EventBridge, consultez la section Intégration d'Amazon EventBridge et d'Amazon ECS.