Hinzufügen von Tags zu einer Amazon ECS-Container-Instance

Sie können mit einer der folgenden Methoden Tags zu Ihren Container-Instances zuweisen:

• Methode 1: Beim Erstellen der Container-Instance geben Sie mit der Amazon EC2-API, -CLI oder -Konsole die Tags an, indem Sie Benutzerdaten mit dem Konfigurationsparameter ECS_CONTAINER_INSTANCE_TAGS an die Instance übergeben. Dadurch werden Tags erstellt, die nur der Container-Instance in Amazon ECS zugeordnet sind. Sie können nicht mithilfe der Amazon EC2-API angeboten werden. Weitere Informationen finden Sie unter Bootstrapping von Amazon ECS-Linux-Container-Instances zur Datenübergabe.

  Wichtig

  Wenn Sie Ihre Container-Instances mit einer Amazon EC2 Auto Scaling-Gruppe starten, sollten Sie den Agent-Konfigurationsparameter ECS_CONTAINER_INSTANCE_TAGS verwenden, um Tags hinzuzufügen. Dies liegt an der Art und Weise, in der Amazon-EC2-Instances Tags hinzugefügt werden, die mit Auto-Scaling-Gruppen gestartet werden.

  Nachfolgend ist ein Beispiel für ein Benutzerdatenskript angeführt, das Tags mit Ihrer Container-Instance verknüpft:

  #!/bin/bash
  cat <<'EOF' >> /etc/ecs/ecs.config
  ECS_CLUSTER=MyCluster
  ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}
  EOF

• Methode 2: Beim Erstellen Ihrer Container-Instance geben Sie mit der Amazon-EC2-API, -CLI oder -Konsole die Tags zunächst mit dem Parameter TagSpecification.N an. Übergeben Sie dann Benutzerdaten mithilfe des Container-Agent-Konfigurationsparameters ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM an die Instance. Dadurch werden sie von Amazon EC2 an Amazon ECS weitergegeben.

  Nachfolgend finden Sie ein Beispiel für ein Benutzerdaten-Skript, das die mit einer Amazon-EC2-Instance verknüpften Tags propagiert und die Instance mit einem Cluster namens MyCluster registriert:

  #!/bin/bash
  cat <<'EOF' >> /etc/ecs/ecs.config
  ECS_CLUSTER=MyCluster
  ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM=ec2_instance
  EOF

  Um den Zugriff zu gewähren, damit Container-Instance-Tags von Amazon EC2 zu Amazon ECS propagieren werden können, fügen Sie manuell der IAM-Rolle der Amazon-ECS-Container-Instance die folgenden Berechtigungen als Inline-Richtlinie hinzu. Weitere Informationen finden Sie unter Hinzufügen und Entfernen von IAM-Richtlinien.

  • ec2:DescribeTags

  Das folgende ist ein Beispiel einer Richtlinie mit der diese Berechtigungen hinzugefügt werden.

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

Externe Container-Instances

Sie können mit einer der folgenden Methoden Tags zu Ihren externen Container-Instances zuweisen:

• Methode 1: Bevor Sie das Installationsskript ausführen, um Ihre externe Instance bei Ihrem Cluster zu registrieren, erstellen oder bearbeiten Sie die Konfigurationsdatei für den Amazon-ECS-Container Agent unter /etc/ecs/ecs.config und fügen Sie den ECS_CONTAINER_INSTANCE_TAGS-Konfigurationsparameter hinzu. Dadurch werden Tags erstellt, die der externen Instance zugeordnet sind.

  Es folgt ein Beispiel für die Syntax.

  ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}

• Methode 2 — Nachdem Ihre externe Instance in Ihrem Cluster registriert wurde, können Sie die verwenden, AWS Management Console um Tags hinzuzufügen. Weitere Informationen finden Sie unter Hinzufügen von Tags zu vorhandenen Ressourcen (Amazon ECS-Konsole).