이 페이지는 Cloud Translation API를 통해 번역되었습니다.

작업자 풀의 CPU 한도 구성

이 페이지에서는 각 Cloud Run 인스턴스에 사용할 CPU 수를 지정하는 방법을 설명합니다. 기본적으로 Cloud Run 컨테이너 인스턴스는 CPU 1개로 제한됩니다. 이 페이지의 설명대로 이 값을 늘리거나 줄일 수 있습니다.

CPU 한도 설정 및 업데이트

기본적으로 각 인스턴스는 1개의 CPU로 제한됩니다. 다음 표에 표시된 값으로 변경할 수 있습니다.

CPU 및 메모리 표

다음은 CPU의 메모리 요구사항입니다.

CPU	필요한 메모리
vCPU 1개	128MiB~4GiB
2 vCPU	128MiB~8GiB
vCPU 4개	2~16GiB
vCPU 6개	4~24GiB
8 vCPU	4~32GiB

필요한 역할

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 구성 가이드를 참조하세요. 역할 부여에 대한 자세한 내용은 배포 권한 및 액세스 관리를 참조하세요.

CPU 한도 구성

구성을 변경하면 새 버전이 생성됩니다. 이를 변경하는 명시적 업데이트가 없으면 이후 버전에도 이 구성 설정이 자동으로 적용됩니다.

Google Cloud 콘솔, Google Cloud CLI, YAML 또는 Terraform을 사용하여 Cloud Run 작업자 풀의 CPU 한도를 설정할 수 있습니다.

콘솔

Google Cloud 콘솔에서 Cloud Run으로 이동합니다.

Cloud Run으로 이동
메뉴에서 작업자 풀을 선택하고 컨테이너 배포를 클릭하여 새 작업자 풀을 구성합니다. 기존 작업자 풀을 구성하는 경우 작업자 풀을 클릭한 후 새 버전 수정 및 배포를 클릭합니다.
새 작업자 풀을 구성하는 경우 초기 작업자 풀 페이지를 작성한 후 컨테이너, 볼륨, 네트워킹, 보안을 클릭하여 작업자 풀 구성 페이지를 펼칩니다.
컨테이너 탭을 클릭합니다.
- CPU 드롭다운 목록에서 CPU 한도를 선택합니다.
만들기 또는 배포를 클릭합니다.

gcloud

다음 명령어를 사용하여 지정된 작업자 풀의 CPU 한도를 업데이트할 수 있습니다.

gcloud beta run worker-pools update WORKER_POOL --cpu CPU

다음과 같이 바꿉니다.

WORKER_POOL을 작업자 풀 이름으로 바꿉니다.
CPU를 CPU 한도로 바꿉니다. CPU 및 메모리 표에 표시된 요구사항에 따라 CPU 값을 1, 2, 4, 6 또는 8로 지정합니다.

또한 다음 명령어를 사용하여 배포 중 CPU를 설정할 수도 있습니다.

gcloud beta run worker-pools deploy --image IMAGE_URL --cpu CPU

바꾸기

IMAGE_URL: 작업자 풀이 포함된 컨테이너 이미지에 대한 참조(예: us-docker.pkg.dev/cloudrun/container/worker-pool:latest)입니다.
CPU 및 메모리 표에 표시된 요구사항에 따라CPU를 1, 2, 4, 6 또는 8 CPU로 바꿉니다.

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
spec:
  template:
    spec:
      containers:
      - image: IMAGE_URL
        resources:
          limits:
            cpu: `CPU`
```
다음을 바꿉니다.
- WORKER_POOL: Cloud Run 작업자 풀의 이름
- IMAGE_URL: 작업자 풀이 포함된 컨테이너 이미지에 대한 참조(예: us-docker.pkg.dev/cloudrun/container/worker-pool:latest)입니다.
- CPU: CPU 한도 값입니다. 1, 2, 4, 6 또는 8 CPU 값을 지정하거나 CPU 1개 미만의 경우 0.08에서 1.00 미만의 값을 0.01 단위로 지정합니다. 필요한 설정은 CPU 한도 설정 및 업데이트의 표를 참조하세요.
다음 명령어를 사용하여 작업자 풀을 만들거나 업데이트합니다.
```
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"
      resources {
        limits = {
          cpu = "CPU"
        }
      }
    }
  }
}