이 문서에서는 연결된 GPU가 있는 가상 머신(VM) 인스턴스의 관리형 인스턴스 그룹(MIG)에서 크기 조절 요청을 만드는 방법을 설명합니다. 크기 조절 요청에 대해 자세히 알아보려면 MIG의 크기 조절 요청 정보를 참조하세요.
MIG 크기 조절 요청을 만들면 GPU와 같이 수요가 많은 리소스를 획득하고 정확한 수의 VM을 한 번에 만들어 비용을 최적화할 수 있습니다. Cluster Director에서 제공하는 기능과 서비스를 사용할 수 있는 MIG 크기 조절 요청을 만들려면 AI 하이퍼컴퓨터 문서의 MIG 및 크기 조절 요청 만들기를 참조하세요.
시작하기 전에
- MIG 크기 조절 요청을 사용하여 최대 7일 동안 실행되는 워크로드에 리소스를 사용할 수 있게 되는 즉시 VM을 만들려면 요청한 리소스에 대해 충분한 표준 또는 선점형 할당량이 있는지 확인하세요. 자세한 내용은 GPU 할당량을 확인하는 방법을 참조하세요.
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다.
로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
-
인스턴스 템플릿을 만들려면 프로젝트에 대해
compute.instanceTemplates.create
권한이 필요합니다. -
영역 MIG를 만들려면 프로젝트에 대해
compute.instanceGroupManagers.create
권한이 필요합니다. -
MIG 크기 조절 요청을 만들려면 프로젝트에 대해
compute.instanceGroupManagers.update
권한이 필요합니다. 최대 7일 동안 실행되는 워크로드에 리소스를 사용할 수 있게 되는 즉시 VM을 만들려면 flex-start 프로비저닝 모델을 사용하여 인스턴스 템플릿을 만드세요.
캘린더 모드에서 미래용 예약에 대해 자동 생성된 예약을 사용하여 VM을 만들려면 '예약에 따름' 프로비저닝 모델을 사용하여 인스턴스 템플릿을 만드세요.
A4X 머신 유형을 제외한 GPU 머신 유형을 사용합니다.
호스트 유지보수 이벤트 중 VM을 중지합니다.
maxRunDuration
및instanceTerminationAction
필드를 사용하여 실행 기간이 종료될 때 VM을 삭제합니다.flex-start 프로비저닝 모델을 사용합니다.
Google Cloud 콘솔에서 인스턴스 템플릿 페이지로 이동합니다.
인스턴스 템플릿 만들기를 클릭합니다. 인스턴스 템플릿 만들기 페이지가 열립니다.
이름 필드에 인스턴스 템플릿의 이름을 입력합니다.
위치 섹션에서 다음 옵션 중 하나를 선택합니다.
리전 인스턴스 템플릿을 만들려면 리전(권장)을 선택한 후 템플릿을 만들 리전을 선택합니다.
전역 인스턴스 템플릿을 만들려면 전역을 선택합니다.
머신 구성 섹션에서 다음을 수행합니다.
GPU 탭을 클릭합니다.
GPU 유형 목록에서 GPU 유형을 선택합니다.
GPU 수 목록에서 GPU 수를 선택합니다.
선택사항: 선택한 GPU 유형이 그래픽 워크로드에 대한 NVIDIA RTX 가상 워크스테이션(vWS)을 지원하고 그래픽 집약적인 워크로드를 실행하려는 경우 가상 워크스테이션 사용(NVIDIA GRID) 설정을 선택합니다.
머신 유형 섹션에서 머신 유형을 선택합니다.
모델 프로비저닝 섹션에서 다음 단계를 완료합니다.
VM 프로비저닝 모델 필드에서 Flex-start를 선택합니다.
VM 프로비저닝 모델 고급 설정을 펼칩니다.
VM 시간 제한 설정 체크박스를 선택합니다.
인스턴스 템플릿을 통해 생성된 VM의 실행 기간을 설정하려면 시간 수 입력 필드에 시간 수를 입력합니다. 값은 36초(
0.01
)에서 7일(168
) 사이여야 합니다.
(선택사항) 부팅 디스크 유형 또는 이미지를 변경하려면 부팅 디스크 섹션에서 변경을 클릭합니다. 그런 다음 안내에 따라 부팅 디스크를 변경합니다.
만들기를 클릭합니다.
DELETE
로 설정된--instance-termination-action
플래그TERMINATE
로 설정된--maintenance-policy
플래그--max-run-duration
플래그FLEX_START
로 설정된--provisioning-model
플래그none
로 설정된--reservation-affinity
플래그INSTANCE_TEMPLATE_NAME
: 만들려는 인스턴스 템플릿의 이름입니다.IMAGE_PROJECT
: 이미지가 포함된 이미지 프로젝트입니다(예:debian-cloud
). 지원되는 이미지 프로젝트에 대한 자세한 내용은 공개 이미지를 참조하세요.IMAGE_FAMILY
: 이미지 계열입니다. 지원 중단되지 않은 최신 OS 이미지를 지정합니다. 예를 들어debian-12
를 지정하면 Debian 12 이미지 계열의 최신 버전이 사용됩니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.REGION
: 인스턴스 템플릿을 만들 리전MACHINE_TYPE
: VM에 사용할 GPU 머신 유형입니다. N1 머신 유형을 지정하는 경우 VM에 연결할 GPU 유형 및 개수를 정의하기 위해--accelerator
플래그를 포함해야 합니다.RUN_DURATION
: 요청된 VM을 실행할 기간입니다. 값 형식은 각각d
,h
,m
,s
를 사용해서 일, 시간, 분, 초로 지정해야 합니다. 예를 들어 30분에30m
을 지정하고 1일 2시간 3분 4초에1d2h3m4s
를 지정합니다. 값은 10분~7일 사이여야 합니다.리전 인스턴스 템플릿을 만들려면 베타
regionInstanceTemplates.insert
메서드를 사용합니다.전역 인스턴스 템플릿을 만들려면 베타
instanceTemplates.insert
메서드를 사용합니다.NO_RESERVATION
으로 설정된reservationAffinity.consumeReservationType
필드DELETE
로 설정된scheduling.instanceTerminationAction
필드scheduling.maxRunDuration
필드TERMINATE
로 설정된scheduling.onHostMaintenance
필드FLEX_START
로 설정된scheduling.provisioningModel
필드PROJECT_ID
: 인스턴스 템플릿을 만들 프로젝트의 IDREGION
: 인스턴스 템플릿을 만들 리전INSTANCE_TEMPLATE_NAME
: 만들려는 인스턴스 템플릿의 이름입니다.IMAGE_PROJECT
: 이미지가 포함된 이미지 프로젝트입니다(예:debian-cloud
). 지원되는 이미지 프로젝트에 대한 자세한 내용은 공개 이미지를 참조하세요.IMAGE
: 다음 중 하나를 지정합니다.OS 이미지의 특정 버전입니다(예:
debian-12-bookworm-v20240617
).이미지 계열이며 형식은
family/IMAGE_FAMILY
여야 합니다. 중단되지 않은 최신 OS 이미지를 지정합니다. 예를 들어family/debian-12
를 지정하면 Debian 12 이미지 계열의 최신 버전이 사용됩니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.
MACHINE_TYPE
: VM에 사용할 GPU 머신 유형입니다. N1 머신 유형을 지정하는 경우 VM에 연결할 GPU 유형 및 개수를 정의하기 위해guestAccelerators
필드를 포함해야 합니다.RUN_DURATION
: 요청된 VM을 실행할 기간(초)입니다. 값은 600초(10분)를 나타내는600
에서 604,800초(7일)를 나타내는604800
사이여야 합니다.예약에 지정된 대로 A4 또는 A3 Ultra 머신 유형을 사용합니다.
호스트 유지보수 이벤트 중 VM을 중지합니다.
instanceTerminationAction
필드를 사용하여 예약 기간이 종료될 때 VM을 삭제합니다.'예약에 따름' 프로비저닝 모델을 사용합니다.
Google Cloud 콘솔에서 인스턴스 템플릿 페이지로 이동합니다.
인스턴스 템플릿 만들기를 클릭합니다. 인스턴스 템플릿 만들기 페이지가 열립니다.
이름 필드에 인스턴스 템플릿의 이름을 입력합니다.
위치 섹션에서 다음 옵션 중 하나를 선택합니다.
리전 인스턴스 템플릿을 만들려면 리전(권장)을 선택한 후 템플릿을 만들 리전을 선택합니다.
전역 인스턴스 템플릿을 만들려면 전역을 선택합니다.
머신 구성 섹션에서 다음을 수행합니다.
GPU 탭을 클릭합니다.
GPU 유형 목록에서 사용하려는 예약에 지정된 다음 옵션 중 하나를 선택합니다.
A4 VM 사용: NVIDIA B200 180GB
A3 Ultra VM 사용: NVIDIA H200 141GB
이 작업을 실행하면 인스턴스 템플릿의 프로비저닝 모델이 '예약에 따름'으로 자동 설정됩니다.
GPU 수 목록에서 GPU 수를 선택합니다.
선택사항: 선택한 GPU 유형이 그래픽 워크로드에 대한 NVIDIA RTX 가상 워크스테이션(vWS)을 지원하고 그래픽 집약적인 워크로드를 실행하려는 경우 가상 워크스테이션 사용(NVIDIA GRID) 설정을 선택합니다.
머신 유형 섹션에서 머신 유형을 선택합니다.
모델 프로비저닝 섹션에서 다음 단계를 완료합니다.
VM 프로비저닝 모델 고급 설정을 펼칩니다.
VM 종료 시 목록에서 삭제를 선택합니다.
(선택사항) 부팅 디스크 유형 또는 이미지를 변경하려면 부팅 디스크 섹션에서 변경을 클릭합니다. 그런 다음 안내에 따라 부팅 디스크를 변경합니다.
고급 옵션 섹션을 펼친 후 다음을 수행합니다.
관리 섹션을 펼칩니다.
예약 섹션에서 예약 선택을 선택한 다음 예약 선택을 클릭합니다. 표시되는 창에서 메시지에 따라 사용할 예약을 선택합니다.
만들기를 클릭합니다.
DELETE
로 설정된--instance-termination-action
플래그TERMINATE
로 설정된--maintenance-policy
플래그RESERVATION_BOUND
로 설정된--provisioning-model
플래그specific
로 설정된--reservation-affinity
플래그--reservation
플래그INSTANCE_TEMPLATE_NAME
: 만들려는 인스턴스 템플릿의 이름입니다.IMAGE_PROJECT
: 이미지가 포함된 이미지 프로젝트입니다(예:debian-cloud
). 지원되는 이미지 프로젝트에 대한 자세한 내용은 공개 이미지를 참조하세요.IMAGE_FAMILY
: 이미지 계열입니다. 지원 중단되지 않은 최신 OS 이미지를 지정합니다. 예를 들어debian-12
를 지정하면 Debian 12 이미지 계열의 최신 버전이 사용됩니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.REGION
: 인스턴스 템플릿을 만들 리전MACHINE_TYPE
: 사용할 예약에 지정된 A4 또는 A3 Ultra 머신 유형RESERVATION_URL
: 사용할 캘린더 모드의 미래용 예약에 대해 자동 생성된 예약의 URL 다음 값 중 하나를 지정합니다.자동 생성된 예약이 프로젝트에 있는 경우:
RESERVATION_NAME
자동 생성된 예약이 다른 프로젝트에 있는 경우:
projects/PROJECT_ID/reservations/RESERVATION_NAME
리전 인스턴스 템플릿을 만들려면
regionInstanceTemplates.insert
메서드를 사용합니다.전역 인스턴스 템플릿을 만들려면
instanceTemplates.insert
메서드를 사용합니다.SPECIFIC_RESERVATION
으로 설정된reservationAffinity.consumeReservationType
필드compute.googleapis.com/reservation-name
으로 설정된reservationAffinity.key
필드자동 생성된 예약의 URL로 설정된
reservationAffinity.values
필드DELETE
로 설정된scheduling.instanceTerminationAction
필드TERMINATE
로 설정된scheduling.onHostMaintenance
필드RESERVATION_BOUND
로 설정된scheduling.provisioningModel
필드PROJECT_ID
: 인스턴스 템플릿을 만들 프로젝트의 IDREGION
: 인스턴스 템플릿을 만들 리전INSTANCE_TEMPLATE_NAME
: 만들려는 인스턴스 템플릿의 이름입니다.IMAGE_PROJECT
: 이미지가 포함된 이미지 프로젝트입니다(예:debian-cloud
). 지원되는 이미지 프로젝트에 대한 자세한 내용은 공개 이미지를 참조하세요.IMAGE
: 다음 중 하나를 지정합니다.OS 이미지의 특정 버전입니다(예:
debian-12-bookworm-v20240617
).이미지 계열이며 형식은
family/IMAGE_FAMILY
여야 합니다. 중단되지 않은 최신 OS 이미지를 지정합니다. 예를 들어family/debian-12
를 지정하면 Debian 12 이미지 계열의 최신 버전이 사용됩니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.
MACHINE_TYPE
: 사용할 예약에 지정된 A4 또는 A3 Ultra 머신 유형RESERVATION_URL
: 사용할 캘린더 모드의 미래용 예약에 대해 자동 생성된 예약의 URL 다음 값 중 하나를 지정합니다.자동 생성된 예약이 프로젝트에 있는 경우:
RESERVATION_NAME
자동 생성된 예약이 다른 프로젝트에 있는 경우:
projects/PROJECT_ID/reservations/RESERVATION_NAME
MIG 업데이트 유형을 상황별로 설정합니다(기본값).
MIG에서 자동 확장을 구성한 경우 자동 확장 구성을 삭제합니다.
리전 MIG를 사용하는 경우 목표 분산 형태를
ANY_SINGLE_ZONE
으로 설정합니다.Google Cloud 콘솔에서 인스턴스 그룹 페이지로 이동합니다.
인스턴스 그룹 만들기를 클릭합니다. 인스턴스 그룹 만들기 페이지가 열립니다.
이름 필드에 MIG 이름을 입력합니다.
인스턴스 템플릿을 선택하기 전에 다음과 같이 자동 확장 구성을 삭제하고 복구를 사용 중지해야 합니다.
자동 확장 구성을 삭제하려면 다음 단계를 따르세요.
자동 확장 섹션에서 자동 확장 모드 목록을 클릭한 후 자동 확장 구성 삭제를 클릭합니다.
확인 대화상자에서 삭제를 클릭합니다.
복구를 사용 중지하려면 VM 인스턴스 수명 주기 섹션에서 실패 시 기본 작업 목록을 클릭한 다음 작업 없음을 선택합니다.
인스턴스 템플릿 필드로 돌아갑니다. 인스턴스 템플릿 목록에서 이전 섹션에서 만든 인스턴스 템플릿을 선택합니다. 리전 인스턴스 템플릿을 선택하면 리전 목록이 템플릿의 리전으로 설정됩니다.
다음 중 하나를 수행합니다.
MIG를 만들 때 크기 조절 요청을 만들려면 다음 단계를 따르세요.
인스턴스 수 필드에 한 번에 만들려는 VM 수를 입력합니다.
크기 조절 요청을 사용하여 한 번에 모든 VM 만들기 체크박스를 선택합니다.
선택사항: MIG의 인스턴스 템플릿에서 실행 기간을 지정하는 경우 다른 실행 기간을 지정할 수 있습니다. 이렇게 하려면 요청된 실행 기간 필드와 단위 목록에서 실행 기간을 지정합니다. 1시간에서 7일 사이의 기간을 지정해야 합니다.
MIG를 만든 후 크기 조절 요청을 만들려면 인스턴스 수 필드에
0
을 입력합니다.
위치 섹션에서 다음과 같이 영역 또는 리전 MIG를 만들지 여부를 지정합니다.
영역 MIG를 만들려면 단일 영역을 선택합니다. 또는 리전 MIG를 만들려면 여러 영역을 선택합니다.
MIG의 리전 및 영역을 선택합니다.
리전 MIG를 만드는 경우 다음을 수행합니다.
목표 분산 형태 필드에서 모든 단일 영역을 선택합니다.
대화상자가 나타나면 인스턴스 재분산 사용 중지를 클릭합니다.
만들기를 클릭합니다.
영역 MIG를 만들려면 다음 명령어를 실행합니다.
gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=0 \ --zone=ZONE \ --default-action-on-vm-failure=do_nothing
리전 MIG를 만들려면 다음 명령어를 실행합니다.
gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --template=INSTANCE_TEMPLATE_URL \ --size=0 \ --region=REGION \ --target-distribution-shape=any-single-zone \ --instance-redistribution-type=none \ --default-action-on-vm-failure=do_nothing
INSTANCE_GROUP_NAME
: 만들려는 MIG의 이름입니다.INSTANCE_TEMPLATE_URL
: 이전 섹션에서 만든 인스턴스 템플릿의 부분 URL입니다. 리전 인스턴스 템플릿을 사용하여 MIG를 만들려면 템플릿의 리전 내에만 MIG를 만들 수 있습니다. 다음 값 중 하나를 지정합니다.리전 인스턴스 템플릿의 경우:
projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME
전역 인스턴스 템플릿의 경우:
INSTANCE_TEMPLATE_NAME
ZONE
: MIG를 만들 영역REGION
: MIG를 만들 리전영역 MIG를 만들려면 다음과 같이
instanceGroupManagers.insert
메서드를 사용하여POST
요청을 전송합니다.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "INSTANCE_GROUP_NAME", "targetSize": 0, "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } }
리전 MIG를 만들려면 다음과 같이
regionInstanceGroupManagers.insert
메서드를 사용하여POST
요청을 전송합니다.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "INSTANCE_GROUP_NAME", "targetSize": 0, "distributionPolicy": { "targetShape": "ANY_SINGLE_ZONE" }, "updatePolicy": { "instanceRedistributionType": "NONE" }, "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } }
PROJECT_ID
: 이전 섹션에서 만든 인스턴스 템플릿이 있는 프로젝트의 ID입니다.INSTANCE_TEMPLATE_URL
: 이전 섹션에서 만든 인스턴스 템플릿의 부분 URL입니다. 리전 인스턴스 템플릿을 사용하여 MIG를 만들려면 템플릿의 리전 내에만 MIG를 만들 수 있습니다. 다음 값 중 하나를 지정합니다.리전 인스턴스 템플릿의 경우:
regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_NAME
전역 인스턴스 템플릿의 경우:
global/instanceTemplates/INSTANCE_TEMPLATE_NAME
ZONE
: MIG를 만들 영역REGION
: MIG를 만들 리전INSTANCE_GROUP_NAME
: 만들려는 MIG의 이름입니다.Google Cloud 콘솔에서 인스턴스 그룹 페이지로 이동합니다.
이름 열에서 크기 조절 요청을 만들 MIG의 이름을 클릭합니다.
MIG의 개요 페이지가 열립니다.
크기 조절 요청 행에서
크기 조절 요청 수정을 클릭합니다.새 크기 조절 요청을 클릭합니다.
새 크기 조절 요청 창이 나타납니다.
이름 필드에 크기 조절 요청의 이름을 입력합니다.
필요한 추가 인스턴스 수 필드에 MIG에 한 번에 추가할 VM 수를 입력합니다.
선택사항: MIG의 인스턴스 템플릿에서 실행 기간을 지정하는 경우 다른 실행 기간을 지정할 수 있습니다. 이렇게 하려면 요청된 실행 기간 필드와 단위 목록에서 실행 기간을 지정합니다. 1시간에서 7일 사이의 기간을 지정해야 합니다.
만들기를 클릭합니다.
영역 MIG에서 크기 조절 요청을 만들려면
instance-groups managed resize-requests create
명령어를 사용합니다.gcloud compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --resize-by=COUNT \ --zone=ZONE
리전 MIG에서 크기 조절 요청을 만들려면
beta instance-groups managed resize-requests create
명령어를 사용합니다.gcloud beta compute instance-groups managed resize-requests create INSTANCE_GROUP_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --resize-by=COUNT \ --region=REGION
INSTANCE_GROUP_NAME
: 크기 조절 요청을 만들도록 구성된 MIG의 이름입니다.RESIZE_REQUEST_NAME
:지정된 MIG 내에서 고유해야 하는 크기 조절 요청의 이름입니다. 그렇지 않으면 크기 조절 요청 만들기가 실패합니다.COUNT
: MIG에 모두 한 번에 모두 추가할 VM 수입니다.ZONE
: MIG가 있는 영역입니다.REGION
: MIG가 있는 리전입니다.MIG의 인스턴스 템플릿에서 실행 기간을 지정한 경우 다른 실행 기간을 지정할 수 있습니다. 이렇게 하려면 명령어에
--requested-run-duration
플래그를 포함하세요. 10분에서 7일 사이의 기간을 지정해야 합니다.워크로드에 특정 VM 이름이 필요한 경우
beta instance-groups managed resize-requests create
명령어를 사용하여 만들 VM의 이름 목록을 지정할 수 있습니다. 명령어에서--resize-request
플래그를--instances
플래그로 바꿉니다.영역 MIG에서 크기 조절 요청을 만들려면
instanceGroupManagerResizeRequests.insert
메서드를 사용하여POST
요청을 전송합니다.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
리전 MIG에서 크기 조절 요청을 만들려면
beta.regionInstanceGroupManagerResizeRequests.insert
메서드를 사용하여POST
요청을 전송합니다.PROJECT_ID
: 지정된 MIG가 있는 프로젝트의 ID입니다.ZONE
: MIG가 있는 영역입니다.REGION
: MIG가 있는 리전입니다.INSTANCE_GROUP_NAME
: 크기 조절 요청을 만들도록 구성된 MIG의 이름입니다.RESIZE_REQUEST_NAME
:지정된 MIG 내에서 고유해야 하는 크기 조절 요청의 이름입니다. 그렇지 않으면 크기 조절 요청 만들기가 실패합니다.COUNT
: MIG에 한 번에 모두 추가할 VM 수입니다.MIG의 인스턴스 템플릿에서 실행 기간을 지정한 경우 다른 실행 기간을 지정할 수 있습니다. 이렇게 하려면 요청 본문에
requestedRunDuration
필드를 포함합니다. 기간은 10분에서 7일 사이로 초 단위로 지정해야 합니다.워크로드에 특정 VM 이름이 필요한 경우 만들 VM의 이름 목록을 지정할 수 있습니다. 이렇게 하려면 리전 MIG의 경우
beta.regionInstanceGroupManagerResizeRequests.insert
메서드에, 영역 MIG의 경우beta.instanceGroupManagerResizeRequests.insert
메서드에POST
요청을 전송합니다. 요청 본문에서resizeBy
필드를instanceNames
필드로 바꿉니다.MIG에서 크기 조절 요청 보기, 취소, 삭제 방법 알아보기
MIG 및 관리형 VM 정보 보기 방법 알아보기
- VM 및 GPU의 실제 및 예상 사용량을 확인하는 방법 알아보기
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.
필요한 역할
MIG 크기 조절 요청을 만드는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 인스턴스 관리자(v1)(
roles/compute.instanceAdmin.v1
) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.이 사전 정의된 역할에는 MIG 크기 조절 요청을 만드는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
MIG 크기 조절 요청을 만들려면 다음 권한이 필요합니다.
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
크기 조절 요청을 위한 MIG 준비
MIG 크기 조절 요청을 만들려면 다음 섹션에 설명된 대로 인스턴스 템플릿과 MIG를 구성해야 합니다.
인스턴스 템플릿 만들기
MIG 크기 조절 요청의 사용 사례에 따라 다음 방법 중 하나를 사용하여 인스턴스 템플릿을 만듭니다.
flex-start(유연한 시작) 프로비저닝 모델 사용
MIG 크기 조절 요청과 리소스를 사용할 수 있게 되는 즉시 VM을 만들도록 구성된 인스턴스 템플릿을 만들려면 템플릿에서 다음을 지정해야 합니다.
인스턴스 템플릿을 만들려면 다음 옵션 중 하나를 선택합니다.
콘솔
gcloud
인스턴스 템플릿을 만들려면 다음 플래그와 함께
beta instance-templates create
명령어를 사용합니다.예를 들어 리전 인스턴스 템플릿을 만들려면 다음 명령어를 실행합니다. 전역 인스턴스 템플릿을 만들려면
--instance-template-region
플래그 없이 동일한 명령어를 사용합니다.gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \ --image-project=IMAGE_PROJECT \ --image-family=IMAGE_FAMILY \ --instance-template-region=REGION \ --instance-termination-action=DELETE \ --machine-type=MACHINE_TYPE \ --maintenance-policy=TERMINATE \ --max-run-duration=RUN_DURATION \ --provisioning-model=FLEX_START \ --reservation-affinity=none
다음을 바꿉니다.
REST
인스턴스 템플릿을 만들려면
POST
요청을 다음 메서드 중 하나에 보냅니다.요청 본문에 다음 필드를 포함합니다.
예를 들어 리전 인스턴스 템플릿을 만들려면 다음과 같이 요청합니다.
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceTemplates { "name": "INSTANCE_TEMPLATE_NAME", "properties": { "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "machineType": "MACHINE_TYPE", "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" }, "scheduling": { "instanceTerminationAction": "DELETE", "maxRunDuration": { "seconds": RUN_DURATION }, "onHostMaintenance": "TERMINATE", "provisioningModel": "FLEX_START" } } }
다음을 바꿉니다.
인스턴스 템플릿 만들기에 대한 자세한 내용은 인스턴스 템플릿 만들기를 참조하세요.
'예약에 따름' 프로비저닝 모델 사용
MIG 크기 조절 요청 및 예약을 사용하도록 구성된 인스턴스 템플릿을 만들려면 템플릿에서 다음을 지정해야 합니다.
인스턴스 템플릿을 만들려면 다음 옵션 중 하나를 선택합니다.
콘솔
gcloud
인스턴스 템플릿을 만들려면 다음 플래그와 함께
instance-templates create
명령어를 사용합니다.예를 들어 리전 인스턴스 템플릿을 만들려면 다음 명령어를 실행합니다. 전역 인스턴스 템플릿을 만들려면
--instance-template-region
플래그 없이 동일한 명령어를 사용합니다.gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \ --image-project=IMAGE_PROJECT \ --image-family=IMAGE_FAMILY \ --instance-termination-action=DELETE \ --instance-template-region=REGION \ --machine-type=MACHINE_TYPE \ --maintenance-policy=TERMINATE \ --provisioning-model=RESERVATION_BOUND \ --reservation-affinity=specific \ --reservation=RESERVATION_URL
다음을 바꿉니다.
REST
인스턴스 템플릿을 만들려면
POST
요청을 다음 메서드 중 하나에 보냅니다.요청 본문에 다음 필드를 포함합니다.
예를 들어 리전 인스턴스 템플릿을 만들려면 다음과 같이 요청합니다.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates { "name": "INSTANCE_TEMPLATE_NAME", "properties": { "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "machineType": "MACHINE_TYPE", "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "SPECIFIC_RESERVATION", "key": "compute.googleapis.com/reservation-name", "values": [ "RESERVATION_URL" ] }, "scheduling": { "instanceTerminationAction": "DELETE", "onHostMaintenance": "TERMINATE", "provisioningModel": "RESERVATION_BOUND" } } }
다음을 바꿉니다.
인스턴스 템플릿 만들기에 대한 자세한 내용은 인스턴스 템플릿 만들기를 참조하세요.
MIG 만들기 또는 업데이트
이전 섹션에 설명된 대로 인스턴스 템플릿을 만든 후 이 인스턴스 템플릿을 사용하여 다음과 같이 MIG를 만들거나 MIG를 업데이트합니다. 또한 크기 조절 요청에 맞게 MIG를 준비하기 위해 다음을 수행해야 합니다.
크기 조절 요청과 호환되는 MIG를 만들려면 다음 옵션 중 하나를 선택합니다.
콘솔
gcloud
--default-action-on-vm-failure
플래그를do_nothing
으로 설정하여instance-groups managed create
명령어를 사용합니다. 리전 MIG를 만드는 경우--target-distribution-shape
플래그를any-single-zone
으로 설정하고--instance-redistribution-type
플래그를none
으로 설정해야 합니다.다음을 바꿉니다.
REST
다음을 바꿉니다.
MIG에서 크기 조절 요청 만들기
MIG 크기 조절 요청을 만들기 전에 이전 섹션에 설명된 대로 MIG가 준비되었는지 확인합니다.
크기 조절 요청을 만들고 요청된 모든 리소스를 사용할 수 있으면 MIG에서 요청된 개수의 VM을 한 번에 만듭니다. VM은 지정된 실행 기간이 종료되어 MIG에서 삭제되거나 사용자가 VM을 삭제할 때까지 실행됩니다.
MIG에서 크기 조절 요청을 만들려면 다음 옵션 중 하나를 선택합니다. 크기 조절 요청을 통해 특정 이름의 VM을 MIG에 추가하려면 gcloud CLI 또는 REST API를 사용합니다.
콘솔
gcloud
다음을 바꿉니다.
원하는 경우 다음 작업을 수행할 수 있습니다.
REST
요청 본문에 다음을 포함합니다.
{ "name": "RESIZE_REQUEST_NAME", "resizeBy": COUNT }
다음을 바꿉니다.
원하는 경우 다음 작업을 수행할 수 있습니다.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-30(UTC)
-