Comment puis-je identifier les ressources Amazon ECS à des fins de suivi des coûts et de conformité ?

Brève description

Utilisez des identifications pour attribuer des métadonnées personnalisées à vos ressources Amazon ECS.

Résolution

Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre des erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.

Activer l'autorisation d’identification des ressources au niveau du compte

Pour utiliser et créer une identification lorsque vous créez un cluster ou un service, vous devez disposer des autorisations ecs:TagResource. Vous devez également disposer des autorisations nécessaires pour effectuer les actions nécessaires à la création de la ressource, telles que ecsCreateCluster.

Pour afficher le statut actuel de l'autorisation d’identification au niveau du compte AWS, exécutez la commande list-account-settings de l'AWS CLI suivante :

aws ecs list-account-settings --effective-settings

Dans la sortie de la commande, vérifiez si vous avez activé l'autorisation d’identification. Si vous n'avez pas activé l'autorisation d’identification, exécutez la commande put-account-setting-default suivante pour l'activer :

 aws ecs put-account-setting-default --name tagResourceAuthorization --value on --region regionname

Remarque : Remplacez regionname par votre région AWS.

Utiliser le format d’ARN approprié

Pour identifier les ressources Amazon ECS, vous devez utiliser les nouveaux formats d’ARN et d’ID. Vous devrez peut-être migrer votre déploiement Amazon ECS vers le nouveau format d'ARN et d'ID de ressource.

Vérifier que l’entité IAM dispose des autorisations requises et vérifier les restrictions d’identification

Si vous ne pouvez pas ajouter d’identifications à votre service Amazon ECS, assurez-vous que votre entité AWS Identity and Access Management (IAM) dispose des autorisations requises. Pour plus d'informations, consultez la section Vérifier que l'entité IAM possède les autorisations requises et vérifier les restrictions relatives aux identifications du chapitre Comment puis-je résoudre les problèmes d’identification pour les tâches Amazon ECS ?

Utiliser des identifications gérées par Amazon ECS pour la facturation

Activer le paramètre enableECSManagedTags

Lorsque vous utilisez des identifications gérées par Amazon ECS, Amazon ECS identifie automatiquement toutes les tâches récemment lancées avec les informations du cluster et la définition de tâche ou les identifications de service. Amazon ECS identifie également les volumes Amazon Elastic Block Service (Amazon EBS) associés aux tâches. Le paramètre PropagateTags n'est pas activé par défaut. Pour copier les identifications sur la tâche à partir du service ou de la définition de tâche, activez le paramètre.

Pour activer le paramètre enableECSManagedTags lorsque vous créez un service, exécutez la commande create-service suivante :

aws ecs create-service \
 --cluster clustername \
 --service-name servicename \
 --task-definition taskdefinitionname \
 --desired-count 1 \
 --launch-type FARGATE \
 --enable-ecs-managed-tags \
 --network-configuration "awsvpcConfiguration={subnets=[subnet-ABCD],securityGroups=[sg-ABC],assignPublicIp=ENABLED}"

Remarque : Remplacez clustername par le nom de votre cluster, servicename par votre nom de service et taskdefinitionname par le nom de votre définition de tâche. Ajoutez votre configuration réseau à l'option --network-configuration.

Pour activer le paramètre enableECSManagedTags lorsque vous exécutez une tâche, exécutez la commande run-task suivante :

aws ecs run-task \
 --cluster clustername \
 --task-definition taskdefinitionname  \
 --launch-type FARGATE \
 --enable-ecs-managed-tags \
 --network-configuration "awsvpcConfiguration={subnets=[subnet-ABC],securityGroups=[sg-ABC]}"

Remarque : Remplacez clustername par le nom de votre cluster et taskdefinitionname par le nom de votre définition de tâche. Ajoutez votre configuration réseau à l'option --network-configuration.

Activer les identifications gérées par Amazon ECS

Utilisez la console Amazon ECS ou l'AWS CLI pour activer les identifications gérées.

Console Amazon ECS

Procédez comme suit :

1. Ouvrez la console Amazon ECS.
2. Sélectionnez la région de votre ressource ECS.
3. Dans le volet de navigation, sélectionnez Définitions de tâche.
4. Sélectionnez la définition de tâche dans la liste des ressources, puis choisissez Actions.
5. Sélectionnez Créer un service ou Exécuter une tâche.
6. Dans Configuration d’identification de tâche, sélectionnez Activer les identifications gérées par ECS.
   Remarque : Pour copier les identifications de la définition de tâche ou du service vers la tâche, dans Propager les identifications à partir de, sélectionnez votre ressource. Par défaut, le paramètre PropagateTags est défini sur Ne pas propager.

AWS CLI

Exécutez la commande update-service suivante :

aws ecs update-service --cluster clustername --service servicename --enable-ecs-managed-tags --force-new-deployment

Remarque : Remplacez servicename par le nom de votre service et clustername par le nom de votre cluster.

Configurer la propagation des identifications

La propagation des identifications est désactivée par défaut. Pour vérifier si vous avez activé PropagateTags dans un service spécifique, exécutez la commande describe-services suivante :

 aws ecs describe-services --services servicename --cluster clustername --region region --query 'services[*].propagateTags' --output text

Remarque : Remplacez servicename par le nom de votre service, clustername par le nom de votre cluster et region par votre région.

Pour ajouter la propagation d’identifications lorsque vous créez un service, exécutez la commande create-service suivante :

aws ecs create-service \
--cluster clustername \
--service-name servicename \
--task-definition taskdefinitionname \
--desired-count 1 \
--launch-type FARGATE \
--enable-ecs-managed-tags \
--propagate-tags TASK_DEFINITION-SERVICE \
--network-configuration "awsvpcConfiguration={subnets=[subnet-ABCD],securityGroups=[sg-ABC],assignPublicIp=ENABLED}"

Remarque : Remplacez clustername par le nom de votre cluster, servicename par votre nom de service et taskdefinitionname par votre définition de tâche. Remplacez également FARGATE par votre type de lancement et TASK_DEFINITION-SERVICE par TASK_DEFINITION ou SERVICE en fonction de l'endroit où vous souhaitez propager les tâches. Ajoutez votre configuration réseau à l'option --network-configuration.

Pour ajouter la propagation d’identifications lorsque vous exécutez une tâche, exécutez la commande run-task suivante :

aws ecs run-task \
--cluster clustername \
--task-definition taskdefinitionname \
--launch-type FARGATE \
--enable-ecs-managed-tags \
--propagate-tags TASK_DEFINITION-SERVICE \
--network-configuration "awsvpcConfiguration={subnets=[subnet-ABC],securityGroups=[sg-ABC]}"

Remarque : Remplacez clustername par le nom de votre cluster et taskdefinitionname par votre définition de tâche. Remplacez également FARGATE par votre type de lancement et TASK_DEFINITION-SERVICE par TASK_DEFINITION ou SERVICE en fonction de l'endroit où vous souhaitez propager les tâches. Ajoutez votre configuration réseau à l'option --network-configuration.

Pour ajouter la propagation d’identifications à un service existant, exécutez la commande update-service suivante :

aws ecs update-service --cluster clustername --service servicename --propagate-tags servicetagdefinition --force-new-deployment

Remarque : Remplacez servicename par le nom de votre service, clustername par le nom de votre cluster et servicetagdefinition par votre définition de service ou d’identification.

Vous devez activer les identifications de répartition des coûts afin qu'elles apparaissent sur votre rapport de facturation.

Remarque : l’activation des balises peut prendre jusqu’à 24 heures.

Informations connexes

Rapports d'utilisation d'Amazon ECS