Amazon EMR on EKS 리소스 태그 지정

Amazon EMR on EKS 리소스 관리를 지원하려면 태그를 사용하여 각 리소스에 고유한 메타데이터를 할당할 수 있습니다. 이 주제에서는 태그 함수에 대한 개요를 제공하고 태그를 생성하는 방법을 보여줍니다.

태그 기본 사항

태그는 AWS 리소스에 할당하는 레이블입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.

태그를 사용하면 용도, 소유자 또는 환경과 같은 속성으로 AWS 리소스를 분류할 수 있습니다. 동일한 유형의 리소스가 많은 경우 할당한 태그에 따라 특정 리소스를 빠르게 식별할 수 있습니다. 예를 들어 Amazon EMR on EKS 클러스터에 태그 세트를 정의하면 클러스터의 소유자 및 스택 수준을 추적하는 데 도움이 됩니다. 각 리소스 유형에 대해 일관된 태그 키 집합을 고안하는 것이 좋습니다. 그러면 추가하는 태그에 따라 리소스를 검색하고 필터링할 수 있습니다.

태그가 리소스에 자동으로 할당되는 것은 아닙니다. 태그를 추가한 후에는 언제든지 태그 키와 값을 편집하거나 리소스에서 태그를 제거할 수 있습니다. 리소스를 삭제하면 리소스 태그도 삭제됩니다.

태그는 Amazon EMR on EKS에는 아무런 의미가 없으며 엄격하게 문자열로 해석됩니다.

태그 값에 빈 문자열은 지정할 수 있지만, null은 지정할 수 없습니다. 태그 키는 빈 문자열일 수 없습니다. 해당 리소스에 대해 키가 기존 태그와 동일한 태그를 추가하는 경우 새 값이 이전 값을 덮어씁니다.

AWS Identity and Access Management(IAM)를 사용하는 경우 AWS 계정에서 태그를 관리할 수 있는 권한을 가진 사용자를 제어할 수 있습니다.

태그 기반 액세스 제어 정책 예제는 태그 기반 액세스 제어를 위한 정책 섹션을 참조하세요.

리소스 태깅

활성 상태인 새로운 가상 클러스터 또는 기존 가상 클러스터와 작업 실행에 태그를 지정할 수 있습니다. 작업 실행의 활성 상태로, PENDING, SUBMITTED, RUNNING, CANCEL_PENDING이 있습니다. 가상 클러스터의 활성 상태로, RUNNING, TERMINATING, ARRESTED가 있습니다. 자세한 정보는 작업 실행 상태 및 가상 클러스터 상태 섹션을 참조하세요.

가상 클러스터가 종료되면 태그가 정리되고 더 이상 태그에 액세스할 수 없습니다.

Amazon EMR on EKS API, AWS CLI 또는 AWS SDK를 사용 중인 경우 관련 API 작업의 태그 파라미터를 사용하여 새 리소스에 태그를 적용할 수 있습니다. TagResource API 작업을 사용하여 기존 리소스에 태그를 적용할 수도 있습니다.

일부 리소스 생성 작업을 사용해서 리소스 생성 시 리소스의 태그를 지정할 수 있습니다. 이 경우 리소스를 생성하는 동안 태그를 적용할 수 없는 경우 리소스를 생성하지 못합니다. 이 매커니즘에서는 생성 중에 태그를 지정하려는 리소스가 지정된 태그와 함께 생성되거나 전혀 생성되지 않습니다. 생성 시 리소스에 태그를 지정하면 리소스 생성 후 사용자 지정 태깅 스크립트를 실행할 필요가 없습니다.

다음 테이블에서는 태그를 지정할 수 있는 Amazon EMR on EKS 리소스를 설명합니다.

리소스	태그 지원	태그 전달 지원	생성 시 태그 지정 지원(Amazon EMR on EKS API, AWS CLI 및 AWS SDK)	생성을 위한 API(생성 중에 태그를 추가할 수 있음)
가상 클러스터	예	아니요. 가상 클러스터와 관련된 태그는 해당 가상 클러스터에 제출된 작업 실행에 전파되지 않습니다.	예	CreateVirtualCluster
작업 실행	예	아니요	예	StartJobRun

태그 제한

태그에 적용되는 기본 제한은 다음과 같습니다.

• 리소스당 최대 태그 수 – 50개

• 각 리소스에 대해 각 태그 키는 고유하며 하나의 값만 가질 수 있습니다.

• 최대 키 길이 - UTF-8 형식의 유니코드 문자 128자

• 최대 값 길이 - UTF-8 형식의 유니코드 문자 256자

• 태그 지정 스키마를 여러 AWS 서비스와 리소스에서 사용하는 경우 다른 서비스에서 허용되는 문자에 제한이 있을 수 있음에 유의하십시오. 일반적으로 허용되는 문자는 UTF-8로 표시할 수 있는 문자, 숫자 및 공백과 특수 문자 + - = . _ : / @입니다.

• 태그 키와 값은 대/소문자를 구분합니다.

• 태그 값에 빈 문자열은 지정할 수 있지만, null은 지정할 수 없습니다. 태그 키는 빈 문자열일 수 없습니다.

• 키 또는 값에 aws:, AWS: 또는 이러한 접두사의 대문자 또는 소문자 조합을 사용하지 않습니다. 이러한 이름은 AWS 전용으로 예약되어 있습니다.

AWS CLI 및 Amazon EMR on EKS API를 사용하여 태그 작업

다음 AWS CLI 명령 또는 Amazon EMR on EKS API 작업을 사용하여 리소스에 대한 태그를 추가, 업데이트, 나열 및 삭제합니다.

태스크	AWS CLI	API 작업
하나 이상의 태그를 추가하거나 덮어씁니다.	tag-resource	TagResource
리소스에 대한 태그를 나열합니다.	list-tags-for-resource	ListTagsForResource
하나 이상의 태그를 삭제합니다.	untag-resource	UntagResource

다음 예제는 AWS CLI를 사용하여 리소스에 태그를 지정하거나 태그를 제거하는 방법을 보여줍니다.

예제 1: 기존 클러스터에 태그 지정

다음 명령은 기존 가상 클러스터에 태그를 지정합니다.

aws emr-containers tag-resource --resource-arn resource_ARN --tags team=devs

예제 2: 기존 클러스터에서 태그 제거

다음 명령은 기존 가상 클러스터에서 태그를 삭제합니다.

aws emr-containers untag-resource --resource-arn resource_ARN --tag-keys tag_key

예제 3: 리소스의 태그 나열

다음 명령은 기존 리소스와 연결된 태그를 나열합니다.

aws emr-containers list-tags-for-resource --resource-arn resource_ARN