Amazon ECS コンテナインスタンスにタグを追加する

方法 1 – Amazon EC2、API、CLI、またはコンソールを使用してコンテナインスタンスを作成するときに、コンテナエージェントの設定パラメータ ECS_CONTAINER_INSTANCE_TAGS を使用してインスタンスにユーザーデータを渡すことで、タグを指定します。これにより、Amazon ECS のコンテナインスタンスにのみ関連付けられているタグが作成され、Amazon EC2 API では一覧表示できなくなります。詳細については、「Amazon ECS Linux コンテナインスタンスをブートストラップしてデータを渡す」を参照してください。

コンテナインスタンスにタグを関連付けるユーザーデータスクリプトの例を次に示します。

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

方法 2 – Amazon EC2 API、CLI、またはコンソールを使用してコンテナインスタンスを作成する場合、最初に TagSpecification.N パラメータを使用してタグを指定します。その後、コンテナエージェント設定パラメータ ECS_CONTAINER_INSTANCE_PROPAGATE_TAGS_FROM を使用して、ユーザーデータをインスタンスに渡します。これにより、Amazon EC2 から Amazon ECS に伝播されます。

以下に、Amazon EC2 インスタンスに関連付けられたタグを伝播し、さらに MyCluster という名前のクラスターでインスタンスを登録するユーザーデータスクリプトの例を示します。

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

コンテナインスタンスのタグが Amazon EC2 から Amazon ECS に伝達されることを許可するには、以下のアクセス許可を コンテナインスタンスの IAM ロールにインラインポリシーとして手動で追加します。詳細については、「IAM ポリシーの追加と削除」を参照してください。

これらのアクセス許可を追加するために使用される、ポリシーの例を次に示します。

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

方法 1 — インストールスクリプトを実行して外部インスタンスをクラスターに登録する前に、Amazon ECS コンテナエージェント設定ファイル (/etc/ecs/ecs.configを追加しECS_CONTAINER_INSTANCE_TAGSコンテナエージェント設定パラメーター。これにより、外部インスタンスに関連付けられているタグが作成されます。

構文の例を次に示します。

ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}

方法 2 — 外部インスタンスがクラスターに登録された後、AWS Management Console を使用して、タグを追加できます。詳細については、「既存のリソースにタグを追加する (Amazon ECS コンソール)」を参照してください。