작업 라벨 구성

Cloud Run 라벨은 Cloud Run 작업에 적용되는 키-값 쌍입니다. 이 페이지에서는 Cloud Run 작업에서 라벨을 설정, 수정, 삭제하는 방법을 보여줍니다.

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

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

라벨 사용 규칙

다음 규칙은 Cloud Run 작업에 설정된 라벨을 사용할 때 적용됩니다.

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

필요한 역할

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

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

라벨 설정 또는 수정

Google Cloud CLI, YAML 또는 Terraform을 사용하여 Cloud Run 작업에 라벨을 설정할 수 있습니다.

gcloud

  1. 새 작업에 라벨을 설정하려면 다음 안내를 따르세요.

    gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE

    다음을 바꿉니다.

    • JOB_NAME: 작업 이름
    • KEY: 라벨 키 이름
    • VALUE: 키 값
    • IMAGE_URL: 컨테이너 이미지에 대한 참조(예: us-docker.pkg.dev/cloudrun/container/job:latest)

  2. 기존 작업에 라벨을 설정하려면 다음 안내를 따르세요.

    gcloud run jobs update JOB_NAME --labels KEY=VALUE

  3. 라벨을 2개 이상 생성하려면 쉼표로 구분된 키-값 쌍 목록을 입력합니다.

    gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2

YAML

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

    gcloud run jobs describe JOB_NAME --format export > job.yaml

  2. 두 위치에서 labels 속성을 업데이트합니다.

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  labels:
    LABEL: VALUE
spec:
  template:
    metadata:
      labels:
        LABEL: VALUE

    다음을 바꿉니다.

    • LABEL: 라벨 이름
    • VALUE: 선택한 값

    또한 환경 변수 또는 메모리 제한과 같은 추가 구성을 지정할 수 있습니다.

  3. 기존 작업 구성을 업데이트합니다.

    gcloud run jobs replace job.yaml

Terraform

Terraform 구성을 적용하거나 삭제하는 방법은 기본 Terraform 명령어를 참조하세요.

Terraform 구성에서 다음을 google_cloud_run_v2_job 리소스에 추가합니다.

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "REGION"

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
      }
    }
    labels = {
    "LABEL":"VALUE"
    }
  }
  labels = {
    "LABEL":"VALUE"
  }
}

다음을 바꿉니다.

  • JOB_NAME: Cloud Run 작업의 이름
  • REGION: Google Cloud 리전. 예를 들면 europe-west1입니다.
  • LABEL: 라벨 이름
  • VALUE: 선택한 값

라벨별로 작업 나열

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

  gcloud run jobs list --filter metadata.labels.LABEL=VALUE

다음을 바꿉니다.

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

작업의 라벨 삭제

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

gcloud run jobs update JOB --clear-labels

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

gcloud run jobs update JOB --remove-labels LABEL

다음을 바꿉니다.

  • JOB: Cloud Run 작업의 이름
  • LABEL: 라벨 이름