라벨 구성

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을 사용하여 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

라벨별로 작업 나열

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: 라벨 이름