이 페이지에서는 Cloud Run 작업자 풀에서 커스텀 설명을 설정하는 방법을 보여줍니다. 설명은 작업자 풀에 연결된 인간이 읽을 수 있는 선택적 텍스트입니다.
설명은 512자로 제한됩니다.
설명이 있는 경우 gcloud beta run worker-pools describe
를 사용하여 작업자 풀의 세부정보를 볼 때 표시됩니다.
필요한 역할
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를 사용하여 Cloud Run 작업자 풀에 설명을 설정합니다.
gcloud
배포 중 설명을 설정하거나 업데이트할 수 있습니다.
gcloud beta run worker-pools deploy WORKER_POOL --description DESCRIPTION
다음을 바꿉니다.
- WORKER_POOL: Cloud Run 작업자 풀의 이름
- DESCRIPTION: 작업자 풀에 대한 설명
YAML
새 작업자 풀을 만드는 경우에는 이 단계를 건너뜁니다. 기존 작업자 풀을 업데이트하는 경우 YAML 구성을 다운로드합니다.
gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml
다음 예시에는 YAML 구성이 포함되어 있습니다.
apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL annotations: run.googleapis.com/launch-stage: BETA run.googleapis.com/description: DESCRIPTION
다음을 바꿉니다.
- WORKER_POOL: Cloud Run 작업자 풀의 이름
- DESCRIPTION: 작업자 풀에 대한 설명
다음 명령어를 사용하여 작업자 풀을 만들거나 업데이트합니다.
gcloud beta run worker-pools replace workerpool.yaml
Terraform
Terraform 구성을 적용하거나 삭제하는 방법은 기본 Terraform 명령어를 참조하세요.
resource "google_cloud_run_v2_worker_pool" "default" {
name = "WORKER_POOL"
location = "REGION"
launch_stage = "BETA"
template {
containers {
image = "IMAGE_URL"
}
}
description = "DESCRIPTION"
}
다음을 바꿉니다.
- WORKER_POOL: 작업자 풀의 이름
- REGION: Google Cloud 지역(예: europe-west1)
- IMAGE_URL을 작업자 풀이 포함된 컨테이너 이미지에 대한 참조로 바꿉니다(예:
us-docker.pkg.dev/cloudrun/container/worker-pool:latest
). - DESCRIPTION: 작업자 풀에 대한 설명