이 페이지에서는 각 Cloud Run 인스턴스에 사용할 CPU 수를 지정하는 방법을 설명합니다. 기본적으로 Cloud Run 컨테이너 인스턴스는 CPU 1개로 제한됩니다. 이 페이지의 설명대로 이 값을 늘리거나 줄일 수 있습니다.
CPU 한도 설정 및 업데이트
기본적으로 각 인스턴스는 1개의 CPU로 제한됩니다. 다음 표에 표시된 값으로 변경할 수 있습니다.
CPU 및 메모리 표
다음은 CPU의 메모리 요구사항입니다.
| CPU | 필요한 메모리 |
|---|---|
| 1 vCPU | 128MiB~4GiB |
| 2 vCPU | 128MiB~8GiB |
| 4 vCPU | 2~16GiB |
| 6 vCPU | 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으로 이동합니다.
메뉴에서 작업자 풀을 선택하고 컨테이너 배포를 클릭하여 새 작업자 풀을 구성합니다. 기존 작업자 풀을 구성하는 경우 작업자 풀을 클릭한 후 새 버전 수정 및 배포를 클릭합니다.
새 작업자 풀을 구성하는 경우 초기 작업자 풀 페이지를 작성한 후 컨테이너, 볼륨, 네트워킹, 보안을 클릭하여 작업자 풀 구성 페이지를 펼칩니다.
컨테이너 탭을 클릭합니다.
- 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또는8CPU로 바꿉니다.
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또는8CPU 값을 지정하거나 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"
}
}
}
}
}
다음과 같이 바꿉니다.
- WORKER_POOL: 작업자 풀 이름
- REGION: Google Cloud 리전. 예를 들어 europe-west1입니다.
- IMAGE_URL: 작업자 풀이 포함된 컨테이너 이미지에 대한 참조(예:
us-docker.pkg.dev/cloudrun/container/worker-pool:latest) - CPU 및 메모리 표에 표시된 요구사항에 따라CPU를
1,2,4,6또는8CPU로 바꿉니다.
작업자 풀의 CPU 구성 보기
Google Cloud 콘솔에서 Cloud Run으로 이동합니다.
작업자 풀을 클릭하여 배포된 작업자 풀 목록을 표시합니다.
검사할 작업자 풀을 클릭하여 세부정보 창을 표시합니다.
컨테이너 탭을 클릭하여 작업자 풀의 CPU 구성을 표시합니다.