이 페이지에서는 Cloud Run 서비스에 사용할 수 있는 최대 인스턴스 수를 설정하는 방법을 설명합니다.
Cloud Run에서 최대 인스턴스를 지정하면 수신 요청에 대한 응답으로 서비스의 확장을 제한할 수 있습니다. 하지만 이 최대 설정은 트래픽 급증과 같은 상황으로 인해 일시적으로 초과할 수 있습니다.
이 설정을 사용하여 비용을 제어하거나 데이터베이스와 같은 백업 서비스에 대한 연결 수를 제한할 수 있습니다.
서비스에 적용될 수 있는 최대 인스턴스 한도에 대한 자세한 내용은 최대 인스턴스 한도를 참조하세요.
Cloud Run이 컨테이너 인스턴스를 자동 확장하는 방법에 대한 자세한 내용은 인스턴스 자동 확장을 참조하세요.
필요한 역할
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 서비스는 최대 100개의 인스턴스로 수평 확장되도록 구성됩니다.
새 서비스를 만들거나 새 버전을 배포할 때 Google Cloud 콘솔, Google Cloud CLI 또는 YAML 파일을 사용하여 최대 인스턴스 설정을 변경할 수 있습니다.
콘솔
Google Cloud 콘솔에서 Cloud Run으로 이동합니다.
컨테이너 배포를 클릭하고 서비스를 선택하여 새 서비스를 구성합니다. 기존 서비스를 구성하는 경우 서비스를 클릭한 후 새 버전 수정 및 배포를 클릭합니다.
새 서비스를 구성하는 경우 초기 서비스 설정 페이지를 작성한 후 컨테이너, 볼륨, 네트워킹, 보안을 클릭하여 서비스 구성 페이지를 펼칩니다.
컨테이너 탭을 클릭합니다.
- 최소 인스턴스 수로 라벨이 지정된 필드에서
1
에서 최대 한도까지의 정수 값을 사용하여 원하는 최대 인스턴스 수를 지정합니다.
- 최소 인스턴스 수로 라벨이 지정된 필드에서
만들기 또는 배포를 클릭합니다.
gcloud
다음 명령어를 사용하여 지정된 서비스의 최대 인스턴스 수를 업데이트할 수 있습니다.
gcloud run services update SERVICE --max-instances MAX-VALUE
다음과 같이 바꿉니다.
- SERVICE를 서비스 이름으로 바꿉니다.
- MAX-VALUE를
1
에서 최대 한도까지의 정수 값을 사용하여 원하는 최대 컨테이너 인스턴스 수로 바꿉니다. 최대 인스턴스 설정을 삭제하고 기본 인스턴스 100개를 복원하려면default
를 지정합니다.
배포 중에 다음 명령어를 사용하여 최대 인스턴스 수를 설정할 수도 있습니다.
gcloud run deploy --image IMAGE_URL --max-instances MAX-VALUE
다음과 같이 바꿉니다.
- IMAGE_URL: 컨테이너 이미지에 대한 참조(예:
us-docker.pkg.dev/cloudrun/container/hello:latest
). Artifact Registry를 사용하는 경우 저장소 REPO_NAME이 이미 생성되어 있어야 합니다. URL의 형식은LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
입니다. - MAX-VALUE를 원하는 최대 컨테이너 인스턴스 수로 바꿉니다.
YAML
새 서비스를 만드는 경우에는 이 단계를 건너뜁니다. 기존 서비스를 업데이트하는 경우 YAML 구성을 다운로드합니다.
gcloud run services describe SERVICE --format export > service.yaml
autoscaling.knative.dev/maxScale:
속성을 업데이트합니다.apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE spec: template: metadata: annotations: autoscaling.knative.dev/maxScale: 'MAX-INSTANCE' name: REVISION
다음과 같이 바꿉니다.
- SERVICE: Cloud Run 서비스 이름
- MAX-INSTANCE를 필요한 최대 개수로 바꿉니다.
- REVISION을 새 버전 이름으로 변경하거나 이미 있는 경우 삭제합니다. 새 버전 이름을 제공할 경우 다음 기준을 반드시 충족해야 합니다.
SERVICE-
로 시작해야 합니다.- 소문자, 숫자,
-
만 포함합니다. -
로 끝나면 안 됩니다.- 63자(영문 기준) 이하여야 합니다.
다음 명령어를 사용하여 서비스를 만들거나 업데이트합니다.
gcloud run services replace service.yaml
Terraform
Terraform 구성을 적용하거나 삭제하는 방법은 기본 Terraform 명령어를 참조하세요.
다음 google_cloud_run_v2_service
리소스는 template.scaling
에서 10
의 최대 인스턴스 수를 지정합니다.
10
을 필요한 최대 인스턴스 수로 바꿉니다.
최대 인스턴스 설정 보기
Cloud Run 서비스에 대해 현재 최대 인스턴스 설정을 보려면 다음 안내를 따르세요.
콘솔
Google Cloud 콘솔에서 Cloud Run으로 이동합니다.
관심이 있는 서비스를 클릭하여 서비스 세부정보 페이지를 엽니다.
버전 탭을 클릭합니다.
오른쪽의 세부정보 패널에서 최대 인스턴스 설정이 컨테이너 탭에 표시됩니다.
gcloud
다음 명령어를 사용하세요.
gcloud run services describe SERVICE
반환된 구성에서 최대 인스턴스 설정을 찾습니다.