인스턴스의 라벨 구성

Cloud Run 라벨은 Cloud Run 인스턴스에 적용되는 키-값 쌍입니다. 이 페이지에서는 Cloud Run 인스턴스에서 라벨을 설정, 수정, 삭제하는 방법을 보여줍니다. Cloud Run 인스턴스에 라벨을 설정하면 이 라벨이 있는 새 버전이 이 인스턴스에 생성됩니다. 라벨은 이전 버전에 적용되지 않습니다.

가능한 용도는 다음과 같습니다.

  • 비용을 할당하고 청구를 분석합니다.
  • 개별 팀 또는 비용 센터에서 사용되는 리소스를 식별합니다.
  • 배포 환경(프로덕션, 스테이징, QA, 테스트)을 구분합니다.
  • 소유자 및 상태 라벨을 식별합니다.
  • Logging에서 로그를 필터링합니다.

라벨 사용 규칙

Cloud Run 인스턴스에 설정된 라벨 사용에는 다음 규칙이 적용됩니다.

Cloud Run에서는 유효한 Google Cloud 라벨만 사용할 수 있습니다.

결제 데이터 및 로깅 라벨

Cloud Billing 및 Cloud Logging은 YAML의 spec.template.metadata.labels 속성 또는 Terraform의 template 아래에 지정된 라벨만 수신합니다. Google Cloud CLI를 사용하여 라벨을 구성하면 Cloud Run에서 metadata.labels 및 spec.template.metadata.labels 속성에 모두 라벨을 추가합니다.

필요한 역할

Cloud Run 인스턴스를 구성하고 배포하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

Cloud Run과 연결된 IAM 역할 및 권한 목록은 다음 항목을 참조하세요. Cloud Run IAM 역할 및 Cloud Run IAM 권한 Cloud Run 인스턴스가 Google Cloud Cloud 클라이언트 라이브러리와 같은 API와 상호작용하는 경우에는 서비스 ID 구성 가이드를 참조하세요. 역할 부여에 대한 자세한 내용은 배포 권한 및 액세스 관리를 참조하세요.

라벨 설정 또는 수정

Google Cloud CLI를 사용하여 라벨을 설정하거나 수정할 수 있습니다.

gcloud

다음 명령어를 사용하여 인스턴스의 라벨을 업데이트할 수 있습니다.

gcloud beta run instances update INSTANCE --update-labels KEY=VALUE

라벨을 2개 이상 업데이트하려면 쉼표로 구분된 키-값 쌍 목록을 입력합니다. update-labels 명령어는 라벨이 이미 있는 경우 라벨 키의 새 값을 설정하고, 그렇지 않으면 새 라벨을 만듭니다.

다음을 바꿉니다.

  • INSTANCE: Cloud Run 인스턴스의 이름입니다.
  • KEY: 라벨 키의 이름입니다.
  • VALUE: 키의 값입니다.

배포 도중 라벨을 설정할 수도 있습니다.

gcloud beta run instances deploy INSTANCE --image IMAGE --labels KEY=VALUE

배포 도중 라벨을 2개 이상 만들려면 쉼표로 구분된 키-값 쌍 목록을 입력하세요.

YAML

  1. 새 인스턴스를 만드는 경우 이 단계를 건너뜁니다. 기존 인스턴스를 업데이트하는 경우 YAML 구성을 다운로드합니다.

    gcloud beta run instances describe INSTANCE --format export > instance.yaml

  2. 다음 예시에는 YAML 구성이 포함되어 있습니다.

    apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
  annotations:
    run.googleapis.com/launch-stage: BETA
  labels:
    KEY: VALUE
    KEY2: VALUE2
    KEY3: VALUE3

    다음을 바꿉니다.

    • INSTANCE: Cloud Run 인스턴스의 이름입니다.
    • KEY 및 VALUE: 라벨의 키-값 쌍입니다.

    metadata.labels는 인스턴스 객체에 라벨을 설정하고 spec.template.metadata.labels는 생성된 버전에 라벨을 설정합니다. Cloud Run은 버전에 설정된 라벨만 Cloud Billing 및 Cloud Logging으로 전파합니다.

  3. 다음 명령어를 사용하여 인스턴스를 만들거나 업데이트합니다.

    gcloud beta run instances replace instance.yaml

라벨별로 인스턴스 나열

Google Cloud CLI 필터를 사용하여 라벨을 기준으로 인스턴스를 나열할 수 있습니다.

  gcloud beta run instances list --filter metadata.labels.LABEL=VALUE

다음을 바꿉니다.

  • LABEL: 라벨 이름
  • VALUE: 필터링된 목록에 포함할 값

인스턴스의 라벨 삭제

Google Cloud CLI를 사용하여 인스턴스의 라벨을 삭제할 수 있습니다.

gcloud

인스턴스에서 모든 라벨을 삭제하려면 다음 명령어를 사용하세요.

gcloud beta run instances update INSTANCE --clear-labels

인스턴스에서 특정 라벨을 삭제하려면 쉼표로 구분된 키 목록을 입력하세요.

gcloud beta run instances update INSTANCE --remove-labels LABEL

다음을 바꿉니다.

  • INSTANCE: Cloud Run 인스턴스의 이름입니다.
  • LABEL: 라벨 이름입니다.