VM 인스턴스 생성 및 시작

이 페이지에서는 부팅 디스크 이미지 또는 부팅 디스크 스냅샷을 사용하여 가상 머신 (VM) 인스턴스를 만드는 방법을 설명합니다.

하나 이상의 디스크가 있는 VM을 만들 수 있습니다. 생성 후 VM에 디스크를 추가할 수도 있습니다. Google Distributed Cloud (GDC) 에어 갭은 생성 후 VM 인스턴스를 자동으로 시작합니다.

생성 전후에 VM에 시작 스크립트를 추가할 수 있습니다. 시작 스크립트에 대해 자세히 알아보려면 VM 인스턴스에서 시작 스크립트 사용 페이지를 참고하세요.

시작하기 전에

gdcloud 명령줄 인터페이스 (CLI) 명령어를 사용하려면 gdcloud CLI를 다운로드, 설치, 구성해야 합니다. Distributed Cloud의 모든 명령어는 gdcloud 또는 kubectl CLI를 사용하며 운영체제 (OS) 환경이 필요합니다.

kubeconfig 파일 경로 가져오기

관리 API 서버에 대해 명령어를 실행하려면 다음 리소스가 있어야 합니다.

1. 관리 API 서버의 kubeconfig 파일이 없는 경우 로그인 및 생성합니다.

2. 관리 API 서버의 kubeconfig 파일 경로를 사용하여 이 안내의 MANAGEMENT_API_SERVER를 바꿉니다.

중요: VM 이름에는 영숫자 문자와 대시만 포함해야 합니다. 영숫자 문자와 대시 이외의 기호(예: 마침표)를 사용하면 VM에 연결할 수 없습니다. VM 이름은 53자(영문 기준) 이하여야 합니다.

권한 및 액세스 요청

이 페이지에 나열된 작업을 수행하려면 프로젝트 VirtualMachine 관리자 역할이 있어야 합니다. 단계를 따라 VM이 있는 프로젝트의 네임스페이스에 프로젝트 VirtualMachine 관리자 (project-vm-admin) 역할이 있는지 확인합니다.

GDC 콘솔 또는 gdcloud CLI를 사용하는 VM 작업의 경우 프로젝트 IAM 관리자에게 프로젝트 VirtualMachine 관리자 역할과 프로젝트 뷰어 (project-viewer) 역할을 모두 할당해 달라고 요청하세요.

이미지에서 VM 인스턴스 만들기

이 섹션에서는 GDC 제공 OS 이미지 또는 커스텀 OS 이미지에서 VM을 만드는 방법을 보여줍니다.

사용 가능한 GDC 제공 이미지 목록 보기

GDC 제공 이미지를 사용하여 VM을 만들기 전에 사용 가능한 이미지 목록을 검토하세요. GDC에서 제공하는 이미지에 대한 자세한 내용은 지원되는 VM 이미지를 참고하세요.

gdcloud

• 사용 가능한 모든 이미지와 최소 디스크 크기를 나열합니다.

  gdcloud compute images list
  

  이 명령어에는 GDC 제공 이미지와 맞춤 이미지가 모두 포함됩니다. vm-system 네임스페이스에서 이미지를 선택합니다.

API

1. 사용 가능한 모든 GDC 제공 이미지를 나열합니다.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
   get virtualmachineimage.virtualmachine.gdc.goog --namespace vm-system
   

2. 특정 GDC 제공 이미지의 minimumDiskSize를 가져옵니다.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
       get virtualmachineimage.virtualmachine.gdc.goog --namespace vm-system \
       BOOT_DISK_IMAGE_NAME -ojsonpath='{.spec.minimumDiskSize}{"\n"}'
   

   다음을 바꿉니다.

   • MANAGEMENT_API_SERVER: 관리 API 서버의 kubeconfig 파일입니다.
   • BOOT_DISK_IMAGE_NAME: 이미지 이름입니다.

GDC 제공 이미지에서 VM 인스턴스 만들기

기본적으로 모든 GDC 프로젝트는 GDC에서 제공하는 OS 이미지에서 VM을 만들 수 있습니다.

gdcloud

1. GDC에서 제공하는 이미지를 선택하여 VM 인스턴스를 만듭니다.

   gdcloud compute instances create VM_NAME \
       --machine-type=MACHINE_TYPE \
       --image=BOOT_DISK_IMAGE_NAME --image-project=vm-system \
       --boot-disk-size=BOOT_DISK_SIZE \
       --no-boot-disk-auto-delete=NO_BOOT_DISK_AUTO_DELETE
   

   다음을 바꿉니다.

   변수	정의
   VM_NAME	새 VM의 이름입니다. 이름에는 영숫자 문자 및 대시만 포함되어야 하며 53자를 초과할 수 없습니다.
   BOOT_DISK_IMAGE_NAME	새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
   BOOT_DISK_SIZE	부팅 디스크의 크기입니다(예: 20GB). 이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
   NO_BOOT_DISK_AUTO_DELETE	true 또는 false입니다. VM 인스턴스가 삭제될 때 부팅 디스크가 자동으로 삭제되는지 여부의 역을 나타냅니다.
   MACHINE_TYPE	새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행하세요. gdcloud compute machine-types list

API

1. GDC에서 제공하는 이미지를 선택하여 VM 인스턴스를 만듭니다.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
       apply -n PROJECT -f - <<EOF
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: VM_BOOT_DISK_NAME
   spec:
     source:
       image:
         name: BOOT_DISK_IMAGE_NAME
         namespace: vm-system
     size: BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     compute:
       virtualMachineType: MACHINE_TYPE
     disks:
       - virtualMachineDiskRef:
           name: VM_BOOT_DISK_NAME
         boot: true
         autoDelete: BOOT_DISK_AUTO_DELETE
   EOF
   

   다음을 바꿉니다.

   변수	정의
   MANAGEMENT_API_SERVER	관리 API 서버 kubeconfig 파일입니다.
   PROJECT	VM을 만들 GDC 프로젝트입니다.
   VM_NAME	새 VM의 이름입니다. 이름에는 영숫자 문자 및 대시만 포함되어야 하며 53자를 초과할 수 없습니다.
   VM_BOOT_DISK_NAME	새 VM 부팅 디스크의 이름입니다.
   BOOT_DISK_IMAGE_NAME	새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
   BOOT_DISK_SIZE	부팅 디스크의 크기입니다(예: 20Gi). 이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
   BOOT_DISK_AUTO_DELETE	true 또는 false입니다. VM 인스턴스가 삭제될 때 부팅 디스크가 자동으로 삭제되는지 여부를 나타냅니다.
   MACHINE_TYPE	새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행하세요. gdcloud compute machine-types list

2. VM이 생성되었는지 확인하고 VM이 Running 상태를 표시할 때까지 기다립니다. Running 상태는 OS가 완전히 준비되어 액세스할 수 있음을 나타내지 않습니다.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
   get virtualmachine.virtualmachine.gdc.goog VM_NAME -n PROJECT
   

   VM_NAME 및 PROJECT을 VM의 이름과 프로젝트로 바꿉니다.

   VM 인스턴스 생성에 시작 스크립트를 추가하려면 VM 인스턴스에서 시작 스크립트 사용 페이지에 제공된 단계를 따르세요. 스크립트를 추가하기 전에 VM을 종료해야 합니다.

커스텀 이미지에서 VM 인스턴스 만들기

커스텀 이미지는 사용자 프로젝트에만 속합니다. 커스텀 이미지로 VM을 만들려면 먼저 동일한 프로젝트에서 커스텀 이미지를 만들어야 합니다.

gdcloud

1. 모든 맞춤 이미지 나열:

   gdcloud compute images list --no-standard-images=true
   

2. VM 인스턴스를 만듭니다.

   gdcloud compute instances create VM_NAME \
       --machine-type=MACHINE_TYPE \
       --image=BOOT_DISK_IMAGE_NAME \
       --boot-disk-size=BOOT_DISK_SIZE \
       --no-boot-disk-auto-delete=NO_BOOT_DISK_AUTO_DELETE
   

   다음을 바꿉니다.

   변수	정의
   VM_NAME	새 VM의 이름입니다. 이름에는 영숫자 문자 및 대시만 포함되어야 하며 53자를 초과할 수 없습니다.
   BOOT_DISK_IMAGE_NAME	새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
   BOOT_DISK_SIZE	부팅 디스크의 크기입니다(예: 20GB). 이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
   NO_BOOT_DISK_AUTO_DELETE	true 또는 false입니다. VM 인스턴스가 삭제될 때 부팅 디스크가 자동으로 삭제되는지 여부의 역을 나타냅니다.
   MACHINE_TYPE	새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행하세요. gdcloud compute machine-types list

API

1. 모든 맞춤 이미지 나열:

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
       get virtualmachineimage.virtualmachine.gdc.goog --namespace PROJECT
   

   특정 이미지의 minimumDiskSize를 가져와 VM 인스턴스를 만듭니다.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
       get virtualmachineimage.virtualmachine.gdc.goog --namespace PROJECT \
       BOOT_DISK_IMAGE_NAME -ojsonpath='{.spec.minimumDiskSize}{"\n"}'
   

   다음을 바꿉니다.

   변수	정의
   MANAGEMENT_API_SERVER	관리 API 서버 kubeconfig 파일입니다.
   BOOT_DISK_IMAGE_NAME	모든 맞춤 이미지 나열 명령에서 선택한 이미지의 이름입니다.
   PROJECT	이미지의 프로젝트입니다.

2. VM 인스턴스를 만듭니다.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
       apply -n PROJECT -f - <<EOF
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: VM_BOOT_DISK_NAME
   spec:
     source:
       image:
         name: BOOT_DISK_IMAGE_NAME
     size: BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     compute:
       virtualMachineType: MACHINE_TYPE
     disks:
       - virtualMachineDiskRef:
           name: VM_BOOT_DISK_NAME
         boot: true
         autoDelete: BOOT_DISK_AUTO_DELETE
   EOF
   

   다음을 바꿉니다.

   변수	정의
   MANAGEMENT_API_SERVER	관리 API 서버 kubeconfig 파일입니다.
   PROJECT	VM을 만들 GDC 프로젝트입니다.
   VM_NAME	새 VM의 이름입니다. 이름에는 영숫자 문자 및 대시만 포함되어야 하며 53자를 초과할 수 없습니다.
   VM_BOOT_DISK_NAME	새 VM 부팅 디스크의 이름입니다.
   BOOT_DISK_IMAGE_NAME	새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
   BOOT_DISK_SIZE	부팅 디스크의 크기입니다(예: 20Gi). 이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
   BOOT_DISK_AUTO_DELETE	true 또는 false입니다. VM 인스턴스가 삭제될 때 부팅 디스크가 자동으로 삭제되는지 여부를 나타냅니다.
   MACHINE_TYPE	새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행하세요. kubectl --kubeconfig MANAGEMENT_API_SERVER get virtualmachinetype.virtualmachine.gdc.goog --namespace vm-system

3. VM이 생성되었는지 확인하고 VM이 Running 상태로 표시될 때까지 기다립니다. Running 상태라고 해서 OS가 완전히 준비되고 액세스할 수 있는 것은 아닙니다.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
   get virtualmachine.virtualmachine.gdc.goog VM_NAME -n PROJECT
   

   VM_NAME 및 PROJECT을 VM의 이름과 프로젝트로 바꿉니다.

추가 비부팅 디스크가 포함된 VM 인스턴스 만들기

VM을 만들 때 비부팅 디스크를 만들 수 있습니다. 각 추가 디스크는 이미지 소스를 지정할 수도 있고 지정하지 않을 수도 있습니다. 후자는 빈 디스크를 만드는 경우입니다.

gdcloud

1. 이미지에서 디스크를 만듭니다.

   gdcloud compute disks create NON_BOOT_DISK_FROM_IMAGE \
       --size=NON_BOOT_DISK_SIZE \
       --image=NON_BOOT_DISK_IMAGE_NAME \
       --image-project=NON_BOOT_DISK_IMAGE_NAMESPACE
   

2. 빈 이미지에서 디스크를 만듭니다.

   gdcloud compute disks create NON_BOOT_BLANK_DISK \
       --size=NON_BOOT_BLANK_DISK_SIZE \
   

3. 이전 단계의 디스크로 인스턴스를 만듭니다.

   gdcloud compute instances create VM_NAME \
       --machine-type=MACHINE_TYPE \
       --image=BOOT_DISK_IMAGE_NAME --image-project=vm-system \
       --boot-disk-size=BOOT_DISK_SIZE \
       --no-boot-disk-auto-delete=NO_BOOT_DISK_AUTO_DELETE \
       --disk=name=NON_BOOT_DISK_FROM_IMAGE \
       --disk=name=NON_BOOT_BLANK_DISK
   

   다음을 바꿉니다.

   변수	정의
   VM_NAME	새 VM의 이름입니다. 이름에는 영숫자 문자 및 대시만 포함되어야 하며 53자를 초과할 수 없습니다.
   BOOT_DISK_IMAGE_NAME	새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
   BOOT_DISK_IMAGE_NAMESPACE	새 VM 부팅 디스크에 사용할 이미지의 네임스페이스입니다. GDC 제공 이미지의 경우 `vm-system` 을 사용하고, 맞춤 이미지의 경우 필드를 비워 둡니다.
   BOOT_DISK_SIZE	부팅 디스크의 크기입니다(예: 20GB). 이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
   NO_BOOT_DISK_AUTO_DELETE	true 또는 false입니다. VM 인스턴스가 삭제될 때 부팅 디스크가 자동으로 삭제되는지 여부의 역을 나타냅니다.
   MACHINE_TYPE	새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행하세요. gdcloud compute machine-types list

   추가 디스크의 경우 다음을 바꿉니다.

   • NON_BOOT_DISK_FROM_IMAGE, NON_BOOT_BLANK_DISK: 추가 디스크의 이름입니다.
   • NON_BOOT_DISK_SIZE, NON_BOOT_BLANK_DISK_SIZE: 추가 디스크의 크기입니다(예: 20GB).
   • NON_BOOT_DISK_IMAGE_NAME: 비부팅 디스크로 사용할 이미지의 이름입니다.
   • NON_BOOT_DISK_IMAGE_NAMESPACE: 비부팅 디스크로 사용할 이미지의 네임스페이스입니다. GDC 제공 이미지의 경우 vm-system를 사용하고 맞춤 이미지의 경우 필드를 비워 둡니다.

API

1. 비부팅 디스크가 있는 VM을 만듭니다.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
       apply -n PROJECT -f - <<EOF
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: NON_BOOT_DISK_FROM_IMAGE
   spec:
     source:
       image:
         name: NON_BOOT_DISK_IMAGE_NAME
         namespace: NON_BOOT_DISK_IMAGE_NAMESPACE
     size: NON_BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: NON_BOOT_BLANK_DISK
   spec:
     size: NON_BOOT_BLANK_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: VM_BOOT_DISK_NAME
   spec:
     source:
       image:
         name: BOOT_DISK_IMAGE_NAME
         namespace: BOOT_DISK_IMAGE_NAMESPACE
     size: BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     compute:
       virtualMachineType: MACHINE_TYPE
     disks:
       - virtualMachineDiskRef:
           name: VM_BOOT_DISK_NAME
         boot: true
         autoDelete: BOOT_DISK_AUTO_DELETE
       - virtualMachineDiskRef:
           name: NON_BOOT_DISK_FROM_IMAGE
       - virtualMachineDiskRef:
           name: NON_BOOT_BLANK_DISK
   EOF
   

   다음을 바꿉니다.

   변수	정의
   MANAGEMENT_API_SERVER	관리 API 서버 kubeconfig 파일입니다.
   PROJECT	VM에 만들 GDC 프로젝트입니다.
   VM_NAME	새 VM의 이름입니다. 이름에는 영숫자 문자 및 대시만 포함되어야 하며 53자를 초과할 수 없습니다.
   VM_BOOT_DISK_NAME	새 VM 부팅 디스크의 이름입니다.
   BOOT_DISK_IMAGE_NAME	새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
   BOOT_DISK_IMAGE_NAMESPACE	새 VM 부팅 디스크에 사용할 이미지의 네임스페이스입니다. GDC 제공 이미지에는 네임스페이스 vm-system를 사용하고 맞춤 이미지에는 빈 값을 사용합니다.
   BOOT_DISK_SIZE	부팅 디스크의 크기입니다(예: 20Gi). 이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
   BOOT_DISK_AUTO_DELETE	true 또는 false입니다. VM 인스턴스가 삭제될 때 부팅 디스크가 자동으로 삭제되는지 여부를 나타냅니다.
   MACHINE_TYPE	새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행하세요. kubectl --kubeconfig MANAGEMENT_API_SERVER get virtualmachinetype.virtualmachine.gdc.goog --namespace vm-system

   추가 디스크의 경우 다음을 바꿉니다.

   • NON_BOOT_DISK_FROM_IMAGE, NON_BOOT_BLANK_DISK: 추가 디스크의 이름입니다.
   • NON_BOOT_DISK_SIZE, NON_BOOT_BLANK_DISK_SIZE: 추가 디스크의 크기입니다(예: 20Gi).
   • NON_BOOT_DISK_IMAGE_NAME: 비부팅 디스크로 사용할 이미지의 이름입니다.
   • NON_BOOT_DISK_IMAGE_NAMESPACE: 비부팅 디스크로 사용할 이미지의 네임스페이스입니다. GDC 제공 이미지에는 네임스페이스 vm-system를 사용하고 맞춤 이미지에는 빈 값을 사용합니다.

   디스크를 사용하기 전에 먼저 디스크를 포맷하고 마운트하세요.

스냅샷 또는 백업에서 VM 만들기

다음 방법으로 스냅샷에서 새 VM을 만들 수 있습니다.

• VM 부팅 디스크 복원: 스냅샷으로 VM의 부팅 디스크를 백업한 경우 해당 스냅샷을 사용하여 새 VM을 만듭니다. 스냅샷 복원을 참고하세요.
  • 비부팅 디스크 복원: 스냅샷으로 비부팅 디스크를 백업한 경우 동일한 안내에 따라 VM을 만들 때 스냅샷을 새 비부팅 디스크로 복원할 수도 있습니다.

동일한 부팅 디스크로 VM을 두 개 이상 만들려면 다음 단계를 따르세요.

1. 맞춤 이미지 만들기
2. 스냅샷을 사용하지 않고 해당 이미지에서 VM을 만듭니다.

머신 유형을 사용하지 않고 VM 만들기

Distributed Cloud는 VM 인스턴스를 만들 때 사용할 수 있는 사전 정의된 머신 유형을 제공합니다. 사전 정의된 머신 유형에는 vCPU 수 및 메모리 양이 미리 설정되어 있습니다.

사전 정의된 VM이 요구사항을 충족하지 못하는 경우 커스텀 가상화된 하드웨어 설정으로 VM 인스턴스를 만드세요.

커스텀 VM은 다음과 같은 시나리오에 적합합니다.

• 사전 정의된 VM 유형에 적용할 수 없는 워크로드

• 추가 처리 능력이나 메모리가 필요하지만 다음 수준 머신 유형에서 제공되는 모든 업그레이드는 필요하지 않은 워크로드

gdcloud

1. 정의한 머신 유형으로 VM을 만듭니다.

   gdcloud compute instances create VM_NAME \
       --custom-cpu=NUM_VCPU \
       --custom-memory=MEMORY
       --image=BOOT_DISK_IMAGE_NAME --image-project=vm-system \
       --boot-disk-size=BOOT_DISK_SIZE \
       --no-boot-disk-auto-delete=NO_BOOT_DISK_AUTO_DELETE
   

   다음을 바꿉니다.

   변수	정의
   VM_NAME	새 VM의 이름입니다. 이름에는 영숫자 문자 및 대시만 포함되어야 하며 53자를 초과할 수 없습니다.
   BOOT_DISK_IMAGE_NAME	새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
   BOOT_DISK_SIZE	부팅 디스크의 크기입니다(예: 20GB). 이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
   NO_BOOT_DISK_AUTO_DELETE	true 또는 false입니다. VM 인스턴스가 삭제될 때 부팅 디스크가 자동으로 삭제되는지 여부의 역을 나타냅니다.
   NUM_VCPU	vCPU 수입니다. 지원되는 최대 vCPU 수는 192개입니다.
   MEMORY	메모리 크기입니다(예: 8G). 최대 메모리 크기는 1테라바이트 (TB)입니다.

API

1. 정의한 머신 유형으로 VM을 만듭니다.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
       apply -n PROJECT -f - <<EOF
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: VM_BOOT_DISK_NAME
   spec:
     source:
       image:
         name: BOOT_DISK_IMAGE_NAME
         namespace: vm-system
     size: BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     compute:
       vcpus: NUM_VCPU
       memory: MEMORY
     disks:
       - virtualMachineDiskRef:
           name: VM_BOOT_DISK_NAME
         boot: true
         autoDelete: BOOT_DISK_AUTO_DELETE
   EOF
   

   다음을 바꿉니다.

   변수	정의
   MANAGEMENT_API_SERVER	관리 API 서버 kubeconfig 파일입니다.
   PROJECT	VM을 만들 Distributed Cloud 프로젝트입니다.
   VM_NAME	새 VM의 이름입니다. 이름에는 영숫자 문자 및 대시만 포함되어야 하며 53자를 초과할 수 없습니다.
   VM_BOOT_DISK_NAME	새 VM 부팅 디스크의 이름입니다.
   BOOT_DISK_IMAGE_NAME	새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
   BOOT_DISK_SIZE	부팅 디스크의 크기입니다(예: 20Gi). 이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
   BOOT_DISK_AUTO_DELETE	true 또는 false입니다. VM 인스턴스가 삭제될 때 부팅 디스크가 자동으로 삭제되는지 여부를 나타냅니다.
   NUM_VCPU	vCPU 수입니다. 지원되는 최대 vCPU 수는 192개입니다.
   MEMORY	메모리 크기입니다(예: 8G). 최대 메모리 크기는 1TB입니다.

지정된 IP 주소와 서브넷으로 VM 인스턴스 만들기

기본적으로 네트워크 사양 없이 Distributed Cloud VM을 만들 수 있습니다. 이 유형의 VM은 기본 Virtual Private Cloud (VPC)에 연결되고 기본 서브넷에서 IP를 동적으로 할당합니다. 기본 구성으로 VM을 만들려면 GDC 제공 이미지로 VM 만들기를 참고하세요.

Distributed Cloud VM에 기본 IP 구성을 사용하지 않으려면 동적 또는 고정 IP 주소로 VM을 만들면 됩니다.

• 커스텀 서브넷의 동적 IP: 특정 CIDR로 서브넷을 만들고 해당 CIDR에서 동적으로 할당된 IP로 VM을 만듭니다.

• 커스텀 서브넷의 고정 IP: 특정 CIDR로 서브넷을 만들고 해당 CIDR의 고정 IP로 VM을 만듭니다.

이 섹션에서는 동적으로 할당된 주소 또는 고정 IP 주소를 사용하여 VM을 만드는 방법을 보여줍니다.

커스텀 서브넷에서 동적으로 할당된 IP로 VM 만들기

특정 CIDR에서 동적으로 할당된 IP로 VM을 만듭니다.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
       apply -n PROJECT -f - <<EOF
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: VM_BOOT_DISK_NAME
   spec:
     source:
       image:
         name: BOOT_DISK_IMAGE_NAME
         namespace: vm-system
     size: BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     compute:
       virtualMachineType: MACHINE_TYPE
     disks:
       - virtualMachineDiskRef:
           name: VM_BOOT_DISK_NAME
         boot: true
         autoDelete: BOOT_DISK_AUTO_DELETE
     network:
       interfaces:
       - subnet: SUBNET_NAME
   EOF

다음 변수를 바꿉니다.

변수	정의
MANAGEMENT_API_SERVER	관리 API 서버 kubeconfig 파일입니다.
PROJECT	VM을 만들 Distributed Cloud 프로젝트입니다.
VM_NAME	새 VM의 이름입니다. 이름은 영숫자 문자와 대시만 포함해야 하며 최대 53자(영문 기준)까지 가능합니다.
VM_BOOT_DISK_NAME	새 VM 부팅 디스크의 이름입니다.
BOOT_DISK_IMAGE_NAME	새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
BOOT_DISK_SIZE	부팅 디스크의 크기입니다(예: 20Gi). 이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
BOOT_DISK_AUTO_DELETE	true 또는 false입니다. VM 인스턴스가 삭제될 때 부팅 디스크가 자동으로 삭제되는지 여부를 나타냅니다.
MACHINE_TYPE	새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택합니다. kubectl --kubeconfig MANAGEMENT_API_SERVER get virtualmachinetype.virtualmachine.gdc.goog --namespace vm-system
SUBNET_NAME	커스텀 서브넷의 이름입니다.

서브넷에서 고정 IP가 있는 VM 만들기

커스텀 서브넷에서 고정 IP로 VM을 만듭니다.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
       apply -n PROJECT -f - <<EOF
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachineDisk
   metadata:
     name: VM_BOOT_DISK_NAME
   spec:
     source:
       image:
         name: BOOT_DISK_IMAGE_NAME
         namespace: vm-system
     size: BOOT_DISK_SIZE
   ---
   apiVersion: virtualmachine.gdc.goog/v1
   kind: VirtualMachine
   metadata:
     name: VM_NAME
   spec:
     compute:
       virtualMachineType: MACHINE_TYPE
     disks:
       - virtualMachineDiskRef:
           name: VM_BOOT_DISK_NAME
         boot: true
         autoDelete: BOOT_DISK_AUTO_DELETE
     network:
       interfaces:
       - subnet: SUBNET_NAME
         ipAddresses:
         - address: IP_ADDRESS
   EOF

다음 변수를 바꿉니다.

변수	정의
MANAGEMENT_API_SERVER	관리 API 서버 kubeconfig 파일입니다.
PROJECT	VM을 만들 Distributed Cloud 프로젝트입니다.
VM_NAME	새 VM의 이름입니다. 이름에는 영숫자 문자 및 대시만 포함되어야 하며 53자를 초과할 수 없습니다.
VM_BOOT_DISK_NAME	새 VM 부팅 디스크의 이름입니다.
BOOT_DISK_IMAGE_NAME	새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
BOOT_DISK_SIZE	부팅 디스크의 크기입니다(예: 20Gi). 이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
BOOT_DISK_AUTO_DELETE	true 또는 false입니다. VM 인스턴스가 삭제될 때 부팅 디스크가 자동으로 삭제되는지 여부를 나타냅니다.
MACHINE_TYPE	새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행하세요. kubectl --kubeconfig MANAGEMENT_API_SERVER get virtualmachinetype.virtualmachine.gdc.goog --namespace vm-system
SUBNET_NAME	커스텀 서브넷의 이름입니다.
IP_ADDRESS	IP 주소입니다. 이는 선택한 서브넷 범위 내에 있어야 합니다. ipAddresses 필드에는 하나의 IP 주소만 지정할 수 있습니다.