

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
<a name="managed-daemons-create-manage"></a>

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
<a name="managed-daemons-prerequisites"></a>

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
<a name="managed-daemons-create"></a>

### Console de gestion AWS
<a name="managed-daemons-create-console"></a>

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

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

1. 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.

1. 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.

1. 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.

1. 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.

1. (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`.

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

1. (Facultatif) Ajoutez des balises.

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

1. Vérifiez votre configuration et choisissez ** Créer**.

### AWS CLI
<a name="managed-daemons-create-cli"></a>

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
<a name="managed-daemons-verify"></a>

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
<a name="managed-daemons-verify-console"></a>

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

1. Choisissez l'onglet ** Démons. **

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

1. 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
<a name="managed-daemons-verify-cli"></a>

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
<a name="managed-daemons-update"></a>

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
<a name="managed-daemons-update-console"></a>

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

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

1. Choisissez **Mettre à jour**.

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

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

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

### AWS CLI
<a name="managed-daemons-update-cli"></a>

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 sur`true`, donc si vous l'omettez dans une `UpdateDaemon` requête, le démon devient critique.

## Supprimer un démon
<a name="managed-daemons-delete"></a>

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
<a name="managed-daemons-delete-console"></a>

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

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

1. Sélectionnez **Delete (Supprimer)**.

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

### AWS CLI
<a name="managed-daemons-delete-cli"></a>

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}}
```