Amazon ECS 컨테이너 인스턴스에 태그 추가

다음 방법 중 하나를 사용하면 태그를 컨테이너 인스턴스와 연결할 수 있습니다.

• 방법 1 – Amazon EC2 API, CLI 또는 콘솔을 사용하여 컨테이너 인스턴스를 생성할 때 컨테이너 에이전트 구성 파라미터 ECS_CONTAINER_INSTANCE_TAGS를 사용하여 사용자 데이터를 인스턴스에 전달해 태그를 지정합니다. 이렇게 하면 오로지 Amazon ECS의 컨테이너 인스턴스와 연결된 태그가 생성되며, 이러한 태그는 Amazon EC2 API를 사용하여 볼 수 없습니다. 자세한 내용은 데이터 전달을 위한 Amazon ECS Linux 컨테이너 인스턴스 부트스트래핑 섹션을 참조하세요.

  중요

  Amazon EC2 Auto Scaling 그룹을 사용하여 컨테이너 인스턴스를 시작한 경우 ECS_CONTAINER_INSTANCE_TAGS 에이전트 구성 파라미터를 사용하여 태그를 추가해야 합니다. 이는 Auto Scaling 그룹을 사용하여 시작된 Amazon EC2 인스턴스에 태그가 추가되는 방식 때문입니다.

  태그를 컨테이너 인스턴스와 연결하는 사용자 데이터 스크립트를 예시하면 다음과 같습니다.

  #!/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로 전파되도록 액세스를 제공하려면 Amazon ECS 컨테이너 인스턴스 IAM 역할에 대해 다음 권한을 인라인 정책으로 직접 추가합니다. 자세한 내용은 IAM 정책 추가 및 제거 섹션을 참조하세요.

  • ec2:DescribeTags

  다음은 이러한 권한을 추가하는 데 사용되는 정책 예제입니다.

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

외부 컨테이너 인스턴스

다음 방법 중 하나를 사용하면 태그를 외부 컨테이너 인스턴스와 연결할 수 있습니다.

• 방법 1 — 외부 인스턴스를 클러스터에 등록하기 위해 설치 스크립트를 실행하기 전에 /etc/ecs/ecs.config에 Amazon ECS 컨테이너 에이전트 구성 파일을 생성하거나 편집하고 ECS_CONTAINER_INSTANCE_TAGS 컨테이너 에이전트 구성 파라미터를 추가합니다. 이렇게 하면 외부 인스턴스와 연결된 태그가 생성됩니다.

  다음은 구문의 예제입니다.

  ECS_CONTAINER_INSTANCE_TAGS={"tag_key": "tag_value"}

• 방법 2 — 외부 인스턴스가 클러스터에 등록되면 AWS Management Console을 사용해 태그를 추가합니다. 자세한 내용은 기존 리소스에 태그 추가(Amazon ECS 콘솔) 단원을 참조하십시오.