Cloud Run 라벨은 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를 사용하여 라벨을 설정하거나 수정할 수 있습니다.
gcloud
다음 명령어를 사용하여 작업자 풀의 라벨을 업데이트할 수 있습니다.
gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE
라벨을 2개 이상 업데이트하려면 쉼표로 구분된 키-값 쌍 목록을 입력합니다. update-labels 명령어는 라벨이 이미 있으면 라벨 키에 새 값을 설정하고, 그렇지 않으면 새 라벨을 만듭니다.
다음과 같이 바꿉니다.
- WORKER_POOL을 Cloud Run 작업자 풀의 이름으로 바꿉니다.
- KEY를 라벨 키 이름으로 바꿉니다.
- VALUE: 키 값
배포 도중 라벨을 설정할 수도 있습니다.
gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE
배포 도중 라벨을 2개 이상 만들려면 쉼표로 구분된 키-값 쌍 목록을 입력하세요.
라벨별로 서비스 나열
Google Cloud CLI 필터를 사용하여 라벨을 기준으로 서비스를 나열할 수 있습니다.
gcloud beta run worker-pools list --filter metadata.labels.LABEL=VALUE
다음과 같이 바꿉니다.
- LABEL: 라벨 이름
- VALUE: 필터링된 목록에 포함할 값
작업자 풀의 라벨 삭제
Google Cloud CLI를 사용하여 작업자 풀의 라벨을 삭제할 수 있습니다.
gcloud
작업자 풀에서 모든 라벨을 삭제하려면 다음 명령어를 사용하세요.
gcloud beta run worker-pools update WORKER_POOL --clear-labels
작업자 풀에서 특정 라벨을 삭제하려면 쉼표로 구분된 키 목록을 입력하세요.
gcloud beta run worker-pools update WORKER_POOL --remove-labels LABEL
다음과 같이 바꿉니다.
- WORKER_POOL을 Cloud Run 작업자 풀의 이름으로 바꿉니다.
- LABEL을 라벨 이름으로 바꿉니다.