작업자 풀 설명 설정

이 페이지에서는 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: 작업자 풀에 대한 설명