View a markdown version of this page

Création et gestion de démons - Amazon Elastic Container Service
Conditions préalablesCréation d'un démonVérification du déploiement du démonMettre à jour un démonSupprimer un démon

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.

Création et gestion de démons

Après avoir enregistré une définition de tâche de démon, créez un démon pour le déployer auprès de vos fournisseurs de capacité Amazon ECS Managed Instances. Amazon ECS place automatiquement une tâche de démon sur chaque instance Amazon EC2 des fournisseurs de capacité associés et gère le cycle de vie du démon.

Conditions préalables

Avant de créer un démon, vérifiez que vous disposez des éléments suivants :

  • Un cluster Amazon ECS.

  • Un ou plusieurs fournisseurs de capacité Amazon ECS Managed Instances associés au cluster.

  • Une définition de tâche de démon enregistrée.

Création d'un démon

Console de gestion AWS

  1. Ouvrez la console Amazon ECS. Dans le volet de navigation, choisissez Clusters, puis sélectionnez votre cluster.

  2. Cliquez sur l'onglet Démons, puis sur Créer.

  3. Pour la famille de définitions de tâches de démon, sélectionnez votre définition de tâche de démon dans la liste déroulante.

  4. Pour la révision de la définition des tâches Daemon, sélectionnez la révision à utiliser. Laissez ce champ vide pour utiliser la dernière version.

  5. Dans le champ Nom du démon, entrez un nom unique. Le nom peut contenir jusqu'à 255 caractères alphanumériques, traits d'union et traits de soulignement.

  6. Pour les fournisseurs de capacité, sélectionnez un ou plusieurs fournisseurs de capacité Amazon ECS Managed Instances. Elles déterminent quelles instances exécutent les tâches de votre démon.

  7. (Facultatif) Configurez les paramètres de déploiement :

    • Pourcentage de vidange  : pourcentage d'instances à vider simultanément lors des mises à jour. Valeur par défaut : 25.

    • Utiliser une ou plusieurs CloudWatch alarmes  : activez cette option pour surveiller l'état du déploiement et revenez automatiquement en arrière si des alarmes se déclenchent.

    • Temps de cuisson  : nombre de minutes pendant lesquelles Amazon ECS attend après avoir mis à jour toutes les instances avec la nouvelle révision du démon avant de terminer le déploiement. Pendant cette période, Amazon ECS surveille CloudWatch les alarmes et annule automatiquement le déploiement si une alarme se déclenche. Valeur par défaut : 0.

  8. (Facultatif) Dans Critical, choisissez si le démon est essentiel à l'état de santé de l'instance.

  9. (Facultatif) Ajoutez des balises.

  10. (Facultatif) Activez l'option Activer ECS Exec pour exécuter des commandes interactives dans vos conteneurs de démons à des fins de dépannage.

  11. Vérifiez votre configuration et choisissez Créer.

AWS CLI

Créez un fichier JSON avec la configuration de votre démon et exécutez la create-daemon commande.

Voici un exemple de fichier JSON :

{
    "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-daemon-cluster",
    "daemonName": "my-monitoring-daemon",
    "daemonTaskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/my-daemon-task:1",
    "capacityProviderArns": [
        "arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-daemon-capacity-provider"
    ],
    "critical": true
}

Exécutez la commande suivante pour créer le démon :

aws ecs create-daemon --cli-input-json file://create-daemon.json

Champs obligatoires

  • daemonName- Un nom unique pour le démon.

  • clusterArn- L'ARN du cluster.

  • daemonTaskDefinitionArn- L'ARN de la définition de la tâche du démon.

  • capacityProviderArns- Un ensemble d'ARN des fournisseurs de capacité Amazon ECS Managed Instances.

Champs facultatifs

  • deploymentConfiguration- Un DaemonDeploymentConfiguration objet permettant de personnaliser le comportement de déploiement.

  • critical- Si le démon est essentiel à la santé de l'instance.

  • tags- Key-value paires pour le marquage.

  • propagateTags- Paramètre de propagation des balises.

  • clientToken- Un jeton d'idempotence.

Vérification du déploiement du démon

Après avoir créé un démon, vérifiez son statut en utilisant le Console de gestion AWS ou le AWS CLI.

Console de gestion AWS

  1. Ouvrez la console Amazon ECS. Dans le volet de navigation, choisissez Clusters, puis sélectionnez votre cluster.

  2. Choisissez l'onglet Démons.

  3. Vérifiez que votre démon affiche le statut Actif.

  4. Cliquez sur l'onglet Tâches pour confirmer qu'une tâche de démon est exécutée sur chaque instance de conteneur.

AWS CLI

Exécutez les commandes suivantes pour vérifier l'état du démon :

aws ecs list-daemons \
    --cluster-arn arn:aws:ecs:us-east-1:123456789012:cluster/my-daemon-cluster
aws ecs describe-daemons \
    --daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon

Mettre à jour un démon

Pour mettre à jour un démon avec une nouvelle révision de définition de tâche ou pour ajouter des fournisseurs de capacité, utilisez le Console de gestion AWS ou le AWS CLI. Cela déclenche un déploiement continu sur toutes les instances.

Console de gestion AWS

  1. Ouvrez la console Amazon ECS. Dans le volet de navigation, choisissez Clusters, puis sélectionnez votre cluster.

  2. Choisissez l'onglet Démons, puis sélectionnez le démon que vous souhaitez mettre à jour.

  3. Choisissez Mettre à jour.

  4. Pour la révision de la définition des tâches Daemon, sélectionnez la nouvelle révision.

  5. (Facultatif) Mettez à jour les fournisseurs de capacité ou les paramètres de déploiement.

  6. Choisissez Mettre à jour pour démarrer le déploiement continu.

AWS CLI

Exécutez la commande update-daemon :

aws ecs update-daemon \
    --daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon \
    --daemon-task-definition-arn arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/my-daemon-task:2 \
    --capacity-provider-arns arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-daemon-capacity-provider \
    --no-critical
Important

Lorsque vous fournissez des paramètres de configuration de démon dans une UpdateDaemon demande, Amazon ECS utilise les paramètres que vous avez spécifiés au lieu des paramètres par défaut. Les paramètres de configuration du démon, y compris les balises et l'indicateur de commande enable execute, ne sont pas conservés entre les mises à jour. Chaque appel à UpdateDaemon doit inclure l'ensemble complet des paramètres de configuration que vous souhaitez appliquer. Tous les paramètres omis dans la demande sont rétablis à leurs valeurs par défaut. Le critical paramètre est défini par défaut surtrue, donc si vous l'omettez dans une UpdateDaemon requête, le démon devient critique.

Supprimer un démon

Pour supprimer un démon, utilisez le Console de gestion AWS ou le AWS CLI. Attendez que toutes les tâches du démon s'arrêtent avant de supprimer le fournisseur de capacité ou le cluster.

Console de gestion AWS

  1. Ouvrez la console Amazon ECS. Dans le volet de navigation, choisissez Clusters, puis sélectionnez votre cluster.

  2. Choisissez l'onglet Démons, puis sélectionnez le démon que vous souhaitez supprimer.

  3. Sélectionnez Delete (Supprimer).

  4. Dans la boîte de dialogue de confirmation, choisissez Supprimer pour confirmer.

AWS CLI

Exécutez la commande delete-daemon :

aws ecs delete-daemon \
    --daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon