AWS Proton리소스 및 태깅 - AWS Proton
AWS태그 지정AWS Proton태그 지정

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

AWS Proton리소스 및 태깅

AWS ProtonAmazon Resource Name (ARN) 이 할당된 리소스에는 환경 템플릿과 해당 메이저 및 마이너 버전, 서비스 템플릿 및 메이저 및 마이너 버전, 환경, 서비스, 서비스 인스턴스, 구성 요소 및 리포지토리가 포함됩니다. 이러한 리소스에는 태그를 붙일 수 있어 쉽게 정리하고 식별할 수 있습니다. 태그를 사용하여 용도, 소유자, 환경 또는 기타 기준으로 리소스를 분류할 수 있습니다. 자세한 내용은 태그 지정 전략을 참조하세요. 추적 및 관리하려면AWS Proton리소스에 대해 다음 단원에서 설명하는 태그 지정 기능을 사용할 수 있습니다.

AWS태그 지정

AWS 리소스에 태그 형태로 메타데이터를 지정할 수 있습니다. 각 태그는 고객 정의 키와 값 (선택 사항) 으로 구성됩니다. 태그를 사용하면 리소스를 손쉽게 관리, 식별, 정리, 검색 및 필터링할 수 있습니다.

중요

개인 식별 정보(PII)나 기타 기밀 정보 또는 민감한 정보를 태그에 추가하지 않습니다. 청구를 비롯한 여러 AWS 서비스에서 태그에 액세스할 수 있습니다. 태그는 개인 데이터나 민감한 데이터에 사용하기 위한 것이 아닙니다.

각 태그는 두 부분으로 구성됩니다.

  • 태그 키(예: CostCenter, Environment 또는 Project). 태그 키는 대/소문자를 구별합니다.

  • 태그 값 (선택 사항) (예:111122223333또는Production). 태그 키처럼 태그 값은 대/소문자를 구별합니다.

태그에 적용되는 기본 이름 지정 및 사용 요구 사항은

  • 각 리소스에는 최대 50개 사용자 생성 태그가 포함될 수 있습니다.

    참고

    로 시작하는 시스템 생성 태그aws:접두사 예약 대상AWS이 한도에 포함되지 않도록 하십시오. aws: 접두사로 시작하는 태그를 편집하거나 삭제할 수 없습니다.

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

  • 태그 키는 최소 1자, 최대 128자의 UTF-8 형식 유니코드 문자로 지정해야 합니다.

  • 태그 값은 최소 1자, 최대 256자의 UTF-8 형식 유니코드 문자로 지정해야 합니다.

  • 허용되는 문자는 UTF-8 로 표현할 수 있는 문자, 숫자 및 문자, 숫자 및 문자:/@문자도 있습니다.

AWS Proton태그 지정

다음으로 바꿉니다.AWS Proton, 생성한 태그와 그 태그를 모두 사용할 수 있습니다.AWS Proton자동으로 생성됩니다.

AWS Proton​ AWS관리형 태그

를 생성할 때AWS Proton리소스,AWS Proton자동으로AWS다음 다이어그램에 표시된 것처럼 새 리소스에 대한 관리형 태그를AWS관리 태그는 나중에 다른 태그로 전파됨AWS Proton새 리소스를 기반으로 하는 리소스. 예를 들어 환경 템플릿의 관리 태그는 해당 버전으로 전파되고 서비스의 관리 태그는 해당 서비스 인스턴스로 전파됩니다.

참고

AWS관리형 태그안 돼환경 계정 연결을 위해 생성됩니다. 자세한 내용은 환경 계정 연결을 참조하세요.

를 설명하는 다이어그램AWS관리형 태그 전파.

프로비저닝된 리소스에 태그 전파

서비스 및 환경 템플릿에 정의된 것과 같이 리소스가 프로비저닝된 경우 지원AWS태깅,AWS관리형 태그는 프로비저닝된 리소스에 고객 관리형 태그로 전파됩니다. 이러한 태그는 지원하지 않는 프로비저닝된 리소스로 전파되지 않습니다.AWS태그 지정.

AWS Proton리소스에 태그를 적용하는 방법은 다음과 같습니다.AWS Proton계정, 등록된 템플릿 및 배포된 환경, 서비스 및 서비스 인스턴스는 다음 표에 설명되어 있습니다. 다음을 사용할 수 있음AWS보기 및 관리를 위한 관리형 태그AWS Proton리소스는 수정할 수 없습니다.

AWS관리형 태그 키 전파된 고객 관리형 키 설명

aws:proton:account

proton:account

이AWS생성 및 배포하는 계정AWS Proton있습니다.

aws:proton:template

proton:template

선택된 템플릿의 ARN.

aws:proton:environment

proton:environment

선택한 환경의 ARN.

aws:proton:service

proton:service

선택된 서비스의 ARN.

aws:proton:service-instance

proton:service-instance

선택한 서비스 인스턴스의 ARN.

aws:proton:component

proton:component

선택된 구성 요소의 ARN.

다음은 의 예제입니다.AWS에 대한 관리 태그AWS Proton의지.

"aws:proton:template" = "arn:aws:proton:region-id:account-id:environment-template/env-template"

다음은 에서 전파된 프로비저닝된 리소스에 적용된 고객 관리형 태그의 예제입니다.AWS관리형 태그.

"proton:environment:database" = "arn:aws:proton:region-id:account-id:rds/env-db"

다음으로 바꿉니다.AWS-관리형 프로비저닝,AWS Proton전파된 태그를 프로비저닝된 리소스에 직접 적용합니다.

다음으로 바꿉니다.자체 관리형 프로비저닝,AWS Proton전파된 태그를 프로비저닝 풀 요청 (PR) 에서 제출하는 렌더링된 IaC 파일과 함께 사용할 수 있도록 합니다. 태그는 문자열 맵 변수에 제공됩니다.proton_tags. Terraform 구성에서 이 변수를 참조하여 다음을 포함하는 것이 좋습니다.AWS Proton태그 입력default_tags. 이것은 전파됩니다AWS Proton프로비저닝된 모든 리소스에 태그를 지정합니다.

다음 예에서는 환경 Terraform 템플릿에서의 이러한 태그 전파 방법을 보여줍니다.

다음은proton_tags변수 정의:

양성자.환경. 변수.tf:

variable "environment" {
  type = object({
    inputs = map(string)
    name = string
  })
}

variable "proton_tags" {
  type = map(string)
  default = null
}

이 변수에 태그 값을 할당하는 방법은 다음과 같습니다.

프로톤.auto.tfvars.json:

{
  "environment": {
    "name": "dev",
    "inputs": {
      "ssm_parameter_value": "MyNewParamValue"
    }
  }

  "proton_tags" : {
    "proton:account" : "123456789012",
    "proton:template" : "arn:aws:proton:us-east-1:123456789012:environment-template/fargate-env",
    "proton:environment" : "arn:aws:proton:us-east-1:123456789012:environment/dev"
  }
}

다음을 추가할 수 있습니다.AWS ProtonTerraform 구성에 태그를 지정하여 프로비저닝된 리소스에 추가되도록 하세요.

# Configure the AWS Provider
provider "aws" {
  region = var.aws_region
  default_tags {
    tags = var.proton_tags
  }
}

고객 관리형 태그

ACHAWS Proton리소스의 최대 고객 관리 태그 할당량은 50개입니다. 고객 관리 태그가 자녀에게 전파AWS Proton자원은 다음과 같습니다.AWS관리 태그는 기존 태그에 전파되지 않는다는 점을 제외하면 그렇습니다.AWS Proton리소스 또는 프로비저닝된 리소스에 새 태그를 적용하는 경우AWS Proton기존 하위 리소스가 있는 리소스 및 기존 하위 리소스에 새 태그를 지정하려면 콘솔을 사용하거나, 기존 하위 리소스 각각에 수동으로 태그를 지정해야 합니다.AWS CLI.

콘솔과 CLI를 사용하여 태그를 만듭니다.

를 생성할 때AWS Proton리소스 콘솔을 사용하면 다음 콘솔 스냅샷에 표시된 대로 생성 절차의 첫 번째 또는 두 번째 페이지에서 고객 관리형 태그를 생성할 수 있습니다. 선택새 태그 추가를 입력합니다.

콘솔 생성 태그 인터페이스의 스냅샷입니다.

를 사용하여 새 리소스를 만든 후AWS Proton콘솔에서 해당 목록을 볼 수 있습니다.AWS상세 페이지의 관리 및 고객 관리 태그.

태그를 만듭니다.

  1. 에서AWS Proton콘솔를 열면AWS Proton태그 목록을 볼 수 있는 리소스 세부 정보 페이지입니다.

  2. 태그 관리를 선택합니다.

  3. 에서태그 관리페이지에서 태그를 보고, 만들고 제거하고 편집할 수 있습니다. 를 수정할 수 없습니다.AWS관리 태그는 상단에 나열되어 있습니다. 하지만 다음에 나열된 편집 필드를 사용하여 고객 관리 태그를 추가하고 수정할 수 있습니다.AWS관리형 태그.

    선택새 태그 추가를 클릭합니다.

  4. 새 태그의 키와 값을 입력합니다.

  5. 태그를 편집하려면 선택한 키의 태그 값 필드에 값을 입력합니다.

  6. 태그를 삭제하려면제거선택된 태그에

  7. 변경 작업을 완료한 후 [변경 사항 저장.

를 사용하여 태그를 만듭니다.AWS Proton​ AWS CLI

를 사용하여 태그를 보고, 만들고, 제거하고, 편집할 수 있습니다.AWS Proton AWS CLI.

다음 예와 같이 리소스에 태그를 생성하거나 편집할 수 있습니다.

$ aws proton tag-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \
    --tags '[{"key":"mykey1","value":"myval1"},{"key":"mykey2","value":"myval2"}]'

다음 예와 같이 리소스에 대한 태그를 제거할 수 있습니다.

$ aws proton untag-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \
    --tag-keys '["mykey1","mykey2"]'

마지막 예제와 같이 리소스의 태그를 나열할 수 있습니다.

$ aws proton list-tags-for-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice"