라벨 사용

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

Cloud Run(완전 관리형)의 경우 라벨이 Google Cloud에 전달되므로 청구, 로그, 측정항목 등을 직접 필터링하는 데 사용할 수 있습니다. 다음과 같은 경우에 사용할 수 있습니다.

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

Cloud Run for Anthos on Google Cloud에서 라벨은 Kubernetes 리소스 라벨이며 Google Cloud에 전달되지 않습니다.

라벨 사용 규칙

Cloud Run 서비스에 설정된 라벨 사용 시 다음 규칙이 적용됩니다.

라벨 설정 또는 수정

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

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

Console

  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 beta 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'

    다음과 같이 바꿉니다.

    • SERVICE를 Cloud Run 서비스 이름으로 바꿉니다.
    • LABEL을 라벨 이름으로 바꿉니다.
    • VALUE를 원하는 값으로 바꿉니다.
  3. 다음 명령어를 사용하여 서비스를 새 구성으로 바꿉니다.

    gcloud beta run services replace service.yaml

라벨별로 서비스 나열

Cloud SDK 필터를 사용하면 라벨별로 서비스를 나열할 수 있습니다.

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

다음과 같이 바꿉니다.

  • LABEL을 라벨 이름으로 바꿉니다.
  • VALUE를 필터링된 목록에 포함할 값으로 바꿉니다.

라벨 삭제

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

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