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. # Balisage des ressources Amazon ECS Pour vous aider à gérer vos ressources Amazon ECS, vous pouvez éventuellement affecter vos propres métadonnées à chaque ressource à l'aide de *balises*. Chaque *balise* est constituée d'une *clé* et d'une *valeur* facultative. Vous pouvez utiliser des étiquettes pour classer vos ressources Amazon ECS de différentes manières, par exemple, par objectif, par propriétaire ou par environnement. Cela est utile lorsque vous avez de nombreuses ressources du même type. Vous pouvez identifier rapidement une ressource spécifique en fonction des étiquettes que vous lui avez attribuées. Par exemple, vous pouvez définir pour les instances de votre compte Amazon ECS un ensemble d'étiquettes. Cela vous aide à suivre le propriétaire et le niveau de la pile de chaque instance. Vous pouvez utiliser des balises pour vos Rapports d'utilisation et de coût. Vous pouvez utiliser ces rapports pour analyser le coût et de l'utilisation de vos ressources Amazon ECS. Pour de plus amples informations, veuillez consulter [Rapports d'utilisation d'Amazon ECS](usage-reports.md). **Avertissement** Il y en a beaucoup APIs qui renvoient les clés des balises et leurs valeurs. Le fait de refuser l'accès à `DescribeTags` ne refuse pas automatiquement l'accès aux balises renvoyées par d'autres APIs. Nous vous recommandons de ne pas inclure de données sensibles dans vos balises. Nous vous recommandons de concevoir un ensemble de clés d’étiquette répondant à vos besoins pour chaque type de ressource. Vous pouvez utiliser un ensemble de clés de balise cohérent facilite la gestion de vos ressources. Vous pouvez rechercher et filtrer les ressources en fonction des étiquettes que vous ajoutez. Les balises n'ont pas de signification sémantique pour Amazon ECS et sont interprétées strictement comme des chaînes de caractères. Vous pouvez modifier les clés et valeurs de balise, et vous pouvez retirer des balises d’une ressource à tout moment. Vous pouvez définir la valeur d'une étiquette sur une chaîne vide, mais vous ne pouvez pas définir la valeur d'une étiquette sur null. Si vous ajoutez une balise ayant la même clé qu'une balise existante sur cette ressource, la nouvelle valeur remplace l'ancienne valeur. Lorsque vous supprimez une ressource, toutes les balises associées à cette ressource sont également supprimées. Si vous utilisez Gestion des identités et des accès AWS (IAM), vous pouvez contrôler quels utilisateurs de votre AWS compte sont autorisés à gérer les tags. ## Comment les ressources sont étiquetées Les tâches, les services, les définitions de tâches Amazon ECS sont balisés de différentes manières : + Un utilisateur balise manuellement une ressource à l' AWS Management Console aide de l'API Amazon ECS AWS CLI, du ou d'un AWS SDK. + Un utilisateur crée un service ou exécute une tâche autonome et sélectionne l'option de balises gérées par Amazon ECS. Amazon ECS étiquette automatiquement toutes les tâches récemment lancées. Pour de plus amples informations, veuillez consulter [Balises gérées par Amazon ECS](#managed-tags). + Un utilisateur crée une ressource à l'aide de la console. La console étiquette automatiquement les ressources. Ces balises sont renvoyées dans AWS CLI les réponses du AWS SDK et sont affichées dans la console. Vous ne pouvez pas modifier ni supprimer ces balises. Pour plus d'informations sur les balises ajoutées, consultez la colonne **Balises ajoutées automatiquement par la console** dans le tableau des **ressources relatives à la prise en charge du balisage pour Amazon ECS**. Si vous spécifiez des balises lorsque vous créez une ressource et que les balises ne peuvent pas être appliquées, Amazon ECS annule le processus de création. Cela permet de s'assurer que les ressources sont créées avec des étiquettes ou qu'elles ne sont pas créées du tout, et qu'aucune ressource ne demeurent sans étiquette à tout moment. En attribuant des étiquettes aux ressources au moment de la création, vous pouvez supprimer la nécessité d'exécuter des scripts d'identification personnalisés après la création de ressources. Le tableau suivant décrit les ressources Amazon ECS qui prennent en charge les balises. | Ressource | Prend en charge les étiquettes | Prend en charge la propagation des étiquettes | Balises ajoutées automatiquement par la console | | --- | --- | --- | --- | | Tâches Amazon ECS | Oui | Oui, à partir de la définition de tâche. | Clé : aws:ecs:clusterName *Value (Valeur)* : `cluster-name` | | Services Amazon ECS | Oui | Oui, à partir soit de la définition de tâche ou de service pour les tâches dans le service. | Clé : ecs:service:stackId *Value (Valeur)* : `arn:aws:cloudformation:arn` | | Ensembles de tâches Amazon ECS | Oui | Non | N/A | | Définitions de tâche Amazon ECS | Oui | Non | Clé : ecs:taskDefinition:createdFrom *Value (Valeur)* : `ecs-console-v2` | | Clusters Amazon ECS | Oui | Non | Clé : aws:cloudformation:logical-id *Value (Valeur)* : `ECSCluster` Clé : aws:cloudformation:stack-id*Value (Valeur)* : `arn:aws:cloudformation:arn`*Clé* : `aws:cloudformation:stack-name`*Value (Valeur)* : `ECS-Console-V2-Cluster-EXAMPLE` | | Instances de conteneur Amazon ECS | Oui | Oui, à partir de l'instance Amazon EC2. Pour de plus amples informations, veuillez consulter [Ajout de balises à une instance de conteneur Amazon EC2 pour Amazon ECS](instance-details-tags.md). | N/A | | Instances Amazon ECS externes | Oui | Non | N/A | | Fournisseur de capacité Amazon ECS | Oui. Vous ne pouvez pas étiqueter les fournisseurs prédéfinis de capacité `FARGATE` et `FARGATE_SPOT`. | Oui, uniquement auprès des fournisseurs de capacité pour les instances gérées Amazon ECS. Vous pouvez propager des balises depuis le fournisseur de capacité pour les instances gérées Amazon ECS vers toutes les ressources gérées par le fournisseur, telles que les instances Amazon EC2, le modèle de lancement, les interfaces réseau Elastic et les volumes. | N/A | ## Balisage des ressources à la création Les ressources suivantes prennent en charge le balisage lors de la création à l'aide de l'API ou du AWS SDK Amazon ECS : AWS CLI + Tâches Amazon ECS + Services Amazon ECS + Définition de tâche Amazon ECS + Ensembles de tâches Amazon ECS + Clusters Amazon ECS + Instances de conteneur Amazon ECS + Fournisseurs de capacité Amazon ECS Amazon ECS a la possibilité d'utiliser l'autorisation de balisage pour la création de ressources. Lorsque l’ Compte AWS est configuré pour l’autorisation de balisage, les utilisateurs doivent être autorisés à effectuer les actions qui créent la ressource, par exemple `ecsCreateCluster`. Si vous spécifiez des balises dans l'action de création de ressources, AWS effectue une autorisation supplémentaire pour vérifier si les utilisateurs ou les rôles sont autorisés à créer des balises. Par conséquent, vous devez octroyer des autorisations explicites d'utiliser l'action `ecs:TagResource`. Pour de plus amples informations, veuillez consulter [Octroi de l'autorisation de baliser les ressources lors de la création](supported-iam-actions-tagging.md). Pour plus d’informations sur la configuration de cette option, consultez la section [Autorisation de balisage](ecs-account-settings.md#tag-resources-setting). ## Restrictions Les restrictions suivantes s’appliquent aux balises : + Un maximum de 50 balises peut être associé à une ressource. + Les clés de balises ne peuvent pas être répétées pour une même ressource. Chaque clé de balise doit être unique et ne peut avoir qu'une seule valeur. + Les clés peuvent contenir jusqu'à 128 caractères en UTF-8. + Les valeurs peuvent contenir jusqu'à 256 caractères en UTF-8. + Si plusieurs Services AWS ressources utilisent votre schéma de balisage, limitez les types de caractères que vous utilisez. Certains services peuvent présenter des restrictions sur les caractères autorisés. Les caractères généralement autorisés sont les lettres, les chiffres, les espaces et les caractères suivants : `+` `-` `=` `.` `_` `:` `/` `@`. + Les clés et les valeurs des balises distinguent les majuscules et minuscules. + Vous ne pouvez pas utiliser `aws:`, `AWS:` ou n'importe quelle combinaison de majuscules ou minuscules de ce préfixe pour des clés ou des valeurs Ils sont réservés uniquement à AWS l'usage. Vous ne pouvez pas modifier ni supprimer des clés ou valeurs d’étiquette ayant ce préfixe. Les balises comportant ce préfixe ne sont pas prises en compte dans votre tags-per-resource limite. ## Balises gérées par Amazon ECS Lorsque vous utilisez les balises gérées par Amazon ECS, ce dernier marque automatiquement toutes les tâches nouvellement lancées et tous les volumes Amazon EBS associés à ces tâches avec les informations du cluster ainsi qu’avec les balises de définition de tâche ajoutées par l’utilisateur ou avec les balises de service. Les balises ajoutées sont décrites ci-dessous : + Tâches autonomes : une balise avec une *clé* en tant que `aws:ecs:clusterName` et une *valeur* définies en fonction du nom du cluster. Toutes les balises de définition de tâches qui ont été ajoutées par les utilisateurs. Un volume Amazon EBS associé à une tâche autonome recevra la balise avec une *clé* définie sur `aws:ecs:clusterName` et une *valeur* définie sur sur le nom du cluster. Pour plus d’informations sur le balisage des volumes Amazon EBS, consultez la section [Balisage des volumes Amazon EBS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specify-ebs-config.html#ebs-volume-tagging). + Tâches faisant partie d’un service : une balise avec une *clé* en tant que `aws:ecs:clusterName` et une *valeur* définies en fonction du nom du cluster. Balise avec une *clé* en tant que `aws:ecs:serviceName` et une *valeur* définies en fonction du nom du service. Balises de l’une des ressources suivantes. + Définitions de tâches : toutes les balises de définition de tâches qui ont été ajoutées par les utilisateurs. + Services : toutes les balises de service qui ont été ajoutées par les utilisateurs. Un volume Amazon EBS associé à une tâche faisant partie d’un service recevra une balise avec une *clé* définie sur `aws:ecs:clusterName` et une *valeur* définie sur le nom du cluster, et une balise avec une *clé* `aws:ecs:serviceName` avec une *valeur* définie sur le nom du service. Pour plus d’informations sur le balisage des volumes Amazon EBS, consultez la section [Balisage des volumes Amazon EBS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specify-ebs-config.html#ebs-volume-tagging). Les options suivantes sont requises pour cette fonctionnalité : + Vous devez vous inscrire au nouveaux formats Amazon Resource Name (ARN) et identifiants de ressource (ID). Pour de plus amples informations, veuillez consulter [Amazon Resource Names (ARNs) et IDs](ecs-account-settings.md#ecs-resource-ids). + Lorsque vous utilisez le APIs pour créer un service ou exécuter une tâche, vous devez définir `enableECSManagedTags` `true` pour `run-task` et`create-service`. Pour plus d'informations, consultez [create-service](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html) et [run-task](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html) dans la *Référence API d'AWS Command Line Interface *. + Amazon ECS utilise des balises gérées pour déterminer à quel moment certaines fonctionnalités sont activées, par exemple l'autoscaling de cluster. Nous vous recommandons de ne pas modifier manuellement les balises afin qu’Amazon ECS puisse gérer efficacement les fonctionnalités. ## Mise à jour des balises pour la facturation AWS fournit un outil de reporting appelé Cost Explorer que vous pouvez utiliser pour analyser le coût et l'utilisation de vos ressources Amazon ECS. Vous pouvez utiliser Cost Explorer pour afficher les graphiques de votre utilisation et de vos coûts. Vous pouvez afficher les données des 13 derniers mois et prévoir vos dépenses pour les trois prochains mois. Vous pouvez utiliser Cost Explorer pour afficher des schémas de vos dépenses en ressources AWS au fil du temps. Par exemple, vous pouvez l'utiliser pour identifier les zones qui méritent d'être approfondies et connaître les tendances que vous pouvez utiliser pour comprendre vos coûts. Vous pouvez également spécifier des plages de temps pour les données et afficher des données temporelles par jour ou par mois. Vous pouvez utiliser des balises gérées par Amazon ECS ou des balises ajoutées par l'utilisateur pour votre rapport sur les coûts et l'utilisation. Pour de plus amples informations, veuillez consulter [Rapports d'utilisation d'Amazon ECS](usage-reports.md). Pour voir le coût de vos ressources combinées, vous pouvez organiser vos informations de facturation en fonction des ressources possédant les mêmes valeurs de clé d‘étiquette. Par exemple, vous pouvez étiqueter plusieurs ressources avec un nom d'application spécifique, puis organiser vos informations de facturation pour afficher le coût total de cette application dans plusieurs services. Pour en savoir plus sur la configuration d'un rapport de répartition des coûts avec des étiquettes, consultez [Rapport d'allocation des coûts mensuel](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/configurecostallocreport.html) dans le *guide de l'utilisateur AWS Billing *. En outre, vous pouvez activer les *données de répartition des coûts fractionnés* pour obtenir des données d'utilisation de la mémoire et du processeur au niveau des tâches dans vos rapports d'utilisation et de coût. Pour de plus amples informations, veuillez consulter [Rapports d'utilisation et de coût au niveau des tâches](usage-reports.md#task-cur). **Note** Si vous avez activé la création de rapports, 24 heures peuvent être nécessaires avant que les données du mois en cours puissent être consultées. # Ajout de balises aux ressources Amazon ECS Vous pouvez étiqueter des tâches, services, définitions de tâches et clusters nouveaux ou existants. Pour plus d’informations sur l’identification des instances de conteneur, consultez la section [Ajout de balises à une instance de conteneur Amazon EC2 pour Amazon ECS](instance-details-tags.md). **Avertissement** N'ajoutez pas de données d'identification personnelle (PII) ou d'autres informations confidentielles ou sensibles dans les étiquettes. Les tags sont accessibles à de nombreux AWS services, y compris la facturation. Les étiquettes ne sont pas destinées à être utilisées pour des données privées ou sensibles. Vous pouvez utiliser les ressources suivantes pour spécifier des balises lorsque vous créez la ressource. | Sous-tâche | Console | AWS CLI | Action d'API | | --- | --- | --- | --- | | Exécuter une ou plusieurs tâches. | [Exécution d’une application en tant que tâche Amazon ECS](standalone-task-create.md) | [run-task](https://docs.aws.amazon.com/cli/latest/reference/ecs/run-task.html) | [RunTask](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html) | | Créer un service. | [Création d’un déploiement de mise à jour propagée Amazon ECS](create-service-console-v2.md) | [create-service](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-service.html) | [CreateService](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html) | | Créer un ensemble de tâches. | [Déploiement de services Amazon ECS à l’aide d’un contrôleur tiers](deployment-type-external.md) | [create-task-set](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-task-set.html) | [CreateTaskSet](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateTaskSet.html) | | Enregistrer une définition de tâche. | [Création d’une définition de tâche Amazon ECS à l’aide de la console](create-task-definition.md) | [register-task-definition](https://docs.aws.amazon.com/cli/latest/reference/ecs/register-task-definition.html) | [RegisterTaskDefinition](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RegisterTaskDefinition.html) | | Créer un cluster. | [Création d’un cluster Amazon ECS pour les charges de travail Fargate](create-cluster-console-v2.md) | [create-cluster](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-cluster.html) | [CreateCluster](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCluster.html) | | Exécuter une ou plusieurs instances de conteneur. | [Lancement d'une instance de conteneur Amazon ECS Linux](launch_container_instance.md) | [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) | [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html) | | Créez un fournisseur de capacité pour les instances gérées Amazon ECS. | [Création d’un fournisseur de capacité pour les instances gérées Amazon ECS](create-capacity-provider-managed-instances.md) | [create-capacity-provider](https://docs.aws.amazon.com/cli/latest/reference/ecs/create-capacity-provider.html) | [CreateCapacityProvider](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html) | ## Ajout de balises aux ressources existantes (console Amazon ECS) Vous pouvez ajouter ou supprimer des balises associées à vos clusters, services, tâches et définitions de tâches directement depuis la page de la ressource. **Pour modifier une balise à une ressource individuelle** 1. Ouvrez la console à la [https://console.aws.amazon.com/ecs/version 2](https://console.aws.amazon.com/ecs/v2). 1. Dans la barre de navigation, sélectionnez le Région AWS à utiliser. 1. Dans le panneau de navigation, sélectionnez un type de ressource (par exemple, **Clusters**). 1. Sélectionnez la ressource à partir de la liste des ressources et choisissez l'onglet **Tags** (Balises), puis **Manage Tags** (Gérer les balises). 1. Configurez vos balises. [Ajouter une balise] Choisissez **Add tag** (Ajouter une balise), puis procédez comme suit : + Pour **Clé**, saisissez le nom de la clé. + Pour **Valeur**, saisissez la valeur de clé. 1. Choisissez **Enregistrer**. ## Ajout de balises à une ressource existante (AWS CLI) Vous pouvez ajouter ou remplacer une ou plusieurs balises à l'aide de l'API AWS CLI ou d'une API. **Note** Vous pouvez utiliser des points de terminaison de service à double pile pour interagir avec Amazon ECS à partir de AWS CLI SDKs, et de l'API Amazon ECS via les deux IPv4 et. IPv6 Pour de plus amples informations, veuillez consulter [Utilisation des points de terminaison à double pile Amazon ECS](dual-stack-endpoint.md). + AWS CLI - [tag-ressource](https://docs.aws.amazon.com/cli/latest/reference/ecs/tag-resource.html) + Action de l'API - [TagResource](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TagResource.html) # Balises pour les instances gérées Amazon ECS Les instances gérées Amazon ECS prennent en charge une combinaison de balises personnalisées et de balises ajoutées AWS qui peuvent être utilisées pour optimiser les coûts. Pour plus d’informations sur l’utilisation des balises de facturation, consultez la section [Mise à jour des balises pour la facturation](ecs-using-tags.md#tag-resources-for-billing). ## Tags ajoutés par AWS AWS ajoute les balises suivantes à chaque instance gérée Amazon ECS créée par le fournisseur de capacité : + Amazon ECS ajoute automatiquement les balises réservées `AmazonECSCreated` et `AmazonECSManaged` aux instances gérées Amazon ECS. + Amazon ECS ajoute les balises système suivantes à chaque instance : + Une balise avec une *clé* définie sur `aws:ecs:clusterName` et une *valeur* définie sur le nom du cluster. + Une balise avec une *clé* définie sur `aws:ecs:capacityProviderName` et une *valeur* définie sur le nom du fournisseur de capacité. + Une balise avec une *clé* définie sur `aws:ecs:containerInstanceId` et une *valeur* définie sur l’ID d’instance de conteneur pour l’instance gérée Amazon ECS. + Amazon EC2 ajoute la balise système `aws:ec2:managed-launch` avec la valeur `ecs-managed-instances`. En outre, Amazon EC2 ajoute des balises système indiquant le modèle de lancement utilisé pour créer l’instance gérée, ainsi que la flotte Amazon EC2 dont fait partie l’instance gérée. ## Balises personnalisées Vous pouvez ajouter des balises personnalisées supplémentaires aux instances gérées Amazon ECS en ajoutant des balises au fournisseur de capacité et en activant la propagation des balises à l’aide de la propriété `propagateTags`. Les balises du fournisseur de capacité se propagent aux instances gérées que le fournisseur de capacité lance L’exemple de définition de fournisseur de capacité suivant montre comment les balises peuvent être spécifiées et propagées à partir du fournisseur de capacité lors de la création du fournisseur de capacité en affectant la `CAPACITY_PROVIDER` valeur à `propagateTags`. ``` { "name": "my-cluster-managed-instances-cp", "cluster": "my-cluster", "tags": [ { "key":"tag_key", "value":"tag_value" } ], "managedInstancesProvider": { "infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole", "propagateTags": "CAPACITY_PROVIDER", "instanceLaunchTemplate": { "ec2InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/ecsInstanceProfile", "networkConfiguration": { "subnets": [ "subnet-abcdef01234567", "subnet-bcdefa98765432" ], "securityGroups": [ "sg-0123456789abcdef" ] } } } } ``` **Note** Lorsque vous ajoutez de nouvelles balises à un fournisseur de capacité, les balises nouvellement ajoutées ne sont pas propagées aux instances existantes, mais à toutes les instances nouvellement créées. Les clients sont autorisés à ajouter des balises directement aux instances EC2, mais ces balises ne sont pas retransmises au fournisseur de capacité Vous pouvez également étiqueter ou déétiqueter le fournisseur de capacité en utilisant [Ajout de balises à une ressource existante (AWS CLI)](tag-resources-console.md#tag-resources-api-sdk) ou [Ajout de balises aux ressources existantes (console Amazon ECS)](tag-resources-console.md#adding-or-deleting-tags) Pour plus d’informations sur les fournisseurs de capacité d’instances gérées Amazon ECS, consultez la section [Fournisseurs de capacité d’instances gérées Amazon ECS](managed-instances-capacity-providers-concept.md). # Ajout de balises à une instance de conteneur Amazon EC2 pour Amazon ECS Vous pouvez associer des balises à vos instances de conteneur Amazon EC2 pour Amazon ECS en utilisant l’une des méthodes suivantes : + Méthode 1 – Lorsque vous créez l'instance de conteneur avec l'API, la CLI ou la console Amazon EC2, spécifiez les balises en transmettant les données utilisateur à l'instance à l'aide du paramètre de configuration de l'agent de conteneur `ECS_CONTAINER_INSTANCE_TAGS`. Cela crée des balises qui sont associées uniquement à l'instance de conteneur dans Amazon ECS ; elles ne peuvent pas être répertoriés à l'aide de l'API Amazon EC2. Pour de plus amples informations, veuillez consulter [Démarrage des instances de conteneurs Amazon ECS Linux pour transmettre des données](bootstrap_container_instance.md). **Important** Si vous lancez vos instances de conteneur à l'aide d'un groupe Amazon EC2 Auto Scaling, vous devez utiliser le paramètre de configuration de l'agent ECS\$1CONTAINER\$1INSTANCE\$1TAGS pour ajouter des balises. Cela est dû à la manière dont les balises sont ajoutées aux instances Amazon EC2 lancées à l'aide des groupes Auto Scaling. Voici un exemple de script de données utilisateur qui associe des étiquettes avec votre instance de conteneur : ``` #!/bin/bash cat <<'EOF' >> /etc/ecs/ecs.config ECS_CLUSTER=MyCluster ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"} EOF ``` + Méthode 2 — Lorsque vous créez votre instance de conteneur à l'aide de l'API Amazon EC2, de la CLI ou de la console, spécifiez d'abord les balises à l'aide du paramètre `TagSpecification.N`. Transmettez ensuite les données utilisateur à l'instance à l'aide du paramètre de configuration de l'agent de conteneur `ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM`. Cela les propage depuis Amazon EC2 vers Amazon ECS. L'exemple suivant présente un script de données utilisateur qui propage les balises associées à une instance Amazon EC2 et enregistre l'instance avec un cluster nommé `MyCluster`. ``` #!/bin/bash cat <<'EOF' >> /etc/ecs/ecs.config ECS_CLUSTER=MyCluster ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM=ec2_instance EOF ``` Pour donner l'autorisation aux balises de l'instance de conteneur de propager les données depuis Amazon EC2 vers Amazon ECS, ajoutez manuellement les autorisations suivantes comme stratégie en ligne au rôle IAM de l'instance de conteneur Amazon ECS. Pour plus d'informations, consultez [Ajout et suppression de politiques IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html). + `ec2:DescribeTags` L'exemple suivant de stratégie ajoute ces autorisations. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ec2:DescribeTags" ], "Resource": "*" } ] } ``` ------ # Ajout de balises à une instance de conteneur externe pour Amazon ECS Vous pouvez associer des balises à vos instances de conteneur externes pour Amazon ECS en utilisant l’une des méthodes suivantes. + Méthode 1 – Avant d'exécuter le script d'installation pour enregistrer votre instance externe auprès de votre cluster, créez ou modifiez le fichier de configuration de l'agent de conteneur Amazon ECS à l'adresse `/etc/ecs/ecs.config` et ajoutez le paramètre de configuration `ECS_CONTAINER_INSTANCE_TAGS` de l'agent de conteneur. Cela permet de créer des balises associées à l'instance externe. Voici un exemple de syntaxe. ``` ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"} ``` + Méthode 2 — Une fois que votre instance externe est enregistrée dans votre cluster, vous pouvez utiliser le AWS Management Console pour ajouter des balises. Pour de plus amples informations, veuillez consulter [Ajout de balises aux ressources existantes (console Amazon ECS)](tag-resources-console.md#adding-or-deleting-tags). # Rapports d'utilisation d'Amazon ECS AWS fournit un outil de reporting appelé Cost Explorer que vous pouvez utiliser pour analyser le coût et l'utilisation de vos ressources Amazon ECS. Vous pouvez utiliser Cost Explorer pour afficher les graphiques de votre utilisation et de vos coûts. Vous pouvez afficher les données des 13 derniers mois et prévoir vos dépenses pour les trois prochains mois. Vous pouvez utiliser Cost Explorer pour afficher des schémas de vos dépenses en ressources AWS au fil du temps. Par exemple, vous pouvez l'utiliser pour identifier les zones qui méritent d'être approfondies et connaître les tendances que vous pouvez utiliser pour comprendre vos coûts. Vous pouvez également spécifier des plages de temps pour les données et afficher des données temporelles par jour ou par mois. Les données de mesure de votre rapport de coût et d'utilisation illustre l'utilisation parmi toutes vos tâches Amazon ECS. Les données de métrique incluent l'utilisation du processeur comme `vCPU-Hours` et l'utilisation de la mémoire comme `GB-Hours` pour chaque tâche exécutée. La manière dont ces données sont présentées dépend de l’option de calcul de la tâche. Pour les tâches utilisant Fargate, la colonne `lineItem/Operation` affiche `FargateTask` et vous permet de connaître le coût associé à chaque tâche. Pour les tâches utilisant EC2, la colonne `lineItem/Operation` affiche `ECSTask-EC2` et les tâches ne seront pas associées à un coût direct. Les données de mesure indiquées dans le rapport, telles que l'utilisation de la mémoire, représentent le total des ressources réservées par la tâche au cours de la période de facturation que vous spécifiez. Vous pouvez utiliser ces données pour déterminer le coût de votre cluster sous-jacent d'instances Amazon EC2. Les données de coût et d'utilisation de vos instances Amazon EC2 seront répertoriées séparément sous le service Amazon EC2. Vous pouvez également utiliser les balises gérées par Amazon ECS pour identifier le service ou cluster auquel chaque tâche appartient. Pour de plus amples informations, veuillez consulter [Mise à jour des balises pour la facturation](ecs-using-tags.md#tag-resources-for-billing). **Important** Les données de mesure sont uniquement visualisables pour les tâches lancées à compter du 16 novembre 2018. Les tâches lancées avant cette date n'affichent pas les données de mesure. Voici un exemple des champs que vous pouvez trier par données d'attribution de coût dans Cost Explorer. + Nom du cluster + Nom du service + Étiquettes de ressources + Type de lancement + Région AWS + Type d'utilisation Pour plus d'informations sur la création d'un rapport sur les AWS coûts et l'utilisation, consultez le rapport sur [les AWS coûts et l'utilisation](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-reports-costusage.html) dans le *guide de AWS Billing l'utilisateur*. ## Rapports d'utilisation et de coût au niveau des tâches AWS Cost Management peut fournir des données d'utilisation du processeur et de la mémoire AWS Cost and Usage Report pour chaque tâche sur Amazon ECS, y compris les tâches sur Fargate et les tâches sur EC2. Ces données sont appelées *données de répartition des coûts fractionnés*. Vous pouvez utiliser ces données pour analyser les coûts et l'utilisation des applications. En outre, vous pouvez fractionner et répartir les coûts entre les différentes unités commerciales et équipes à l'aide de balises de répartition des coûts et de catégories de coûts. Pour plus d'informations sur les *données de répartition des coûts fractionnés*, voir [Comprendre les données de répartition des coûts partagés](https://docs.aws.amazon.com/cur/latest/userguide/split-cost-allocation-data.html) dans le Guide de AWS Cost and Usage Report l'utilisateur. Vous pouvez activer les *données de répartition des coûts fractionnés* au niveau des tâches pour le compte dans l' AWS Cost Management Console. Si vous avez un compte de gestion (payeur), vous pouvez choisir d'appliquer cette configuration à chaque compte associé depuis le compte payeur. Une fois que vous avez configuré les *données de répartition des coûts*, des colonnes supplémentaires apparaîtront sous l'**splitLineItem**en-tête du rapport. Pour plus d'informations, voir les [détails des articles divisés](https://docs.aws.amazon.com/cur/latest/userguide/split-line-item-columns.html) dans le guide de l' AWS Cost and Usage Report utilisateur. Pour les tâches sur EC2, ces données fractionnent le coût de l'instance EC2 en fonction de l'utilisation des ressources ou des réservations et des ressources restantes de l'instance. Les conditions requises sont les suivantes : + Définissez le paramètre de configuration de l’agent Amazon ECS `ECS_DISABLE_METRICS` sur `false`. Lorsque ce paramètre est défini`false`, l'agent Amazon ECS envoie des métriques à Amazon CloudWatch. Sous Linux, ce paramètre est défini `false` par défaut et les métriques sont envoyées à CloudWatch. Sous Windows, ce paramètre est défini `true` par défaut. Vous devez donc le modifier `false` CloudWatch pour envoyer les mesures AWS Cost Management à utiliser. Pour en savoir plus sur la configuration de l'agent ECS, veuillez consulter [Configuration de l'agent de conteneur Amazon ECS](ecs-agent-config.md). + La version minimale de Docker pour des métriques fiables est la version v20.10.13 et les versions ultérieures, qui sont incluses dans l'AMI 20220607 optimisée pour Amazon ECS et les versions plus récentes. Pour utiliser les *données de répartition des coûts fractionnés*, vous devez créer un rapport et sélectionner **Données de répartition des coûts fractionnés**. Pour plus d'informations, consultez la section [Création de rapports sur les coûts et l'utilisation](https://docs.aws.amazon.com/cur/latest/userguide/cur-create.html) dans le guide de AWS Cost and Usage Report l'utilisateur. AWS Cost Management calcule les *données de répartition des coûts* en fonction du processeur de la tâche et de l'utilisation de la mémoire. AWS Cost Management peut utiliser le processeur de tâche et la réservation de mémoire au lieu de l'utilisation, si l'utilisation n'est pas disponible. Si vous constatez que le CUR utilise les réservations, vérifiez que vos instances de conteneur répondent aux conditions requises et que les mesures d'utilisation des ressources des tâches apparaissent dans CloudWatch.