최소 인스턴스 설정(서비스)

콘솔

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

   Cloud Run으로 이동

2. 새 서비스를 구성하는 경우 컨테이너 배포를 클릭하고 서비스를 선택하여 서비스 만들기 양식을 표시합니다. 기존 서비스를 구성하는 경우 서비스를 클릭하여 세부정보 패널을 표시한 후 세부정보 패널 오른쪽 상단의 최소 인스턴스 옆에 있는 펜 아이콘을 클릭합니다.

3. 서비스 자동 확장 양식을 찾습니다.

   

   • 최소 인스턴스 수로 라벨이 지정된 필드에서 요청을 수신할 수 있도록 웜 상태로 유지하기 위해 컨테이너 인스턴스 수를 지정합니다.

4. 새 서비스의 경우 만들기를 클릭하고 기존 서비스의 경우 배포를 클릭합니다.

gcloud

다음 명령어를 사용하여 지정된 서비스에 대해 service-min-instances를 업데이트합니다.

gcloud run services update SERVICE --service-min-instances MIN-VALUE

다음과 같이 바꿉니다.

• SERVICE를 서비스 이름으로 바꿉니다.
• MIN-VALUE: 요청을 수신할 수 있도록 웜 상태로 유지할 컨테이너 인스턴스 수. 최소 인스턴스 설정을 삭제하려면 default를 지정합니다.

또는 다음 명령어를 사용해서 배포 중 service-min-instances를 설정할 수 있습니다.

gcloud run deploy --image IMAGE_URL --service-min-instances MIN-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입니다.
• MIN-VALUE: 요청을 수신할 수 있도록 웜 상태로 유지할 컨테이너 인스턴스 수. 최소 인스턴스 설정을 삭제하려면 default를 지정합니다.

YAML

1. 새 서비스를 만드는 경우에는 이 단계를 건너뜁니다. 기존 서비스를 업데이트하는 경우 YAML 구성을 다운로드합니다.

   gcloud run services describe SERVICE --format export > service.yaml

2. run.googleapis.com/minScale 속성을 업데이트합니다.

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
     annotations:
       run.googleapis.com/minScale: 'MIN_INSTANCE'

   다음과 같이 바꿉니다.

   • SERVICE: Cloud Run 서비스 이름
   • MIN-INSTANCE: 요청을 수신할 수 있도록 웜 상태로 유지할 인스턴스 수.

3. 다음 명령어를 사용하여 서비스를 만들거나 업데이트합니다.

   gcloud run services replace service.yaml

클라이언트 라이브러리

코드에서 서비스의 서비스 수준 최소 인스턴스를 업데이트하려면 다음 단계를 따르세요.

• Go
• 자바
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

특정 서비스의 서비스 수준 최소 인스턴스를 업데이트하려면 Cloud Run Admin API service 엔드포인트에 PATCH HTTP 요청을 보냅니다.

예를 들어 다음과 같이 curl을 사용합니다.

curl -H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-X PATCH \
-d '{ "scaling": { "minInstanceCount": MIN-VALUE }}' \
https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE?update_mask=scaling.minInstanceCount

다음과 같이 바꿉니다.

• ACCESS_TOKEN: 서비스를 삭제할 수 있는 IAM 권한이 있는 계정의 유효한 액세스 토큰. 예를 들어 gcloud에 로그인한 경우 gcloud auth print-access-token을 사용하여 액세스 토큰을 검색할 수 있습니다. Cloud Run 컨테이너 인스턴스 내에서 컨테이너 인스턴스 메타데이터 서버를 사용하여 액세스 토큰을 검색할 수 있습니다.
• MIN-VALUE: 요청을 수신할 수 있도록 웜 상태로 유지할 컨테이너 인스턴스 수.
• SERVICE: 서비스 이름
• REGION: 서비스의 Google Cloud 리전
• PROJECT-ID: Google Cloud 프로젝트 ID

콘솔

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

   Cloud Run으로 이동

2. 관심이 있는 서비스를 클릭하여 서비스 세부정보 패널을 엽니다.

3. 현재 설정은 최소 인스턴스 옆에 있는 서비스 세부정보 패널의 오른쪽 상단에 표시됩니다.

gcloud

1. 다음 명령어를 사용하세요.

   gcloud run services describe SERVICE

2. 반환된 구성에서 Service-level Min Instances: 값을 찾습니다.

콘솔

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

   Cloud Run으로 이동

2. 컨테이너 배포를 클릭하고 서비스를 선택하여 새 서비스를 구성합니다. 기존 서비스를 구성하는 경우 서비스를 클릭한 후 새 버전 수정 및 배포를 클릭합니다.

3. 새 서비스를 구성하는 경우 초기 서비스 설정 페이지를 작성한 후 컨테이너, 볼륨, 네트워킹, 보안을 클릭하여 서비스 구성 페이지를 펼칩니다.

4. 컨테이너 탭을 클릭합니다.

   

   • 최소 인스턴스 수로 라벨이 지정된 필드에서 요청을 수신할 수 있도록 웜 상태로 유지하기 위해 컨테이너 인스턴스 수를 지정합니다.

5. 만들기 또는 배포를 클릭합니다.

gcloud

다음 명령어를 사용하여 제공된 서비스의 min-instance를 업데이트합니다.

gcloud run services update SERVICE --min-instances MIN-VALUE

다음과 같이 바꿉니다.

• SERVICE를 서비스 이름으로 바꿉니다.
• MIN-VALUE: 요청을 수신할 수 있도록 웜 상태로 유지할 컨테이너 인스턴스 수. 최소 인스턴스 설정을 삭제하려면 default를 지정합니다.

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

gcloud run deploy --image IMAGE_URL --min-instances MIN-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입니다.
• MIN-VALUE: 요청을 수신할 수 있도록 웜 상태로 유지할 컨테이너 인스턴스 수. 최소 인스턴스 설정을 삭제하려면 default를 지정합니다.

YAML

1. 새 서비스를 만드는 경우에는 이 단계를 건너뜁니다. 기존 서비스를 업데이트하는 경우 YAML 구성을 다운로드합니다.

   gcloud run services describe SERVICE --format export > service.yaml

2. autoscaling.knative.dev/minScale: 속성을 업데이트합니다.

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           autoscaling.knative.dev/minScale: 'MIN-INSTANCE'
         name: REVISION

   다음과 같이 바꿉니다.

   • SERVICE: Cloud Run 서비스 이름
   • MIN-INSTANCE: 요청을 수신할 수 있도록 웜 상태로 유지할 인스턴스 수.
   • REVISION을 새 버전 이름으로 변경하거나 이미 있는 경우 삭제합니다. 새 버전 이름을 제공할 경우 다음 기준을 반드시 충족해야 합니다.
     • SERVICE-로 시작해야 합니다.
     • 소문자, 숫자, -만 포함합니다.
     • -로 끝나면 안 됩니다.
     • 63자(영문 기준) 이하여야 합니다.

3. 다음 명령어를 사용하여 서비스를 만들거나 업데이트합니다.

   gcloud run services replace service.yaml

Terraform

Terraform 구성을 적용하거나 삭제하는 방법은 기본 Terraform 명령어를 참조하세요.

다음 google_cloud_run_v2_service 리소스는 template.scaling에서 1의 최소 인스턴스 수를 지정합니다. 1을 최소 인스턴스 수로 바꿉니다.

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-min-instances"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
    scaling {
      # Min instances
      min_instance_count = 1
    }
  }
}

콘솔

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

   Cloud Run으로 이동

2. 관심이 있는 서비스를 클릭하여 서비스 세부정보 페이지를 엽니다.

3. 버전 탭을 클릭합니다.

4. 오른쪽 세부정보 패널에서 버전 수준의 최소 인스턴스 설정이 컨테이너 탭 아래에 나열됩니다.

gcloud

1. 다음 명령어를 사용하세요.

   gcloud run services describe SERVICE

2. 반환된 구성에서 버전 수준 최소 인스턴스 설정을 찾습니다.