Cloud Run 작업을 다양한 양의 메모리로 프로비저닝할 수 있습니다. 이 페이지에서는 작업에 사용할 수 있는 메모리 양을 지정하는 방법을 설명합니다.
메모리 사용량 이해
허용된 메모리 한도를 초과하면 Cloud Run 인스턴스가 종료됩니다.
인스턴스의 사용 가능한 메모리 계산에는 다음이 포함됩니다.
- 작업 실행 파일 실행(실행 파일이 메모리에 로드되어야 함)
- 작업 프로세스에 메모리 할당
- 파일 시스템에 파일 쓰기
배포된 컨테이너 이미지의 크기는 사용 가능한 메모리 계산에 포함되지 않습니다.
메모리 한도 설정 및 업데이트
Cloud Run 작업에 메모리 한도를 설정할 수 있습니다. 기본적으로 각 작업에 할당되는 메모리는 512MiB입니다.
필요한 최소 CPU
선택한 할당 메모리 크기는 작업에 할당된 CPU 양에 해당합니다. 메모리 한도를 설정할 때는 다음과 같은 최소 CPU 한도가 필요합니다.
메모리 | 필요한 최소 CPU |
---|---|
128MB | .083 vCPU |
256MB | .167 vCPU |
512MB | .333 vCPU |
1GiB | .583 vCPU |
2GiB | vCPU 1개 |
4GiB 이상 | 2 vCPU |
8GiB 이상 | vCPU 4개 |
16GiB 이상 | vCPU 6개 |
24GiB 이상 | 8 vCPU |
최대 메모리 용량
구성할 수 있는 최대 메모리 양은 32기비바이트(32 Gi
)입니다.
최소 메모리
2세대 실행 환경에서 구성할 수 있는 최소 메모리 양은 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 구성 가이드를 참조하세요. 역할 부여에 대한 자세한 내용은 배포 권한 및 액세스 관리를 참조하세요.
메모리 한도 구성
Cloud Run 작업의 경우 최소 512Mi를 지정해야 합니다. Cloud Run 작업에 대한 메모리를 지정하려면 다음 안내를 따르세요.
콘솔
Google Cloud 콘솔에서 Cloud Run 작업 페이지로 이동합니다.
컨테이너 배포를 클릭하고 작업을 선택하여 초기 작업 설정 페이지를 작성합니다. 기존 작업을 구성하는 경우 작업을 선택한 후 수정을 클릭합니다.
컨테이너, 변수 및 보안 비밀, 연결, 보안을 클릭하여 작업 속성 페이지를 펼칩니다.
컨테이너 탭을 클릭합니다.
- 메모리 드롭다운 목록에서 원하는 메모리 크기를 선택합니다.
만들기 또는 업데이트를 클릭합니다.
gcloud
작업 생성 시 메모리 한도를 설정하려면 다음 안내를 따르세요.
gcloud run jobs create JOB_NAME --image IMAGE_URL --memory SIZE
다음과 같이 바꿉니다.
- JOB_NAME을 작업 이름으로 바꿉니다.
- IMAGE_URL을 컨테이너 이미지에 대한 참조(예:
us-docker.pkg.dev/cloudrun/container/job:latest
)로 바꿉니다. - SIZE를 원하는 메모리 크기로 바꿉니다. 크기 형식은 고정 소수점 수 또는 부동 소수점 수 뒤에 각각 기가바이트 또는 메가바이트를 의미하는
G
또는M
라는 기호를 사용하거나 이진 단위인Gi
또는Mi
(각각 GB 또는 MB)를 사용합니다.
작업 업데이트 시 메모리 한도를 설정하려면 다음 안내를 따르세요.
gcloud run jobs update JOB_NAME --memory SIZE
YAML
새 작업을 만드는 경우에는 이 단계를 건너뜁니다. 기존 작업을 업데이트하는 경우 YAML 구성을 다운로드합니다.
gcloud run jobs describe JOB_NAME --format export > job.yaml
memory
속성을 업데이트합니다.apiVersion: run.googleapis.com/v1 kind: Job metadata: name: JOB spec: template: spec: template: spec: containers: - image: IMAGE resources: limits: memory: SIZE
SIZE를 원하는 메모리 크기로 바꿔 최소 512Mi를 지정합니다. 형식은 고정 소수점 수 또는 부동 소수점 수 뒤에 각각 기가바이트 또는 메가바이트를 의미하는
G
또는M
라는 기호를 사용하거나 이진 단위인Gi
또는Mi
(각각 GB 또는 MB)를 사용합니다.또한 환경 변수 또는 메모리 제한과 같은 추가 구성을 지정할 수 있습니다.
기존 작업 구성을 업데이트합니다.
gcloud run jobs replace job.yaml
메모리 한도 설정 보기
Cloud Run 작업의 현재 메모리 한도 설정을 보려면 다음 안내를 따르세요.
콘솔
Google Cloud 콘솔에서 Cloud Run 작업 페이지로 이동합니다.
관심 있는 작업을 클릭하여 작업 세부정보 페이지를 엽니다.
구성 탭을 클릭합니다.
구성 세부정보에서 메모리 한도 설정을 찾습니다.
gcloud
다음 명령어를 사용하세요.
gcloud run jobs describe JOB_NAME
반환된 구성에서 메모리 한도 설정을 찾습니다.