

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon EMR 클러스터 리소스에 태그 지정 및 분류
<a name="emr-plan-tags"></a>

용도, 소유자 또는 환경 등 다양한 방식으로 AWS 리소스를 분류하는 것이 편리할 수 있습니다. Amazon EMR에서 이 작업을 수행하려면 태그를 사용하여 사용자 지정 메타데이터를 Amazon EMR 클러스터에 할당하면 됩니다. 각 태그는 사용자가 정의하는 키와 값으로 구성됩니다. Amazon EMR의 경우 클러스터는 태그를 지정할 수 있는 리소스 수준에 있습니다. 예를 들어, 각 클러스터 소유자를 추적하고 프로덕션 클러스터와 테스트 클러스터 간에 식별하는 데 도움이 되는 계정의 클러스터에 대한 태그 집합을 정의할 수 있습니다. 조직 요구 사항에 맞는 일관된 태그 집합을 생성하는 것이 좋습니다.

또한 태그를 Amazon EMR 클러스터에 추가하면 태그가 클러스터와 연결된 각각의 활성 Amazon EC2 인스턴스로 전파됩니다. 마찬가지로, 태그를 Amazon EMR에서 제거할 경우 해당 태그가 각각의 연결된 활성 Amazon EC2 인스턴스에서도 제거됩니다.

**중요**  
Amazon EC2에서 수행된 변경 사항은 Amazon EMR 태그 지정 시스템으로 동기화되지 않으므로 Amazon EMR 콘솔이나 CLI를 사용하여 Amazon EC2 콘솔 또는 CLI 대신에 클러스터의 일부로 포함된 Amazon EC2 인스턴스에서 태그를 관리할 수 있습니다.

다음 시스템 태그를 찾아서 Amazon EMR 클러스터의 일부로 포함된 Amazon EC2 인스턴스를 식별할 수 있습니다. 이 예에서 *CORE*는 인스턴스 그룹 역할의 값이며 *j-12345678*이 예제 작업 흐름(클러스터) 식별자 값입니다.
+ aws:elasticmapreduce:instance-group-role=*CORE*
+ aws:elasticmapreduce:job-flow-id=*j-12345678*

**참고**  
Amazon EMR 및 Amazon EC2는 태그를 의미 체계가 없는 문자열로 해석합니다.

 AWS Management Console, CLI 및 API를 사용하여 태그로 작업할 수 있습니다.

새 Amazon EMR 클러스터 생성 시 태그를 추가하고 실행 중인 Amazon EMR 클러스터에서 태그를 추가, 편집 또는 제거할 수 있습니다. 태그 편집은 Amazon EMR 콘솔에 적용되는 개념이지만, CLI 및 API를 사용하여 태그를 편집함으로써 이전 태그를 제거하고 새 태그를 추가할 수 있습니다. 태그 키와 값을 편집할 수 있으며 언제든지 클러스터가 실행 중일 때 리소스에서 태그를 제거할 수 있습니다. 하지만 여전히 활성화되어 있는 클러스터와 이전에 연결되었던 종료된 클러스터나 인스턴스에(서) 태그를 추가, 편집 또는 제거할 수는 없습니다. 또한, 태그의 값을 빈 문자열로 설정할 수 있지만, 태그의 값을 Null로 설정할 수는 없습니다.

태그별 리소스 기반 권한에 대해 Amazon EC2 인스턴스와 함께 AWS Identity and Access Management (IAM)를 사용하는 경우 Amazon EMR이 클러스터의 Amazon EC2 인스턴스로 전파하는 태그에 IAM 정책이 적용됩니다. Amazon EMR 태그를 Amazon EC2 인스턴스로 전파하려는 경우, Amazon EC2에 대한 IAM 정책에서 Amazon EC2 CreateTags 및 DeleteTags API를 직접 호출할 수 있는 권한을 허용해야 합니다. 또한 전파된 태그는 Amazon EC2의 리소스 기반 권한에 영향을 미칠 수 있습니다. Amazon EC2로 전파된 태그는 다른 Amazon EC2 태그와는 달리 IAM 정책에서 조건으로 읽을 수 있습니다. 사용자에게 클러스터에 대한 잘못된 권한을 부여하지 않으려면 Amazon EMR 클러스터에 태그를 추가할 때 IAM 정책에 유의해야 합니다. 문제를 방지하려면 Amazon EMR 클러스터에 사용하려는 태그에 대한 조건을 IAM 정책에 포함되지 않도록 해야 합니다. 자세한 내용은 [Amazon EC2 리소스에 대한 액세스 제어](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UsingIAM.html)를 참조하세요.

# Amazon EMR에서 리소스 태그 지정에 적용되는 제한 사항
<a name="emr-plan-tags-restrictions"></a>

 태그에 적용되는 기본 제한 사항은 다음과 같습니다.
+ Amazon EC2 리소스에 적용되는 제한 사항이 Amazon EMR에도 적용됩니다. 자세한 내용은 [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-restrictions](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-restrictions) 단원을 참조하십시오.
+ 태그 이름 및 값에 `aws:` 접두사는 AWS 사용하도록 예약되어 있으므로 사용하지 마십시오. 또한 이 접두사가 지정된 태그 이름이나 값은 편집하거나 삭제할 수 없습니다.
+ 종료된 클러스터에 대해 태그를 변경하거나 편집할 수 없습니다.
+ 태그 값에 빈 문자열은 지정할 수 있지만, null은 지정할 수 없습니다. 또한 태그 키에도 빈 문자열을 지정할 수 없습니다.
+ 키와 값에는 모든 언어의 알파벳 문자를 비롯해 숫자 문자, 공백, 숨겨진 구분자, 기호(\$1 . : / = \$1 - @) 등이 포함될 수 있습니다.

를 사용한 태그 지정에 대한 자세한 내용은 *Amazon EC2 사용 설명서*[의 콘솔에서 태그 작업을](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_Console) AWS Management Console참조하세요. Amazon EC2API 또는 명령줄을 사용하는 태그 지정에 대한 자세한 내용은 **Amazon EC2 사용 설명서에서 [API 및 CLI 개요](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#Using_Tags_CLI)를 참조하세요.

# 청구를 위해 Amazon EMR 리소스에 태그 지정
<a name="emr-plan-tags-billing"></a>

태그를 사용하여 자체 비용 구조를 반영하도록 AWS 청구서를 구성할 수 있습니다. 이렇게 하려면 가입하여 태그 키 값이 포함된 AWS 계정 청구서를 가져옵니다. 결합된 리소스의 비용을 확인하려는 경우 태그 키 값별로 결제 정보를 구성할 수 있습니다. Amazon EMR 및 Amazon EC2의 요금 청구서가 서로 다르더라도 각 클러스터의 태그가 각각의 연결된 인스턴스에 추가되므로 태그를 사용하여 관련 Amazon EMR 및 Amazon EC2 비용을 연결할 수 있습니다.

예를 들어, 특정 애플리케이션 이름으로 여러 리소스에 태그를 지정한 다음 결제 정보를 구성하여 여러 서비스에 걸친 해당 애플리케이션의 총 비용을 볼 수 있습니다. 자세한 내용은 *AWS Billing 사용 설명서*에서 [비용 할당 및 태그 지정](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation.html)을 참조하세요.

# Amazon EMR 클러스터에 태그 추가
<a name="emr-plan-tags-add-new"></a>

생성 시 클러스터에 태그를 추가할 수 있습니다.

------
#### [ Console ]

**새 콘솔을 사용하여 클러스터를 생성할 때 태그를 추가하는 방법**

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/emr](https://console.aws.amazon.com/emr) Amazon EMR 콘솔을 엽니다.

1. 왼쪽 탐색 창의 **EMR on EC2**에서 **클러스터**를 선택하고 **클러스터 생성**을 선택합니다.

1. **태그** 아래에서 **새 태그 추가**를 선택합니다. **키** 필드에서 태그를 지정합니다. 선택적으로 **값** 필드에서 태그를 지정합니다.

1. 클러스터에 적용할 다른 옵션을 선택합니다.

1. 클러스터를 시작하려면 **클러스터 생성**을 선택합니다.

------
#### [ AWS CLI ]

**를 사용하여 클러스터를 생성할 때 태그를 추가하려면 AWS CLI**

다음 예제에서는 AWS CLI를 사용하여 태그를 새 클러스터에 추가하는 방법을 보여 줍니다. 클러스터 생성 시 태그를 추가하려면 `create-cluster` 하위 명령을 `--tags` 파라미터와 함께 입력합니다.
+ 클러스터 생성 시 *costCenter* 태그를 키 값*marketing*과 함께 추가하려면 다음 명령을 입력하고 *myKey*를 EC2 키 페어의 이름으로 바꿉니다.

  ```
  aws emr create-cluster --name "Test cluster" --release-label emr-4.0.0 --applications Name=Hadoop Name=Hive Name=Pig --tags "costCenter=marketing" --use-default-roles --ec2-attributes KeyName=myKey --instance-type m5.xlarge --instance-count 3
  ```

  `--instance-groups` 파라미터를 사용하지 않고 인스턴스 수를 지정하면 단일 마스터 노드가 시작되고 나머지 인스턴스는 코어 노드로 시작됩니다. 모든 노드는 이 명령에 지정된 인스턴스 유형을 사용합니다.
**참고**  
EMR 서비스 역할과 EC2 인스턴스 프로파일을 아직 생성하지 않았다면 `emr create-default-roles` 하위 명령을 입력하기 전에 aws `create-cluster`를 입력하여 생성합니다.

  에서 Amazon EMR 명령을 사용하는 방법에 대한 자세한 내용은 섹션을 AWS CLI참조하세요[https://docs.aws.amazon.com/cli/latest/reference/emr](https://docs.aws.amazon.com/cli/latest/reference/emr).

------

기존 클러스터에도 태그를 추가할 수 있습니다.

------
#### [ Console ]

**새 콘솔을 사용하여 기존 클러스터에 태그를 추가하는 방법**

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/emr](https://console.aws.amazon.com/emr) Amazon EMR 콘솔을 엽니다.

1. 왼쪽 탐색 창의 **EMR on EC2**에서 **클러스터**를 선택하고 업데이트할 클러스터를 선택합니다.

1. 클러스터 세부 정보 페이지의 **태그** 탭에서 **태그 관리**를 선택합니다. **키** 필드에서 태그를 지정합니다. 선택적으로 **값** 필드에서 태그를 지정합니다.

1. **변경 사항 저장**을 선택합니다. **태그** 탭은 클러스터에 있는 새 태그 번호로 업데이트됩니다. 예를 들어, 이제 두 개의 태그가 있는 경우 탭의 레이블은 **태그 (2)**입니다.

------
#### [ AWS CLI ]

**를 사용하여 실행 중인 클러스터에 태그를 추가하려면 AWS CLI**
+ `add-tags` 하위 명령을 `--tag` 파라미터와 함께 입력하여 태그를 클러스터 ID에 할당합니다. 콘솔이나 `list-clusters` 명령을 사용하여 클러스터 ID를 찾을 수 있습니다. `add-tags` 하위 명령에는 현재 리소스 ID 하나만 허용됩니다.

  예를 들어, 값이 *marketing*인 *costCenter*라는 키를 가진 태그, 그리고 값이 *accounting*이고 이름이 *other*인 태그와 같이 두 개의 태그를 실행 중인 클러스터에 추가하려면 다음 명령을 입력하고 *j-KT4XXXXXXXX1NM*을 클러스터 ID로 바꿉니다.

  ```
  aws emr add-tags --resource-id j-KT4XXXXXXXX1NM --tag "costCenter=marketing" --tag "other=accounting"
  ```

   AWS CLI를 사용하여 태그를 추가하면 명령의 출력이 없습니다. 에서 Amazon EMR 명령을 사용하는 방법에 대한 자세한 내용은 섹션을 AWS CLI참조하세요[https://docs.aws.amazon.com/cli/latest/reference/emr](https://docs.aws.amazon.com/cli/latest/reference/emr).

------

# Amazon EMR 클러스터에서 태그 보기
<a name="emr-plan-tags-view"></a>

클러스터와 연결된 모든 태그를 보려는 경우 콘솔이나 AWS CLI에서 볼 수 있습니다.

------
#### [ Console ]

**새 콘솔을 사용하여 클러스터의 태그를 보는 방법**

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/emr](https://console.aws.amazon.com/emr) Amazon EMR 콘솔을 엽니다.

1. 왼쪽 탐색 창의 **EMR on EC2**에서 **클러스터**를 선택하고 업데이트할 클러스터를 선택합니다.

1. 모든 태그를 보려면 클러스터 세부 정보 페이지에서 **태그** 탭을 선택합니다.

------
#### [ AWS CLI ]

**를 사용하여 클러스터의 태그를 보려면 AWS CLI**

를 사용하여 클러스터의 태그를 보려면 `--query` 파라미터와 함께 `describe-cluster` 하위 명령을 AWS CLI입력합니다.
+ 클러스터의 태그를 보려면 다음 명령을 입력하고 *j-KT4XXXXXXXX1NM*을 클러스터 ID로 바꿉니다.

  ```
  1. aws emr describe-cluster --cluster-id j-KT4XXXXXX1NM --query Cluster.Tags
  ```

  출력에는 다음과 비슷한 클러스터에 대한 모든 태그 정보가 표시됩니다.

  ```
  Value: accounting     Value: marketing                
  Key: other            Key: costCenter
  ```

  에서 Amazon EMR 명령을 사용하는 방법에 대한 자세한 내용은 섹션을 AWS CLI참조하세요[https://docs.aws.amazon.com/cli/latest/reference/emr](https://docs.aws.amazon.com/cli/latest/reference/emr).

------

# Amazon EMR 클러스터에서 태그 제거
<a name="emr-plan-tags-delete"></a>

더 이상 태그를 필요하지 않으면 클러스터에서 제거할 수 있습니다.

------
#### [ Console ]

**새 콘솔을 사용하여 클러스터에서 태그를 제거하는 방법**

1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/emr](https://console.aws.amazon.com/emr) Amazon EMR 콘솔을 엽니다.

1. 왼쪽 탐색 창의 **EMR on EC2**에서 **클러스터**를 선택하고 업데이트할 클러스터를 선택합니다.

1. 클러스터 세부 정보 페이지의 **태그** 탭에서 **태그 관리**를 선택합니다.

1. 제거하려는 각 키 값 페어에 대해 **제거**를 선택합니다.

1. **변경 사항 저장**을 선택합니다.

------
#### [ AWS CLI ]

**를 사용하여 클러스터에서 태그를 제거하려면 AWS CLI**

`--tag-keys` 파라미터와 함께 `remove-tags` 하위 명령을 입력합니다. 태그를 제거할 때는 키 이름만 필요합니다.
+ 클러스터에서 태그를 제거하려면 다음 명령을 입력하고 *j-KT4XXXXXXXX1NM*을 클러스터 ID로 바꿉니다.

  ```
  aws emr remove-tags --resource-id j-KT4XXXXXX1NM --tag-keys "costCenter"
  ```
**참고**  
현재는 단일 명령을 사용하여 여러 태그를 제거할 수 없습니다.

  에서 Amazon EMR 명령을 사용하는 방법에 대한 자세한 내용은 섹션을 AWS CLI참조하세요[https://docs.aws.amazon.com/cli/latest/reference/emr](https://docs.aws.amazon.com/cli/latest/reference/emr).

------