작업자 풀 설명 설정

이 페이지에서는 Cloud Run 작업자 풀에서 커스텀 설명을 설정하는 방법을 보여줍니다. 설명은 작업자 풀에 연결된 인간이 읽을 수 있는 선택적 텍스트입니다.

설명은 512자로 제한됩니다. 설명이 있는 경우 gcloud beta run worker-pools describe를 사용하여 작업자 풀의 세부정보를 볼 때 표시됩니다.

필요한 역할

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

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

  1. 새 작업자 풀을 만드는 경우에는 이 단계를 건너뜁니다. 기존 작업자 풀을 업데이트하는 경우 YAML 구성을 다운로드합니다.

    gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml
  2. 다음 예시에는 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: 작업자 풀에 대한 설명
  3. 다음 명령어를 사용하여 작업자 풀을 만들거나 업데이트합니다.

    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: 작업자 풀에 대한 설명