라벨 사용

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 페이지에서는 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

template 속성 아래의 Terraform 구성에서 google_cloud_run_service 리소스에 다음 항목을 추가합니다. 그러면 두 가지 라벨, foo(값 bar) 및 baz(값 quux)가 Cloud Run 인스턴스에 적용됩니다.

metadata {
  # Labels
  # https://cloud.google.com/run/docs/configuring/labels
  labels = {
    foo : "bar"
    baz : "quux"
  }
}

Google Cloud 프로젝트에 Terraform 구성을 적용하려면 다음 단계를 완료하세요.

  1. Cloud Shell을 실행합니다.
  2. Terraform 구성을 적용할 Google Cloud 프로젝트를 설정합니다.
    export GOOGLE_CLOUD_PROJECT=PROJECT_ID
    
  3. 디렉터리를 만들고 해당 디렉터리에 새 파일을 엽니다. 파일 이름에는 .tf 확장자가 있어야 합니다(예: main.tf).
    mkdir DIRECTORY && cd DIRECTORY && nano main.tf
    
  4. 샘플을 main.tf에 복사합니다.
  5. 환경에 적용할 샘플 매개변수를 검토하고 수정합니다.
  6. Ctrl-x를 누른 후 y를 눌러 변경사항을 저장합니다.
  7. Terraform을 초기화합니다.
    terraform init
  8. 구성을 검토하고 Terraform에서 만들거나 업데이트할 리소스가 예상과 일치하는지 확인합니다.
    terraform plan

    필요에 따라 구성을 수정합니다.

  9. 다음 명령어를 실행하고 프롬프트에 yes를 입력하여 Terraform 구성을 적용합니다.
    terraform apply

    Terraform에 '적용 완료' 메시지가 표시될 때까지 기다립니다.

  10. 결과를 보려면 Google Cloud 프로젝트를 엽니다. Google Cloud 콘솔에서 UI의 리소스로 이동하여 Terraform이 리소스를 만들었거나 업데이트했는지 확인합니다.

Cloud Run 작업

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

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

    gcloud beta 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 beta run jobs update JOB_NAME --labels KEY=VALUE

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

라벨별로 서비스 나열

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

  gcloud run services 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을 라벨 이름으로 바꿉니다.