작업자 풀의 메모리 한도 구성

Cloud Run 작업자 풀에 제공할 메모리 양을 선택할 수 있습니다. 이 페이지에서는 작업자 풀에 사용할 수 있는 메모리 양을 지정하는 방법을 설명합니다.

메모리 사용량 이해

허용된 메모리 한도를 초과하면 Cloud Run 인스턴스가 종료됩니다.

인스턴스의 사용 가능한 메모리는 다음을 충족해야 합니다.

작업자 풀 실행 파일 실행(실행 파일이 메모리에 로드되어야 함)
작업자 풀 프로세스에 메모리 할당
파일 시스템에 파일 쓰기

배포된 컨테이너 이미지의 크기는 인스턴스에 사용 가능한 메모리에 영향을 미치지 않습니다.

메모리 한도 설정 및 업데이트

Cloud Run 작업자 풀에 메모리 한도를 설정할 수 있습니다. 기본적으로 각 작업자 풀에 할당되는 메모리는 512MiB입니다.

필요한 최소 CPU

선택한 할당 메모리 크기는 작업자 풀의 최소 CPU 양에 해당합니다. 메모리 한도를 설정할 때는 다음과 같은 최소 CPU 한도가 필요합니다.

메모리	필요한 최소 CPU
2GiB	vCPU 1개
4GiB 이상	2 vCPU
8GiB 이상	vCPU 4개
16GiB 이상	vCPU 6개
24GiB 이상	8 vCPU

최대 메모리 용량

구성할 수 있는 최대 메모리 양은 32기비바이트(32 Gi)입니다.

커스텀 조직 정책을 사용하여 최대 메모리 한도를 적용할 수 있습니다.

최소 메모리

최소 메모리 설정은 512MiB입니다.

필요한 역할

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 update WORKER_POOL --memory SIZE

다음과 같이 바꿉니다.

WORKER_POOL을 작업자 풀 이름으로 바꿉니다.
SIZE를 CPU 및 메모리 표의 메모리 크기로 바꿉니다. 크기 형식은 고정 소수점 수 또는 부동 소수점 수 뒤에 각각 기가바이트 또는 메가바이트를 의미하는 G 또는 M이라는 기호를 사용하거나 이진 단위인 Gi 또는 Mi(각각 기비바이트 또는 메비바이트)를 사용합니다.

배포 중에 다음 명령어를 사용하여 메모리 한도를 설정할 수도 있습니다.

gcloud beta run worker-pools deploy --image IMAGE_URL --memory SIZE