라벨 사용

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

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

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

라벨 사용 규칙

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

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

라벨 설정 또는 수정

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

Cloud Run 서비스

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

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

콘솔

Cloud Run으로 이동
라벨을 설정할 서비스의 왼쪽에 있는 체크박스를 선택합니다.
맨 오른쪽에 있는 정보 패널이 사용 설정되어 있는지 확인합니다(정보 패널 표시).
라벨을 클릭하여 라벨 창을 표시합니다.
기존 라벨 키 값을 수정하려면 라벨을 찾아서 원하는 대로 값을 변경합니다.
서비스에서 새 라벨을 설정하려면 라벨 추가를 클릭하고 키와 값을 제공합니다.
저장을 클릭합니다.

명령줄

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

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을 업로드할 수 있습니다. 설명된 대로 필드만 수정해야 합니다.

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

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

두 위치에서 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은 생성된 버전에 라벨을 설정합니다. 버전에 설정된 라벨만 로그 및 결제로 전달됩니다.
다음 명령어를 사용하여 서비스를 새 구성으로 바꿉니다.
```
gcloud run services replace service.yaml
```

Terraform

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

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

run/container_template/main.tf

GitHub에서 보기 의견 보내기

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

Cloud Run 작업

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

명령줄

새 작업에 라벨을 설정하려면 다음 안내를 따르세요.
```
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)
기존 작업에 라벨을 설정하려면 다음 안내를 따르세요.
```
gcloud run jobs update JOB_NAME --labels KEY=VALUE
```
라벨을 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을 업로드합니다. 설명된 대로 필드만 수정해야 합니다.

구성을 보고 다운로드하려면 다음을 실행합니다.
```
gcloud run jobs describe JOB_NAME --format export > job.yaml
```
두 위치에서 labels 속성을 업데이트합니다.
```
apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  labels:
    LABEL: VALUE
spec:
  template:
    metadata:
      labels:
        LABEL: VALUE
```
다음과 같이 바꿉니다.
- LABEL: 라벨 이름
- VALUE: 원하는 값
또한 환경 변수 또는 메모리 제한과 같은 추가 구성을 지정할 수 있습니다.
기존 작업 구성을 업데이트합니다.
```
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 또는 명령줄을 사용하여 서비스의 라벨을 삭제할 수 있습니다.

콘솔

Cloud Run으로 이동
라벨을 삭제할 서비스의 왼쪽에 있는 체크박스를 선택합니다.
맨 오른쪽에 있는 정보 패널이 사용 설정되어 있는지 확인합니다(정보 패널 표시).
라벨을 클릭하여 라벨 창을 표시합니다.
삭제할 라벨을 찾습니다.
마우스 커서를 라벨의 값 텍스트 상자 오른쪽으로 가져가서 휴지통 아이콘을 표시하고 클릭합니다.
저장을 클릭합니다.

명령줄

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

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