Ajouter des balises à une instance de conteneur Amazon ECS

Vous pouvez associer des étiquettes à vos instances de conteneur 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 plus d’informations, consultez Démarrage des instances de conteneur Linux Amazon ECS pour transmettre des données.

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

  • ec2:DescribeTags

  L'exemple suivant de stratégie ajoute ces autorisations.

  {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
              	"ec2:DescribeTags"
              ],
              "Resource": "*"
          }
      ]
  }

Instances de conteneurs externes

Vous pouvez associer des balises à vos instances de conteneur externes 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 plus d’informations, consultez Ajouter des balises aux ressources existantes (console Amazon ECS).