라벨 사용

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

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

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

라벨 사용 규칙

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

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

라벨 설정 또는 수정

Cloud Run 서비스 및 작업에 라벨을 설정할 수 있습니다.

Cloud Run 서비스

구성을 변경하면 새 버전이 생성됩니다. 이를 변경하는 명시적 업데이트가 없으면 이후 버전에도 이 구성 설정이 자동으로 적용됩니다.

새 버전을 배포할 때 Google Cloud 콘솔, gcloud 명령줄 또는 YAML 파일을 사용하여 라벨을 설정하거나 변경할 수 있습니다.

콘솔

  1. Cloud Run으로 이동

  2. 라벨을 설정할 서비스의 왼쪽에 있는 체크박스를 선택합니다.

  3. 맨 오른쪽에 있는 정보 패널이 사용 설정되어 있는지 확인합니다(정보 패널 표시).

  4. 라벨을 클릭하여 라벨 창을 표시합니다.

    라벨 설정

  5. 기존 라벨 키 값을 수정하려면 라벨을 찾아서 원하는 대로 값을 변경합니다.

  6. 서비스에서 새 라벨을 설정하려면 라벨 추가를 클릭하고 키와 값을 제공합니다.

  7. 저장을 클릭합니다.

명령줄

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

gcloud run services update SERVICE --update-labels KEY=VALUE

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

다음과 같이 바꿉니다.

  • SERVICE: Cloud Run 서비스 이름
  • KEY: 라벨 키 이름
  • VALUE: 키 값

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

gcloud run deploy SERVICE --image IMAGE --labels KEY=VALUE

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

YAML

YAML 형식으로 정리된 결과를 생성하는 gcloud run services describe --format export 명령어를 사용하면 기존 서비스 구성을 다운로드해서 볼 수 있습니다. 그런 다음 아래 설명된 필드를 수정하고 gcloud run services replace 명령어를 사용하여 수정된 YAML을 업로드할 수 있습니다. 설명된 대로 필드만 수정해야 합니다.

  1. 구성을 보고 다운로드하려면 다음을 실행합니다.

    gcloud run services describe SERVICE --format export > service.yaml

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

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
  labels:
    LABEL: VALUE
spec:
  template:
    metadata:
      labels:
        LABEL: VALUE
      name: REVISION

    다음과 같이 바꿉니다.

    • SERVICE: Cloud Run 서비스 이름
    • LABEL: 라벨 이름
    • VALUE: 원하는 값
    • REVISION: 새 버전 이름, 또는 버전이 있는 경우 삭제 가능. 새 버전 이름을 제공할 경우 다음 기준을 반드시 충족해야 합니다.
      • SERVICE-로 시작해야 합니다.
      • 소문자, 숫자, -만 포함합니다.
      • -로 끝나면 안 됩니다.
      • 63자(영문 기준) 이하여야 합니다.

    metadata.labels는 서비스 객체에 라벨을 설정하고 spec.template.metadata.label은 생성된 버전에 라벨을 설정합니다. 버전에 설정된 라벨만 로그 및 결제로 전달됩니다.

  3. 다음 명령어를 사용하여 서비스를 새 구성으로 바꿉니다.

    gcloud run services replace service.yaml

Terraform

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

다음 스니펫은 Terraform 구성의 google_cloud_run_service를 사용하여 Cloud Run 인스턴스에 2개의 라벨 foo(값: bar) 및 baz(값: quux)를 추가합니다.

다음과 같이 template 아래에 라벨을 추가하면 버전의 라벨이 설정됩니다. 버전에 설정된 라벨만 로그와 결제로 전달됩니다. template 아래 이외의 위치에 라벨을 추가하면 버전이 아닌 서비스에 라벨이 설정됩니다.

run/cloud_run_configuration_labels/main.tf 
resource "google_cloud_run_service" "default" {
  name     = "cloudrun-service-labels"
  location = "us-central1"

  template {
    spec {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/hello"
      }
    }
    metadata {
      # Labels
      # https://cloud.google.com/run/docs/configuring/labels
      labels = {
        foo : "bar"
        baz : "quux"
      }
    }
  }
}

다음을 바꿉니다.

  • name 속성을 서비스 이름으로 바꿉니다.
  • location 속성을 서비스에 사용되는 위치로 바꿉니다.
  • image 속성을 컨테이너 이미지로 바꿉니다.
  • foo 및 baz를 자체 라벨 이름으로 바꿉니다.
  • bar 및 quux를 고유한 라벨 값으로 바꿉니다.

Cloud Run 작업

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

명령줄

  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

YAML 형식으로 정리된 결과를 반환하는 gcloud run jobs describe --format export 명령어를 사용하면 기존 작업 구성을 다운로드하고 볼 수 있습니다. 그런 다음 아래 설명된 필드를 수정하고 gcloud run jobs replace 명령어를 사용하여 수정된 YAML을 업로드합니다. 설명된 대로 필드만 수정해야 합니다.

  1. 구성을 보고 다운로드하려면 다음을 실행합니다.

    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 services list --filter metadata.labels.LABEL=VALUE

작업:

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

다음과 같이 바꿉니다.

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

서비스의 라벨 삭제

Console 또는 명령줄을 사용하여 서비스의 라벨을 삭제할 수 있습니다.

콘솔

  1. Cloud Run으로 이동

  2. 라벨을 삭제할 서비스의 왼쪽에 있는 체크박스를 선택합니다.

  3. 맨 오른쪽에 있는 정보 패널이 사용 설정되어 있는지 확인합니다(정보 패널 표시).

  4. 라벨을 클릭하여 라벨 창을 표시합니다.

  5. 삭제할 라벨을 찾습니다.

  6. 마우스 커서를 라벨의 값 텍스트 상자 오른쪽으로 가져가서 휴지통 아이콘을 표시하고 클릭합니다.

  7. 저장을 클릭합니다.

명령줄

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

gcloud run services update SERVICE --clear-labels

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

gcloud run services update SERVICE --remove-labels LABEL

다음과 같이 바꿉니다.

  • SERVICE: Cloud Run 서비스 이름
  • LABEL: 라벨 이름

작업 라벨 삭제

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

gcloud run jobs update JOB --clear-labels

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

gcloud run jobs update JOB --remove-labels LABEL

Replace

  * <var>JOB</var> with name of your Cloud Run service
  * <var>LABEL</var> with the name of your label