이 문서에서는 A3 Edge 가속기 최적화 머신 유형을 사용하는 독립형 가상 머신 (VM) 인스턴스를 만드는 단계를 설명합니다. 머신 유형에 대해 자세히 알아보려면 A3 Edge를 참고하세요.
VM 또는 클러스터를 만드는 다른 방법을 알아보려면 개요 페이지를 참고하세요.
제한사항
독립형 A3 Edge VM을 만들 때는 다음 제한사항이 적용됩니다.
- A3 Edge 머신 유형을 사용하는 인스턴스에는 지속 사용 할인 및 가변형 약정 사용 할인이 적용되지 않습니다.
- A3 Edge 머신 유형은 특정 리전 및 영역에서만 사용할 수 있습니다.
- A3 Edge 머신 유형을 사용하는 인스턴스에서는 리전 Persistent Disk를 사용할 수 없습니다.
- A3 Edge 머신 유형은 Sapphire Rapids CPU 플랫폼에서만 사용할 수 있습니다.
- A3 Edge 머신 유형에서는 머신 유형 변경이 지원되지 않습니다. 이 머신 유형으로 전환하거나 이 머신 유형에서 전환하려면 새 인스턴스를 만들어야 합니다.
- A3 Edge 머신 유형에서는 Windows 운영체제를 실행할 수 없습니다.
- A3 Edge 머신 유형은 단독 테넌시를 지원하지 않습니다.
시작하기 전에
아직 완료하지 않았다면 VM을 만들기 전에 다음 단계를 완료하세요.
- 소비 옵션 선택: 소비 옵션 선택에 따라 GPU 리소스를 획득하고 사용하는 방식이 결정됩니다. 자세한 내용은 사용 옵션 선택을 참고하세요.
- 용량 획득: 각 소비 옵션의 용량 획득 프로세스가 다릅니다. 선택한 소비 옵션의 용량을 확보하는 프로세스에 대해 알아보려면 용량 개요를 참고하세요.
이 페이지의 샘플 사용 방법에 대한 탭을 선택하세요.
콘솔
Google Cloud 콘솔을 사용하여 Google Cloud 서비스 및 API에 액세스하는 경우 인증을 설정할 필요가 없습니다.
gcloud
Google Cloud CLI를 설치한 후 제휴 ID로 gcloud CLI에 로그인합니다. 로그인한 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다.
gcloud initREST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
Google Cloud CLI를 설치한 후 제휴 ID로 gcloud CLI에 로그인합니다.
자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.
필요한 역할
VM을 만드는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 인스턴스 관리자 (v1) (roles/compute.instanceAdmin.v1) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이 사전 정의된 역할에는 VM을 만드는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
VM을 만들려면 다음 권한이 필요합니다.
- 프로젝트에 대한
compute.instances.create권한 -
커스텀 이미지를 사용하여 VM 만들기: 이미지에 대한
compute.images.useReadOnly권한 -
스냅샷을 사용하여 VM 만들기: 스냅샷에 대한
compute.snapshots.useReadOnly권한 -
인스턴스 템플릿을 사용하여 VM 만들기: 인스턴스 템플릿에 대한
compute.instanceTemplates.useReadOnly권한 -
VM의 서브넷 지정: 프로젝트 또는 선택한 서브넷에 대한
compute.subnetworks.use권한 -
VM의 고정 IP 주소 지정: 프로젝트에 대한
compute.addresses.use권한 -
VPC 네트워크를 사용할 때 VM에 외부 IP 주소 할당: 프로젝트 또는 선택한 서브넷에 대한
compute.subnetworks.useExternalIp권한 -
VM에 레거시 네트워크 할당: 프로젝트에 대한
compute.networks.use권한 -
레거시 네트워크 사용 시 VM에 외부 IP 주소 할당: 프로젝트에 대한
compute.networks.useExternalIp권한 -
VM에 VM 인스턴스 메타데이터 설정: 프로젝트에 대한
compute.instances.setMetadata권한 -
VM에 태그 설정: VM에 대한
compute.instances.setTags권한 -
VM에 라벨 설정: VM에 대한
compute.instances.setLabels권한 -
VM에 사용할 서비스 계정 설정: VM에 대한
compute.instances.setServiceAccount권한 -
VM의 새 디스크 만들기: 프로젝트에 대한
compute.disks.create권한 -
기존 디스크를 읽기 전용 또는 읽기-쓰기 모드로 연결: 디스크에 대한
compute.disks.use권한 -
기존 디스크를 읽기 전용 모드로 연결: 디스크에 대한
compute.disks.useReadOnly권한
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
개요
A3 Edge 머신 유형으로 인스턴스를 만드는 단계는 다음과 같습니다.
VPC 네트워크 만들기
GPU VM의 효율적인 통신을 사용 설정하려면 관리 네트워크와 하나 이상의 데이터 네트워크를 만들어야 합니다. 관리 네트워크는 외부 액세스(예: SSH) 및 대부분의 일반 네트워크 통신에 사용됩니다. 데이터 네트워크는 서로 다른 VM의 GPU 간 고성능 통신에 사용됩니다(예: 원격 직접 메모리 액세스(RDMA) 트래픽).
이러한 VPC 네트워크의 경우 최대 전송 단위(MTU)를 더 큰 값으로 설정하는 것이 좋습니다. MTU 값이 클수록 패킷 크기가 증가하고 패킷 헤더 오버헤드가 줄어들어 페이로드 데이터 처리량이 증가합니다. VPC 네트워크를 만드는 방법에 관한 자세한 내용은 점보 프레임 MTU 네트워크 만들기 및 확인을 참고하세요.
관리 네트워크, 서브넷, 방화벽 규칙 만들기
다음 단계에 따라 관리 네트워크를 설정하세요.
networks create명령어를 사용하여 관리 네트워크를 만듭니다.gcloud compute networks create NETWORK_NAME_PREFIX-mgmt-net \ --project=PROJECT_ID \ --subnet-mode=custom \ --mtu=8244networks subnets create명령어를 사용하여 관리 서브넷을 만듭니다.gcloud compute networks subnets create NETWORK_NAME_PREFIX-mgmt-sub \ --project=PROJECT_ID \ --network=NETWORK_NAME_PREFIX-mgmt-net \ --region=REGION \ --range=192.168.0.0/24firewall-rules create명령어를 사용하여 방화벽 규칙을 만듭니다.관리 네트워크의 방화벽 규칙을 만듭니다.
gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-internal \ --project=PROJECT_ID \ --network=NETWORK_NAME_PREFIX-mgmt-net \ --action=ALLOW \ --rules=tcp:0-65535,udp:0-65535,icmp \ --source-ranges=192.168.0.0/16SSH를 사용하여 VM에 연결할 수 있는 소스 IP 주소를 제한하는
tcp:22방화벽 규칙을 만듭니다.gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-external-ssh \ --project=PROJECT_ID \ --network=NETWORK_NAME_PREFIX-mgmt-net \ --action=ALLOW \ --rules=tcp:22 \ --source-ranges=SSH_SOURCE_IP_RANGE네트워크에서 데이터 전송 문제를 확인하는 데 사용할 수 있는
icmp방화벽 규칙을 만듭니다.gcloud compute firewall-rules create NETWORK_NAME_PREFIX-mgmt-external-ping \ --project=PROJECT_ID \ --network=NETWORK_NAME_PREFIX-mgmt-net \ --action=ALLOW \ --rules=icmp \ --source-ranges=0.0.0.0/0
다음을 바꿉니다.
NETWORK_NAME_PREFIX: VPC 네트워크 및 서브넷에 사용할 이름 프리픽스입니다.PROJECT_ID: 프로젝트 ID입니다.REGION: 네트워크를 만들려는 리전입니다.SSH_SOURCE_IP_RANGE: CIDR 형식의 IP 범위. SSH를 사용하여 VM에 연결할 수 있는 소스 IP 주소를 지정합니다.
데이터 네트워크, 서브넷, 방화벽 규칙 만들기
A3 Edge에는 4개의 데이터 네트워크가 필요합니다. 다음 명령어를 사용하여 각각 서브넷과 방화벽 규칙이 있는 데이터 네트워크 4개를 만듭니다.
for N in $(seq 1 4); do
gcloud compute networks create NETWORK_NAME_PREFIX-data-net-$N \
--project=PROJECT_ID \
--subnet-mode=custom \
--mtu=8244
gcloud compute networks subnets create NETWORK_NAME_PREFIX-data-sub-$N \
--project=PROJECT_ID \
--network=NETWORK_NAME_PREFIX-data-net-$N \
--region=REGION \
--range=192.168.$N.0/24
gcloud compute firewall-rules create NETWORK_NAME_PREFIX-data-internal-$N \
--project=PROJECT_ID \
--network=NETWORK_NAME_PREFIX-data-net-$N \
--action=ALLOW \
--rules=tcp:0-65535,udp:0-65535,icmp \
--source-ranges=192.168.0.0/16
done
선택사항: 압축 배치 정책 만들기
압축 배치 정책을 만들어 VM 배치를 지정할 수 있습니다. VM에 압축 배치 정책을 적용하면 Compute Engine은 VM을 최대한 서로 가까운 위치에 만들기 위해 최선을 다합니다. 애플리케이션이 지연 시간에 민감하고 최대 압축이 필요한 경우 압축 배치 정책을 만들 때 maxDistance 필드(미리보기)를 지정합니다. maxDistance 값이 낮으면 VM이 더 가까운 위치에 배치되지만 일부 VM이 생성되지 않을 가능성도 높아집니다.
gcloud
압축 배치 정책을 만들려면
gcloud beta compute resource-policies create group-placement 명령어를 사용합니다.
gcloud beta compute resource-policies create group-placement POLICY_NAME \
--collocation=collocated \
--max-distance=MAX_DISTANCE \
--region=REGION
다음을 바꿉니다.
POLICY_NAME: 압축 배치 정책 이름MAX_DISTANCE: VM의 최대 거리 구성입니다. 지정(미리보기, 권장)하거나 지정하지 않을 수 있습니다 (--max-distance플래그 삭제). 머신 유형에서 지원하는 항목에 따라 다음 값 중 하나를 지정할 수 있습니다.- VM을 동일한 하위 블록에 배치하려면
1를 사용합니다. - VM을 동일한 블록에 배치하려면
2을 지정합니다. - VM을 인접한 블록에 배치하려면
3을 지정합니다.
- VM을 동일한 하위 블록에 배치하려면
REGION: 압축 배치 정책을 만들려는 리전입니다. 인스턴스를 만들려는 영역이 포함된 리전을 지정하고 사용하려는 머신 유형이 해당 리전에서 사용 가능한지 확인합니다. 리전에 대한 자세한 내용은 리전 및 영역별 GPU 가용성을 참고하세요.
REST
압축 배치 정책을 만들려면 베타 resourcePolicies.insert 메서드에 POST 요청을 수행합니다.
요청 본문에 COLLOCATED로 설정된 collocation 필드와 maxDistance 필드를 포함합니다.
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/resourcePolicies
{
"name": "POLICY_NAME",
"groupPlacementPolicy": {
"collocation": "COLLOCATED",
"maxDistance": MAX_DISTANCE
}
}
다음을 바꿉니다.
PROJECT_ID: 프로젝트 ID입니다.POLICY_NAME: 압축 배치 정책 이름MAX_DISTANCE: VM의 최대 거리 구성입니다. 지정(미리보기, 권장)하거나 지정하지 않을 수 있습니다 (maxDistance필드 삭제). 머신 유형에서 지원하는 항목에 따라 다음 값 중 하나를 지정할 수 있습니다.- VM을 동일한 하위 블록에 배치하려면
1를 사용합니다. - VM을 동일한 블록에 배치하려면
2을 지정합니다. - VM을 인접한 블록에 배치하려면
3을 지정합니다.
- VM을 동일한 하위 블록에 배치하려면
REGION: 압축 배치 정책을 만들려는 리전입니다. 인스턴스를 만들려는 영역이 포함된 리전을 지정하고 사용하려는 머신 유형이 해당 리전에서 사용 가능한지 확인합니다. 리전에 대한 자세한 내용은 리전 및 영역별 GPU 가용성을 참고하세요.
A3 Edge VM 만들기
A3 Edge VM을 만들려면 다음 방법 중 하나를 사용하세요.
다음 명령어는 인스턴스의 액세스 범위도 설정합니다. 권한 관리를 간소화하려면 인스턴스의 액세스 범위를cloud-platform 액세스로 설정한 다음 IAM 역할을 사용하여 인스턴스에서 액세스할 수 있는 서비스를 정의하는 것이 좋습니다. 자세한 내용은 범위 권장사항을 참고하세요.
콘솔
Google Cloud 콘솔에서 인스턴스 만들기 페이지로 이동합니다.
VM의 이름을 지정합니다. 리소스 이름 지정 규칙을 참조합니다.
VM을 만들려는 리전과 영역을 선택합니다. 사용 가능한 GPU 리전 및 영역 목록을 참조하세요.
GPU 탭을 클릭한 후 다음 단계를 완료합니다.
- GPU 유형 목록에서
NVIDIA H100 80GB를 선택합니다. - GPU 수 목록에서
8을 선택합니다. - 머신 유형 목록에서 a3-edgegpu-8g를 선택합니다.
- GPU 유형 목록에서
사용하려는 소비 옵션에 따라 다음 옵션 중 하나를 선택하고 다음 단계를 완료합니다.
예약
A3 Edge 인스턴스는 다음 예약 유형을 지원합니다.
- 온디맨드 예약
- 표준 미래용 예약
이러한 유형의 예약을 사용하려면 인스턴스가 표준 프로비저닝 모델을 사용해야 합니다. 예를 들어 다음 생성 매개변수를 사용합니다.
- 프로비저닝 모델 섹션의 VM 프로비저닝 모델 목록에서 표준을 선택합니다. (이 옵션은 기본적으로 선택되어 있습니다.)
이 VM에서 사용할 예약을 구성하려면 다음 단계를 완료하세요.
- 탐색 메뉴에서 고급을 클릭합니다.
예약의 경우 다음 옵션 중 하나를 선택합니다.
예약 용량을 선택적으로 사용하려면 자동 선택 사용을 선택합니다. (이 옵션은 기본적으로 선택되어 있습니다.)
인스턴스는 자동으로 사용되는 예약의 용량을 사용하려고 시도하며, 이는 일치하는 예약 용량이 있는 경우에만 발생합니다. 그렇지 않으면 인스턴스에서 주문형 용량을 사용합니다.
예약 용량을 요구하려면 예약 선택을 선택한 다음 예약 선택을 클릭하여 사용할 예약을 지정합니다.
인스턴스는 특별히 타겟팅된 예약의 용량을 사용해야 하며 주문형 용량을 사용할 수 없습니다. 예약 용량을 사용할 수 없으면 인스턴스 생성이 실패합니다.
주문형
- 프로비저닝 모델 섹션의 VM 프로비저닝 모델 목록에서 표준을 선택합니다. (이 옵션은 기본적으로 선택되어 있습니다.)
선택사항: 이 VM이 예약 사용 여부를 구성하려면 다음 단계를 완료하세요.
- 탐색 메뉴에서 고급을 클릭합니다.
예약에서 다음 옵션 중 하나를 선택합니다.
예약 용량을 선택적으로 사용하려면 자동 선택 사용을 선택합니다. (기본값)
인스턴스는 자동으로 사용되는 예약의 용량을 사용하려고 시도하며, 이는 일치하는 예약 용량이 있는 경우에만 발생합니다. 그렇지 않으면 인스턴스에서 온디맨드 용량을 사용합니다.
주문형 용량이 필요한 경우 예약 사용 안함을 선택합니다.
인스턴스가 예약 용량을 사용하지 못하도록 차단됩니다.
유연한 시작
- 프로비저닝 모델 섹션의 VM 프로비저닝 모델 목록에서 Flex-start를 선택합니다.
시간 입력 필드에 VM을 실행할 최대 시간을 입력합니다. 값은 46초 (
0.01) 이상, 7일 (168, 168시간) 이하로 지정해야 합니다.VM 생성 대기 시간 설정을 선택합니다.
워크로드의 영역 요구사항에 따라 VM 생성 요청이 성공할 확률을 높이기 위해 다음 중 하나의 기간을 지정합니다.
- 영역 요구사항이 엄격한 워크로드: 워크로드가 반드시 특정 영역에 VM을 만들어야 하는 경우 90초에서 2시간 사이의 지속 시간을 지정합니다. 지속 시간이 길수록 리소스를 확보할 확률이 높아집니다.
- 엄격한 영역 요구사항이 없는 워크로드: VM을 리전 내의 임의의 영역에서 실행할 수 있는 경우 기간을 0초로 설정하거나 VM 생성 대기 시간 설정 체크박스의 선택을 해제합니다. 이렇게 하면 Compute Engine은 리소스가 즉시 사용 가능한 경우에만 리소스를 할당합니다. 리소스를 사용할 수 없어 VM 생성 요청이 실패한 경우 다른 영역에서 요청을 다시 시도합니다.
VM 종료 시 필드에서 실행 기간이 종료될 때 VM을 중지할지 삭제할지 선택합니다.
- VM을 삭제하려면 삭제를 선택합니다.
- VM을 중지하려면 중지를 선택합니다.
스팟
- 프로비저닝 모델 섹션의 VM 프로비저닝 모델 목록에서 스팟을 선택합니다.
선택사항: Compute Engine이 VM을 선점할 때 발생하는 종료 작업을 선택하려면 다음 단계를 완료하세요.
- VM 프로비저닝 모델 고급 설정 섹션을 펼칩니다.
- VM 종료 시 목록에서 다음 옵션 중 하나를 선택합니다.
- 선점 중에 VM을 중지하려면 중지(기본값)를 선택합니다.
- 선점 중에 VM을 삭제하려면 삭제를 선택합니다.
탐색 메뉴에서 OS 및 스토리지를 클릭한 후 다음 단계를 완료합니다.
- 변경을 클릭합니다. 부팅 디스크 구성 창이 열립니다.
공개 이미지 탭에서 권장 이미지를 선택합니다. 추천 이미지 목록은 운영체제를 참조하세요.
선택사항: 부팅 디스크 크기를 구성하려면 디스크 유형에 따라 Google Cloud Hyperdisk 크기 제한 또는 Persistent Disk 크기 제한을 참고하세요.
부팅 디스크 옵션을 확인하려면 선택을 클릭합니다.
다음과 같이 서비스 계정 및 액세스 범위를 구성합니다. 인스턴스에서 실행되는 워크로드는 연결된 서비스 계정을 사용하여 다른 Google Cloud 서비스에 대한 요청을 승인합니다.
- 탐색 메뉴에서 보안을 클릭합니다.
- 서비스 계정 목록에서 사용할 서비스 계정을 선택합니다.
- 액세스 범위로 모든 Cloud API에 대한 전체 액세스 허용 옵션을 선택합니다. 이 권장사항은 서비스 계정에서 IAM 역할을 추가하거나 삭제하여 액세스를 관리할 수 있으므로 권장됩니다. 자세한 내용은 인스턴스에 서비스 계정 연결을 참고하세요.
멀티 NIC VM을 만들려면 다음 단계를 완료하세요. 그렇지 않은 경우 단일 NIC VM을 만들려면 다음 단계를 건너뛰세요.
탐색 메뉴에서 네트워킹을 클릭합니다.
네트워크 인터페이스 섹션에서 다음 단계를 완료합니다.
- 기본 네트워크 인터페이스를 삭제합니다. 인터페이스를 삭제하려면 삭제를 클릭합니다.
- 네트워크 인터페이스 추가를 클릭합니다. 이 옵션을 사용하여 이전 섹션에서 만든 VPC 네트워크에 연결되는 네트워크 인터페이스를 추가합니다. 네트워크 인터페이스를 추가할 때는 다음 사항에 유의하세요.
- 호스트 간 통신에 사용되는 네트워크 인터페이스의 경우 네트워크 및 서브네트워크 목록에서 일반 VPC 네트워크와 서브넷을 선택하고 네트워크 인터페이스 카드 목록에서 gVNIC를 선택합니다. 첫 번째 네트워크를 제외한 각 네트워크의 외부 IP 주소 목록을 없음으로 설정합니다.
- GPUDirect-TCPX를 사용하여 GPU 간 통신에 사용되는 네트워크 인터페이스의 경우 각 인터페이스에 해당하는 특수 VPC 네트워크와 서브넷을 선택하고 이러한 네트워크 인터페이스에 대해 네트워크 인터페이스 카드 목록에서 gVNIC를 선택합니다. 첫 번째 네트워크를 제외한 각 네트워크의 외부 IP 주소 목록을 없음으로 설정합니다.
만들기를 클릭하여 VM을 만들고 시작합니다.
gcloud
VM을 만들려면 gcloud compute instances create 명령어를 사용합니다.
지정해야 하는 파라미터는 이번 배포에서 사용하는 소비 옵션에 따라 달라집니다. 해당 소비 옵션에 해당하는 탭을 선택합니다.
예약
A3 Edge 인스턴스는 다음 예약 유형을 지원합니다.
- 온디맨드 예약
- 표준 미래용 예약
이러한 유형의 예약을 사용하려면 인스턴스가 표준 프로비저닝 모델을 사용해야 합니다. 예를 들어 다음 생성 매개변수를 사용합니다.
명령어를 실행하기 전에 다음 단계를 모두 검토하여 추가 플래그를 포함할지 결정하세요.
gcloud compute instances create INSTANCE_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--zone=ZONE \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--provisioning-model=STANDARD \
--maintenance-policy=TERMINATE \
--reservation-affinity=RESERVATION_AFFINITY \
--reservation=RESERVATION
다음 단계를 완료합니다.
-
다음을 바꿉니다.
INSTANCE_NAME: VM의 이름입니다.MACHINE_TYPE: VM에 사용할 머신 유형입니다. 자세한 내용은 Compute Engine 문서의 GPU 머신 유형을 참고하세요.IMAGE_FAMILY: 사용할 OS 이미지의 이미지 계열로 바꿉니다. 지원되는 모든 운영체제 목록은 지원되는 운영체제를 참고하세요. A3 Edge 머신 시리즈의 경우cos-121-lts이상의 Container-Optimized OS 이미지를 사용하고 자동 업데이트를 사용 중지하는 것이 좋습니다.IMAGE_PROJECT: OS 이미지의 프로젝트 ID로 바꿉니다. 예를 들어cos-121-lts이상의 Container-Optimized OS 이미지에는cos-cloud를 사용합니다.ZONE: 사용할 머신 유형이 제공되는 영역입니다. 압축 배치 정책을 지정하려면 압축 배치 정책과 동일한 리전의 영역을 사용합니다. 리전에 대한 자세한 내용은 리전 및 영역별 GPU 가용성을 참조하세요.DISK_TYPE: 부팅 디스크의 유형입니다. 이 머신 시리즈의 경우hyperdisk-balanced을 사용하는 것이 좋습니다. 머신 유형에 지원되는 디스크 유형에 대한 자세한 내용은 Compute Engine 문서의 가속기 최적화 머신 계열의 GPU 머신을 참고하세요.DISK_SIZE: 부팅 디스크의 크기(GB 단위). 자세한 내용은 디스크 유형에 따라 Google Cloud Hyperdisk 크기 한도 또는 Persistent Disk 크기 한도를 참고하세요.GVNIC_NAME_PREFIX: gVNIC를 사용하는 표준 VPC 네트워크 및 서브넷을 만들 때 지정한 이름 프리픽스입니다.RESERVATION_AFFINITY: 인스턴스가 사용할 수 있는 예약입니다(가능한 경우). 다음 중 하나를 지정합니다.any(예약 용량은 선택사항): 기본 옵션입니다. 인스턴스는 자동으로 사용되는 예약의 용량을 사용하려고 시도하며, 이는 일치하는 예약 용량이 있는 경우에만 발생합니다. 그렇지 않으면 인스턴스에서 주문형 용량을 사용합니다.specific(예약 용량이 필요함): 인스턴스가 특별히 타겟팅된 예약의 용량을 사용해야 합니다. 인스턴스가 주문형 용량을 사용할 수 없습니다. 예약 용량을 사용할 수 없으면 인스턴스 생성이 실패합니다.
RESERVATION: 사용할 예약입니다.RESERVATION_AFFINITY에 지정한 값에 따라 다음 중 하나를 지정합니다.any를 지정한 경우RESERVATION를 빈 문자열 ("")로 바꿉니다. 또는--reservation플래그를 완전히 삭제할 수 있습니다.specific를 지정한 경우RESERVATION를 다음으로 바꿉니다.projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
다음을 바꿉니다.
RESERVATION_OWNER_PROJECT_ID: 예약이 생성된 프로젝트의 프로젝트 ID입니다.RESERVATION_NAME: 예약 이름.
기본적으로 인스턴스가 비정상 종료되거나 Compute Engine에서 유지보수 이벤트와 같은 프로그래밍된 중지를 위해 인스턴스를 중지하는 경우 인스턴스가 자동으로 다시 시작됩니다. 자동 다시 시작을 사용 중지하려면 다음 플래그를 추가합니다.
--no-restart-on-failure
-
선택사항: 압축 배치 정책을 사용하려면 다음 플래그를 추가합니다.
--resource-policies=POLICY_NAME
다음을 바꿉니다.
POLICY_NAME: 압축 배치 정책 이름
- 명령어를 실행합니다.
주문형
명령어를 실행하기 전에 다음 단계를 모두 검토하여 추가 플래그를 포함할지 결정하세요.
gcloud compute instances create INSTANCE_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--zone=ZONE \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--provisioning-model=STANDARD \
--maintenance-policy=TERMINATE \
--reservation-affinity=RESERVATION_AFFINITY
다음 단계를 완료합니다.
-
다음을 바꿉니다.
INSTANCE_NAME: VM의 이름입니다.MACHINE_TYPE: VM에 사용할 머신 유형입니다. 자세한 내용은 Compute Engine 문서의 GPU 머신 유형을 참고하세요.IMAGE_FAMILY: 사용할 OS 이미지의 이미지 계열로 바꿉니다. 지원되는 모든 운영체제 목록은 지원되는 운영체제를 참고하세요. A3 Edge 머신 시리즈의 경우cos-121-lts이상의 Container-Optimized OS 이미지를 사용하고 자동 업데이트를 사용 중지하는 것이 좋습니다.IMAGE_PROJECT: OS 이미지의 프로젝트 ID로 바꿉니다. 예를 들어cos-121-lts이상의 Container-Optimized OS 이미지에는cos-cloud를 사용합니다.ZONE: 사용할 머신 유형이 제공되는 영역입니다. 압축 배치 정책을 지정하려면 압축 배치 정책과 동일한 리전의 영역을 사용합니다. 리전에 대한 자세한 내용은 리전 및 영역별 GPU 가용성을 참조하세요.DISK_TYPE: 부팅 디스크의 유형입니다. 이 머신 시리즈의 경우hyperdisk-balanced을 사용하는 것이 좋습니다. 머신 유형에 지원되는 디스크 유형에 대한 자세한 내용은 Compute Engine 문서의 가속기 최적화 머신 계열의 GPU 머신을 참고하세요.DISK_SIZE: 부팅 디스크의 크기(GB 단위). 자세한 내용은 디스크 유형에 따라 Google Cloud Hyperdisk 크기 한도 또는 Persistent Disk 크기 한도를 참고하세요.GVNIC_NAME_PREFIX: gVNIC를 사용하는 표준 VPC 네트워크 및 서브넷을 만들 때 지정한 이름 프리픽스입니다.RESERVATION_AFFINITY: 인스턴스가 사용할 수 있는 예약입니다(가능한 경우). 다음 중 하나를 지정합니다.any(예약 용량은 선택사항): 기본 옵션입니다. 인스턴스는 자동으로 사용되는 예약의 용량을 사용하려고 시도하며, 이는 일치하는 예약 용량이 있는 경우에만 발생합니다. 그렇지 않으면 인스턴스에서 주문형 용량을 사용합니다.none(온디맨드 용량이 필요함): 인스턴스가 예약 용량을 사용하지 못하도록 차단합니다.
기본적으로 인스턴스가 비정상 종료되거나 Compute Engine에서 유지보수 이벤트와 같은 프로그래밍된 중지를 위해 인스턴스를 중지하는 경우 인스턴스가 자동으로 다시 시작됩니다. 자동 다시 시작을 사용 중지하려면 다음 플래그를 추가합니다.
--no-restart-on-failure
-
선택사항: 압축 배치 정책을 사용하려면 다음 플래그를 추가합니다.
--resource-policies=POLICY_NAME
다음을 바꿉니다.
POLICY_NAME: 압축 배치 정책 이름
- 명령어를 실행합니다.
유연한 시작
명령어를 실행하기 전에 다음 단계를 모두 검토하여 추가 플래그를 포함할지 결정하세요.
gcloud compute instances create INSTANCE_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--zone=ZONE \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--reservation-affinity=none \
--provisioning-model=FLEX_START \
--request-valid-for-duration=REQUEST_VALID_FOR_DURATION \
--max-run-duration=MAX_RUN_DURATION \
--instance-termination-action=TERMINATION_ACTION \
--maintenance-policy=TERMINATE
다음 단계를 완료합니다.
-
다음을 바꿉니다.
INSTANCE_NAME: VM의 이름입니다.MACHINE_TYPE: VM에 사용할 머신 유형입니다. 자세한 내용은 Compute Engine 문서의 GPU 머신 유형을 참고하세요.IMAGE_FAMILY: 사용할 OS 이미지의 이미지 계열로 바꿉니다. 지원되는 모든 운영체제 목록은 지원되는 운영체제를 참고하세요. A3 Edge 머신 시리즈의 경우cos-121-lts이상의 Container-Optimized OS 이미지를 사용하고 자동 업데이트를 사용 중지하는 것이 좋습니다.IMAGE_PROJECT: OS 이미지의 프로젝트 ID로 바꿉니다. 예를 들어cos-121-lts이상의 Container-Optimized OS 이미지에는cos-cloud를 사용합니다.ZONE: 사용할 머신 유형이 제공되는 영역입니다. 압축 배치 정책을 지정하려면 압축 배치 정책과 동일한 리전의 영역을 사용합니다. 리전에 대한 자세한 내용은 리전 및 영역별 GPU 가용성을 참조하세요.DISK_TYPE: 부팅 디스크의 유형입니다. 이 머신 시리즈의 경우hyperdisk-balanced을 사용하는 것이 좋습니다. 머신 유형에 지원되는 디스크 유형에 대한 자세한 내용은 Compute Engine 문서의 가속기 최적화 머신 계열의 GPU 머신을 참고하세요.DISK_SIZE: 부팅 디스크의 크기(GB 단위). 자세한 내용은 디스크 유형에 따라 Google Cloud Hyperdisk 크기 한도 또는 Persistent Disk 크기 한도를 참고하세요.GVNIC_NAME_PREFIX: gVNIC를 사용하는 표준 VPC 네트워크 및 서브넷을 만들 때 지정한 이름 프리픽스입니다.REQUEST_VALID_FOR_DURATION: VM 생성 요청이 유효한 기간입니다. 값은d,h,m,s단위를 조합하여 일, 시, 분, 초 순서로 값 형식을 지정해야 합니다. 예를 들어 30분의 경우30m을, 1시간 2분 3초의 경우1h2m3s를 지정합니다.워크로드의 영역 요구사항에 따라 VM 생성 요청이 성공할 확률을 높이기 위해 다음 중 하나의 기간을 지정합니다.
- 영역 요구사항이 엄격한 워크로드: 워크로드가 반드시 특정 영역에 VM을 만들어야 하는 경우 90초 (
90s)에서 2시간 (2h) 사이의 지속 시간을 지정합니다. 지속 시간이 길수록 리소스를 확보할 확률이 높아집니다. - 엄격한 영역 요구사항이 없는 워크로드: VM을 리전 내의 임의의 영역에서 실행할 수 있는 경우 기간을 0초(
0s)로 지정합니다. 이렇게 하면 Compute Engine은 리소스가 즉시 사용 가능한 경우에만 리소스를 할당합니다. 리소스를 사용할 수 없어 VM 생성 요청이 실패한 경우 다른 영역에서 요청을 다시 시도합니다.
- 영역 요구사항이 엄격한 워크로드: 워크로드가 반드시 특정 영역에 VM을 만들어야 하는 경우 90초 (
MAX_RUN_DURATION: 요청된 VM을 실행할 기간입니다. 값은d,h,m,s단위를 조합하여 일, 시, 분, 초 순서로 값 형식을 지정해야 합니다. 값은 10분~7일 사이여야 합니다.TERMINATION_ACTION: 실행 기간이 끝났을 때 Compute Engine이 VM을 중지(STOP)하거나 삭제 (DELETE)하는지 여부입니다.
-
선택사항: 압축 배치 정책을 사용하려면 다음 플래그를 추가합니다.
--resource-policies=POLICY_NAME
다음을 바꿉니다.
POLICY_NAME: 압축 배치 정책 이름
- 명령어를 실행합니다.
스팟
명령어를 실행하기 전에 다음 단계를 모두 검토하여 추가 플래그를 포함할지 결정하세요.
gcloud compute instances create INSTANCE_NAME \
--machine-type=MACHINE_TYPE \
--image-family=IMAGE_FAMILY \
--image-project=IMAGE_PROJECT \
--zone=ZONE \
--boot-disk-type=DISK_TYPE \
--boot-disk-size=DISK_SIZE \
--scopes=cloud-platform \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-0,subnet=GVNIC_NAME_PREFIX-sub-0 \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-1,subnet=GVNIC_NAME_PREFIX-sub-1,no-address
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-2,subnet=GVNIC_NAME_PREFIX-sub-2,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-3,subnet=GVNIC_NAME_PREFIX-sub-3,no-address \
--network-interface=nic-type=GVNIC,network=GVNIC_NAME_PREFIX-net-4,subnet=GVNIC_NAME_PREFIX-sub-4,no-address \
--provisioning-model=SPOT \
--instance-termination-action=TERMINATION_ACTION \
--maintenance-policy=TERMINATE \
--no-restart-on-failure
다음 단계를 완료합니다.
-
다음을 바꿉니다.
INSTANCE_NAME: VM의 이름입니다.MACHINE_TYPE: VM에 사용할 머신 유형입니다. 자세한 내용은 Compute Engine 문서의 GPU 머신 유형을 참고하세요.IMAGE_FAMILY: 사용할 OS 이미지의 이미지 계열로 바꿉니다. 지원되는 모든 운영체제 목록은 지원되는 운영체제를 참고하세요. A3 Edge 머신 시리즈의 경우cos-121-lts이상의 Container-Optimized OS 이미지를 사용하고 자동 업데이트를 사용 중지하는 것이 좋습니다.IMAGE_PROJECT: OS 이미지의 프로젝트 ID로 바꿉니다. 예를 들어cos-121-lts이상의 Container-Optimized OS 이미지에는cos-cloud를 사용합니다.ZONE: 사용할 머신 유형이 제공되는 영역입니다. 압축 배치 정책을 지정하려면 압축 배치 정책과 동일한 리전의 영역을 사용합니다. 리전에 대한 자세한 내용은 리전 및 영역별 GPU 가용성을 참조하세요.DISK_TYPE: 부팅 디스크의 유형입니다. 이 머신 시리즈의 경우hyperdisk-balanced을 사용하는 것이 좋습니다. 머신 유형에 지원되는 디스크 유형에 대한 자세한 내용은 Compute Engine 문서의 가속기 최적화 머신 계열의 GPU 머신을 참고하세요.DISK_SIZE: 부팅 디스크의 크기(GB 단위). 자세한 내용은 디스크 유형에 따라 Google Cloud Hyperdisk 크기 한도 또는 Persistent Disk 크기 한도를 참고하세요.GVNIC_NAME_PREFIX: gVNIC를 사용하는 표준 VPC 네트워크 및 서브넷을 만들 때 지정한 이름 프리픽스입니다.TERMINATION_ACTION: Compute Engine에서 인스턴스를 선점할 때 수행할 작업(STOP(기본값) 또는DELETE)으로 바꿉니다.
-
선택사항: 압축 배치 정책을 사용하려면 다음 플래그를 추가합니다.
--resource-policies=POLICY_NAME
다음을 바꿉니다.
POLICY_NAME: 압축 배치 정책 이름
- 명령어를 실행합니다.
REST
VM을 만들려면 POST 요청을 instances.insert 메서드에 보냅니다.
지정해야 하는 파라미터는 이번 배포에서 사용하는 소비 옵션에 따라 달라집니다. 해당 소비 옵션에 해당하는 탭을 선택합니다.
예약
A3 Edge 인스턴스는 다음 예약 유형을 지원합니다.
- 온디맨드 예약
- 표준 미래용 예약
이러한 유형의 예약을 사용하려면 인스턴스가 표준 프로비저닝 모델을 사용해야 합니다. 예를 들어 다음 생성 매개변수를 사용합니다.
요청을 제출하기 전에 다음 단계를 모두 검토하여 추가 필드를 포함할지 결정하세요.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
"name": "INSTANCE_NAME",
"disks": [
{
"boot": true,
"initializeParams": {
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
},
"scheduling": {
"provisioningModel": "STANDARD",
"onHostMaintenance": "TERMINATE",
"automaticRestart": AUTOMATIC_RESTART
},
"reservationAffinity": {
"consumeReservationType": "RESERVATION_AFFINITY",
"key": "compute.googleapis.com/reservation-name",
"values": [
"RESERVATION"
]
}
}
다음 단계를 완료합니다.
-
다음을 바꿉니다.
PROJECT_ID: VM을 만들 프로젝트의 프로젝트 ID로 바꿉니다.ZONE: 사용할 머신 유형이 제공되는 영역입니다. 압축 배치 정책을 지정하려면 압축 배치 정책과 동일한 리전의 영역을 사용해야 합니다. 리전에 대한 자세한 내용은 리전 및 영역별 GPU 가용성을 참조하세요.MACHINE_TYPE: VM에 사용할 머신 유형입니다. 자세한 내용은 Compute Engine 문서의 GPU 머신 유형을 참고하세요.INSTANCE_NAME: VM의 이름입니다.DISK_SIZE: 부팅 디스크의 크기(GB 단위). 자세한 내용은 디스크 유형에 따라 Google Cloud Hyperdisk 크기 한도 또는 Persistent Disk 크기 한도를 참고하세요.DISK_TYPE: 부팅 디스크의 유형입니다. 이 머신 시리즈의 경우hyperdisk-balanced을 사용하는 것이 좋습니다. 머신 유형에 지원되는 디스크 유형에 대한 자세한 내용은 Compute Engine 문서의 가속기 최적화 머신 계열의 GPU 머신을 참고하세요.IMAGE_PROJECT: OS 이미지의 프로젝트 ID로 바꿉니다.IMAGE_FAMILY: 사용할 OS 이미지의 이미지 계열로 바꿉니다. 지원되는 모든 운영체제 목록은 지원되는 운영체제를 참고하세요. A3 Edge 머신 시리즈의 경우cos-121-lts이상의 Container-Optimized OS 이미지를 사용하고 자동 업데이트를 사용 중지하는 것이 좋습니다.NETWORK_PROJECT_ID: 네트워크의 프로젝트 ID로 바꿉니다.GVNIC_NAME_PREFIX: gVNIC를 사용하는 표준 VPC 네트워크 및 서브넷을 만들 때 지정한 이름 프리픽스입니다.REGION: 서브네트워크 리전으로 바꿉니다.AUTOMATIC_RESTART: 인스턴스가 비정상 종료되거나 Compute Engine에서 유지보수 이벤트와 같은 프로그래밍된 중지를 위해 인스턴스를 중지하는 경우 인스턴스가 자동으로 다시 시작되는지 여부입니다. 자동 다시 시작을 사용 설정하려면true을 지정하고 (기본값) 자동 다시 시작을 사용 중지하려면false을 지정합니다.RESERVATION_AFFINITY: 인스턴스가 사용할 수 있는 예약입니다(가능한 경우). 다음 중 하나를 지정합니다.ANY_RESERVATION(예약 용량은 선택사항): 기본 옵션입니다. 인스턴스는 자동으로 사용되는 예약의 용량을 사용하려고 시도하며, 이는 일치하는 예약 용량이 있는 경우에만 발생합니다. 그렇지 않으면 인스턴스에서 주문형 용량을 사용합니다.SPECIFIC_RESERVATION(예약 용량이 필요함): 인스턴스가 특별히 타겟팅된 예약의 용량을 사용해야 합니다. 인스턴스가 주문형 용량을 사용할 수 없습니다. 예약 용량을 사용할 수 없으면 인스턴스 생성이 실패합니다.
RESERVATION: 사용할 예약입니다.RESERVATION_AFFINITY에 지정한 값에 따라 다음 중 하나를 지정합니다.ANY_RESERVATION를 지정한 경우 값이 빈 문자열 ("")이 되도록RESERVATION를 삭제합니다. 또는key및values필드를 완전히 삭제할 수 있습니다.SPECIFIC_RESERVATION를 지정한 경우RESERVATION를 다음으로 바꿉니다.projects/RESERVATION_OWNER_PROJECT_ID/reservations/RESERVATION_NAME
다음을 바꿉니다.
RESERVATION_OWNER_PROJECT_ID: 예약이 생성된 프로젝트의 프로젝트 ID입니다.RESERVATION_NAME: 예약 이름.
-
선택사항: 압축 배치 정책을 사용하기로 한 경우 요청 본문에 다음 필드를 추가합니다.
"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]다음을 바꿉니다.
PROJECT_ID: 압축 배치 정책의 프로젝트 ID입니다.REGION: 압축 배치 정책 리전POLICY_NAME: 압축 배치 정책 이름
- 요청을 제출합니다.
주문형
요청을 제출하기 전에 다음 단계를 모두 검토하여 추가 필드를 포함할지 결정하세요.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
"name": "INSTANCE_NAME",
"disks": [
{
"boot": true,
"initializeParams": {
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
},
"scheduling": {
"provisioningModel": "STANDARD",
"onHostMaintenance": "TERMINATE",
"automaticRestart": AUTOMATIC_RESTART
},
"reservationAffinity": {
"consumeReservationType": "RESERVATION_AFFINITY"
}
}
다음 단계를 완료합니다.
-
다음을 바꿉니다.
PROJECT_ID: VM을 만들 프로젝트의 프로젝트 ID로 바꿉니다.ZONE: 사용할 머신 유형이 제공되는 영역입니다. 압축 배치 정책을 지정하려면 압축 배치 정책과 동일한 리전의 영역을 사용해야 합니다. 리전에 대한 자세한 내용은 리전 및 영역별 GPU 가용성을 참조하세요.MACHINE_TYPE: VM에 사용할 머신 유형입니다. 자세한 내용은 Compute Engine 문서의 GPU 머신 유형을 참고하세요.INSTANCE_NAME: VM의 이름입니다.DISK_SIZE: 부팅 디스크의 크기(GB 단위). 자세한 내용은 디스크 유형에 따라 Google Cloud Hyperdisk 크기 한도 또는 Persistent Disk 크기 한도를 참고하세요.DISK_TYPE: 부팅 디스크의 유형입니다. 이 머신 시리즈의 경우hyperdisk-balanced을 사용하는 것이 좋습니다. 머신 유형에 지원되는 디스크 유형에 대한 자세한 내용은 Compute Engine 문서의 가속기 최적화 머신 계열의 GPU 머신을 참고하세요.IMAGE_PROJECT: OS 이미지의 프로젝트 ID로 바꿉니다.IMAGE_FAMILY: 사용할 OS 이미지의 이미지 계열로 바꿉니다. 지원되는 모든 운영체제 목록은 지원되는 운영체제를 참고하세요. A3 Edge 머신 시리즈의 경우cos-121-lts이상의 Container-Optimized OS 이미지를 사용하고 자동 업데이트를 사용 중지하는 것이 좋습니다.NETWORK_PROJECT_ID: 네트워크의 프로젝트 ID로 바꿉니다.GVNIC_NAME_PREFIX: gVNIC를 사용하는 표준 VPC 네트워크 및 서브넷을 만들 때 지정한 이름 프리픽스입니다.REGION: 서브네트워크 리전으로 바꿉니다.AUTOMATIC_RESTART: 인스턴스가 비정상 종료되거나 Compute Engine에서 유지보수 이벤트와 같은 프로그래밍된 중지를 위해 인스턴스를 중지하는 경우 인스턴스가 자동으로 다시 시작되는지 여부입니다. 자동 다시 시작을 사용 설정하려면true을 지정하고 (기본값) 자동 다시 시작을 사용 중지하려면false을 지정합니다.RESERVATION_AFFINITY: 인스턴스가 사용할 수 있는 예약입니다(가능한 경우). 다음 중 하나를 지정합니다.ANY_RESERVATION(예약 용량은 선택사항): 기본 옵션입니다. 인스턴스는 자동으로 사용되는 예약의 용량을 사용하려고 시도하며, 이는 일치하는 예약 용량이 있는 경우에만 발생합니다. 그렇지 않으면 인스턴스에서 주문형 용량을 사용합니다.NO_RESERVATION(온디맨드 용량이 필요함): 인스턴스가 예약 용량을 사용하지 못하도록 차단합니다.
-
선택사항: 압축 배치 정책을 사용하기로 한 경우 요청 본문에 다음 필드를 추가합니다.
"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]다음을 바꿉니다.
PROJECT_ID: 압축 배치 정책의 프로젝트 ID입니다.REGION: 압축 배치 정책 리전POLICY_NAME: 압축 배치 정책 이름
- 요청을 제출합니다.
유연한 시작
요청을 제출하기 전에 다음 단계를 모두 검토하여 추가 필드를 포함할지 결정하세요.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
"name": "INSTANCE_NAME",
"disks": [
{
"boot": true,
"initializeParams": {
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
},
"reservationAffinity": {
"consumeReservationType": "NO_RESERVATION",
},
"scheduling": {
"provisioningModel": "FLEX_START",
"requestValidForDuration": {
"seconds": REQUEST_VALID_FOR_DURATION
},
"maxRunDuration": {
"seconds": MAX_RUN_DURATION
},
"instanceTerminationAction": "TERMINATION_ACTION",
"onHostMaintenance": "TERMINATE",
}
}
다음 단계를 완료합니다.
-
다음을 바꿉니다.
PROJECT_ID: VM을 만들 프로젝트의 프로젝트 ID로 바꿉니다.ZONE: 사용할 머신 유형이 제공되는 영역입니다. 압축 배치 정책을 지정하려면 압축 배치 정책과 동일한 리전의 영역을 사용해야 합니다. 리전에 대한 자세한 내용은 리전 및 영역별 GPU 가용성을 참조하세요.MACHINE_TYPE: VM에 사용할 머신 유형입니다. 자세한 내용은 Compute Engine 문서의 GPU 머신 유형을 참고하세요.INSTANCE_NAME: VM의 이름입니다.DISK_SIZE: 부팅 디스크의 크기(GB 단위). 자세한 내용은 디스크 유형에 따라 Google Cloud Hyperdisk 크기 한도 또는 Persistent Disk 크기 한도를 참고하세요.DISK_TYPE: 부팅 디스크의 유형입니다. 이 머신 시리즈의 경우hyperdisk-balanced을 사용하는 것이 좋습니다. 머신 유형에 지원되는 디스크 유형에 대한 자세한 내용은 Compute Engine 문서의 가속기 최적화 머신 계열의 GPU 머신을 참고하세요.IMAGE_PROJECT: OS 이미지의 프로젝트 ID로 바꿉니다.IMAGE_FAMILY: 사용할 OS 이미지의 이미지 계열로 바꿉니다. 지원되는 모든 운영체제 목록은 지원되는 운영체제를 참고하세요. A3 Edge 머신 시리즈의 경우cos-121-lts이상의 Container-Optimized OS 이미지를 사용하고 자동 업데이트를 사용 중지하는 것이 좋습니다.NETWORK_PROJECT_ID: 네트워크의 프로젝트 ID로 바꿉니다.GVNIC_NAME_PREFIX: gVNIC를 사용하는 표준 VPC 네트워크 및 서브넷을 만들 때 지정한 이름 프리픽스입니다.REGION: 서브네트워크 리전으로 바꿉니다.REQUEST_VALID_FOR_DURATION: VM 생성 요청이 유효한 기간(초)입니다.워크로드의 영역 요구사항에 따라 VM 생성 요청이 성공할 확률을 높이기 위해 다음 중 하나의 기간을 지정합니다.
- 영역 요구사항이 엄격한 워크로드: 워크로드가 반드시 특정 영역에 VM을 만들어야 하는 경우 90초 (
90)에서 2시간 (7200) 사이의 지속 시간을 지정합니다. 지속 시간이 길수록 리소스를 확보할 확률이 높아집니다. - 엄격한 영역 요구사항이 없는 워크로드: VM을 리전 내의 임의의 영역에서 실행할 수 있는 경우 기간을 0초(
0)로 지정합니다. 이렇게 하면 Compute Engine은 리소스가 즉시 사용 가능한 경우에만 리소스를 할당합니다. 리소스를 사용할 수 없어 VM 생성 요청이 실패한 경우 다른 영역에서 요청을 다시 시도합니다.
- 영역 요구사항이 엄격한 워크로드: 워크로드가 반드시 특정 영역에 VM을 만들어야 하는 경우 90초 (
MAX_RUN_DURATION: 요청된 VM을 실행할 기간입니다. 값은 초 단위 숫자로 지정해야 합니다. 예를 들어 86,400초 (24시간)의 경우86400을 지정합니다. 값은 10분~7일 사이여야 합니다.TERMINATION_ACTION: 실행 기간이 끝났을 때 Compute Engine이 VM을 중지(STOP)하거나 삭제 (DELETE)하는지 여부입니다.
-
선택사항: 압축 배치 정책을 사용하기로 한 경우 요청 본문에 다음 필드를 추가합니다.
"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]다음을 바꿉니다.
PROJECT_ID: 압축 배치 정책의 프로젝트 ID입니다.REGION: 압축 배치 정책 리전POLICY_NAME: 압축 배치 정책 이름
- 요청을 제출합니다.
스팟
요청을 제출하기 전에 다음 단계를 모두 검토하여 추가 필드를 포함할지 결정하세요.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
"machineType": "projects/PROJECT_ID/zones/ZONE/machineTypes/MACHINE_TYPE",
"name": "INSTANCE_NAME",
"disks": [
{
"boot": true,
"initializeParams": {
"diskSizeGb": "DISK_SIZE",
"diskType": "DISK_TYPE",
"sourceImage": "projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
},
"mode": "READ_WRITE",
"type": "PERSISTENT"
}
],
"serviceAccounts": [
{
"email": "default",
"scopes": [
"https://www.googleapis.com/auth/cloud-platform"
]
}
],
"networkInterfaces": [
{
"accessConfigs": [
{
"name": "external-nat",
"type": "ONE_TO_ONE_NAT"
}
],
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-0",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-0"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-1",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-1"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-2",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-2"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-3",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-3"
},
{
"network": "projects/NETWORK_PROJECT_ID/global/networks/GVNIC_NAME_PREFIX-net-4",
"nicType": "GVNIC",
"subnetwork": "projects/NETWORK_PROJECT_ID/region/REGION/subnetworks/GVNIC_NAME_PREFIX-sub-4"
},
"scheduling":
{
"provisioningModel": "SPOT",
"instanceTerminationAction": "TERMINATION_ACTION",
"onHostMaintenance": "TERMINATE",
"automaticRestart": false
}
}
다음 단계를 완료합니다.
-
다음을 바꿉니다.
PROJECT_ID: VM을 만들 프로젝트의 프로젝트 ID로 바꿉니다.ZONE: 사용할 머신 유형이 제공되는 영역입니다. 압축 배치 정책을 지정하려면 압축 배치 정책과 동일한 리전의 영역을 사용해야 합니다. 리전에 대한 자세한 내용은 리전 및 영역별 GPU 가용성을 참조하세요.MACHINE_TYPE: VM에 사용할 머신 유형입니다. 자세한 내용은 Compute Engine 문서의 GPU 머신 유형을 참고하세요.INSTANCE_NAME: VM의 이름입니다.DISK_SIZE: 부팅 디스크의 크기(GB 단위). 자세한 내용은 디스크 유형에 따라 Google Cloud Hyperdisk 크기 한도 또는 Persistent Disk 크기 한도를 참고하세요.DISK_TYPE: 부팅 디스크의 유형입니다. 이 머신 시리즈의 경우hyperdisk-balanced을 사용하는 것이 좋습니다. 머신 유형에 지원되는 디스크 유형에 대한 자세한 내용은 Compute Engine 문서의 가속기 최적화 머신 계열의 GPU 머신을 참고하세요.IMAGE_PROJECT: OS 이미지의 프로젝트 ID로 바꿉니다.IMAGE_FAMILY: 사용할 OS 이미지의 이미지 계열로 바꿉니다. 지원되는 모든 운영체제 목록은 지원되는 운영체제를 참고하세요. A3 Edge 머신 시리즈의 경우cos-121-lts이상의 Container-Optimized OS 이미지를 사용하고 자동 업데이트를 사용 중지하는 것이 좋습니다.NETWORK_PROJECT_ID: 네트워크의 프로젝트 ID로 바꿉니다.GVNIC_NAME_PREFIX: gVNIC를 사용하는 표준 VPC 네트워크 및 서브넷을 만들 때 지정한 이름 프리픽스입니다.REGION: 서브네트워크 리전으로 바꿉니다.TERMINATION_ACTION: Compute Engine에서 인스턴스를 선점할 때 수행할 작업(STOP(기본값) 또는DELETE)으로 바꿉니다.
-
선택사항: 압축 배치 정책을 사용하기로 한 경우 요청 본문에 다음 필드를 추가합니다.
"resourcePolicies": [ "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]다음을 바꿉니다.
PROJECT_ID: 압축 배치 정책의 프로젝트 ID입니다.REGION: 압축 배치 정책 리전POLICY_NAME: 압축 배치 정책 이름
- 요청을 제출합니다.
GPU 드라이버 설치
인스턴스를 만든 후 올바른 GPU 드라이버가 이미 설치되어 있지 않으면 인스턴스에서 GPU를 사용할 수 없습니다. GPU 드라이버가 포함된 OS 이미지를 지정하지 않은 경우 Compute Engine 문서의 GPU 드라이버 설치를 참고하세요.