라벨 구성

Cloud Run 라벨은 Cloud Run 작업에 적용되는 키-값 쌍입니다. 이 페이지에서는 Cloud Run 작업에서 라벨을 설정, 수정, 삭제하는 방법을 보여줍니다.

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

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

라벨 사용 규칙

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

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

필요한 역할

Cloud Run 작업을 구성하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

Cloud Run 작업에 대한 Cloud Run 개발자(roles/run.developer) 역할
서비스 ID에 대한 서비스 계정 사용자(roles/iam.serviceAccountUser) 역할

Cloud Run과 연결된 IAM 역할 및 권한 목록은 Cloud Run IAM 역할 및 Cloud Run IAM 권한을 참조하세요. Cloud Run 작업이 Cloud 클라이언트 라이브러리와 같은 Google Cloud API와 상호작용하는 경우에는 서비스 ID 구성 가이드를 참조하세요. 역할 부여에 대한 자세한 내용은 배포 권한 및 액세스 관리를 참조하세요.

라벨 설정 또는 수정

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