VM 인스턴스 생성 및 시작

부팅 디스크 이미지 또는 부팅 디스크 스냅샷을 사용하여 가상 머신 (VM) 인스턴스를 만듭니다. 하나 이상의 디스크로 VM을 만들거나 나중에 디스크를 추가할 수 있습니다. Google Distributed Cloud (GDC) 에어 갭은 VM 인스턴스를 만들 때 자동으로 시작합니다.

인스턴스를 만들기 전이나 후에 VM 인스턴스에 시작 스크립트를 추가할 수도 있습니다.

이 문서는 GDC 환경에서 VM을 만들고 관리하는 플랫폼 관리자 또는 애플리케이션 운영자 그룹의 개발자를 대상으로 합니다. 자세한 내용은 GDC 에어 갭 문서 대상을 참조하세요.

시작하기 전에

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

kubeconfig 파일 경로 가져오기

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

  1. kubeconfig 파일이 없는 경우 Management API 서버의 kubeconfig 파일을 로그인하고 생성합니다.

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

VM 이름 지정 가이드라인

VM 인스턴스를 만들 때는 다음 이름 지정 가이드라인을 참고하세요.

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

IAM 역할 요청

VM 인스턴스를 만들고 시작하는 데 필요한 권한을 얻으려면 프로젝트 IAM 관리자에게 프로젝트에 대한 다음 역할을 부여해 달라고 요청하세요.

  • 가상 머신 프로젝트 관리자 (project-vm-admin): 프로젝트 네임스페이스에서 VM을 만들고, 수정하고, 나열하고, 삭제합니다.

  • 프로젝트 뷰어 (project-viewer): 프로젝트 네임스페이스 내의 모든 리소스를 볼 수 있습니다.

  • 가상 머신 이미지 프로젝트 관리자 (project-vm-image-admin): 프로젝트 네임스페이스에서 GDC 제공 및 커스텀 VM 이미지를 만들고, 나열하고, 삭제합니다.

모든 VM 역할은 VM이 있는 프로젝트의 네임스페이스에 바인딩되어야 합니다. 단계에 따라 액세스 권한을 확인합니다.

이미지에서 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 \
      -n vm-system \
      get virtualmachineimage.virtualmachine.gdc.goog
    
  2. 특정 GDC 제공 이미지의 minimumDiskSize를 가져옵니다.

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

    다음을 바꿉니다.

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

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

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

콘솔

  1. 탐색 메뉴에서 가상 머신 > 인스턴스를 선택합니다.
  2. 인스턴스 만들기를 클릭합니다.
  3. 이름 필드에 VM 이름을 지정합니다.
  4. VM을 만들 영역을 선택합니다.
  5. 선택사항: 라벨 추가를 클릭하여 VM에 라벨을 할당합니다. 이렇게 하면 VM 인스턴스를 정리하는 데 도움이 됩니다.
  6. VM에 사용할 머신 구성을 선택합니다.
    1. 범용: 머신 유형이 워크로드 요구사항에 맞는지 확인합니다.
    2. 커스텀: 머신의 코어 수와 메모리 요구사항을 설정합니다.
  7. 다음을 클릭합니다.
  8. 외부 액세스를 사용 설정하려면 외부 액세스 허용을 선택합니다.
  9. 다음을 클릭합니다.
  10. 부팅 디스크 섹션에서 GDC는 기본 구성으로 부팅 디스크를 자동으로 추가합니다. 이 구성을 그대로 유지하거나 변경을 클릭하여 기본 구성을 수정할 수 있습니다.
    1. 디스크 세부정보 섹션에서 디스크 이름을 수정합니다.
    2. 디스크 설정 섹션에서 크기 값을 수정합니다.
    3. 소스 이미지 섹션에서 이미지 이름 메뉴를 클릭하고 이미지 중 하나를 선택합니다.
    4. 보안 부팅 설정을 선택하거나 선택 해제합니다. Windows 이미지를 사용하는 경우 보안 부팅을 사용 설정해야 합니다.
    5. 디스크 유지 또는 디스크 삭제를 선택하여 디스크 삭제 규칙을 구성합니다.
    6. 저장을 클릭합니다.
  11. 만들기를 클릭하여 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자의 영숫자 문자와 대시를 포함할 수 있습니다.
    MACHINE_TYPE 새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행합니다.
    gdcloud compute machine-types list
    BOOT_DISK_IMAGE_NAME 새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
    BOOT_DISK_SIZE 부팅 디스크의 크기입니다(예: 20GB).
    이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
    NO_BOOT_DISK_AUTO_DELETE VM 인스턴스를 삭제할 때 부팅 디스크를 유지하려면 true를 지정하고 부팅 디스크를 자동으로 삭제하려면 false를 지정합니다.

API

  1. GDC 제공 이미지를 선택하여 대상 영역에 VM 인스턴스를 만듭니다.

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT \
      apply -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_BOOT_DISK_NAME 새 VM 부팅 디스크의 이름입니다.
    BOOT_DISK_IMAGE_NAME 새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
    BOOT_DISK_SIZE 부팅 디스크의 크기입니다(예: 20Gi).
    이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
    VM_NAME 새 VM의 이름입니다. 이름에는 최대 53자의 영숫자 문자와 대시를 포함할 수 있습니다.
    MACHINE_TYPE 새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행합니다.
    kubectl --kubeconfig MANAGEMENT_API_SERVER get virtualmachinetype.virtualmachine.gdc.goog --namespace vm-system
    BOOT_DISK_AUTO_DELETE VM 인스턴스를 삭제할 때 부팅 디스크를 자동으로 삭제하려면 true를 지정하고 유지하려면 false를 지정합니다.
  2. VM이 성공적으로 생성되었는지 확인하고 VM이 Running 상태를 표시할 때까지 기다립니다. Running 상태는 OS가 완전히 준비되어 액세스할 수 있음을 나타내지 않습니다.

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

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

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

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

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

콘솔

  1. 탐색 메뉴에서 가상 머신 > 인스턴스를 선택합니다.
  2. 인스턴스 만들기를 클릭합니다.
  3. 이름 필드에 VM 이름을 지정합니다.
  4. VM을 만들 영역을 선택합니다.
  5. 선택사항: 라벨 추가를 클릭하여 VM에 라벨을 할당합니다. 이렇게 하면 VM 인스턴스를 정리하는 데 도움이 됩니다.
  6. VM에 사용할 머신 구성을 선택합니다.
    1. 범용: 머신 유형이 워크로드 요구사항에 맞는지 확인합니다.
    2. 커스텀: 머신의 코어 수와 메모리 요구사항을 설정합니다.
  7. 다음을 클릭합니다.
  8. 외부 액세스 허용 체크박스를 선택하여 VM 인스턴스에 외부 액세스를 사용 설정합니다.
  9. 다음을 클릭합니다.
  10. 부팅 디스크 섹션에서 GDC는 기본 구성으로 부팅 디스크를 자동으로 추가합니다. 이 구성을 그대로 유지하거나 변경을 클릭하여 기본 구성을 수정할 수 있습니다.

    1. 디스크 세부정보 섹션에서 디스크 이름을 수정합니다.
    2. 디스크 설정 섹션에서 크기 값을 수정합니다.
    3. 소스 이미지 섹션에서 이미지 이름 메뉴를 클릭하고 고객이 생성함 하위 텍스트가 있는 이미지 중 하나를 선택합니다.
    4. 보안 부팅 설정을 선택하거나 선택 해제합니다. Windows 이미지를 사용하는 경우 보안 부팅을 사용 설정해야 합니다.

    5. 디스크 유지 또는 디스크 삭제를 선택하여 디스크 삭제 규칙을 구성합니다.

    6. 저장을 클릭합니다.

  11. 만들기를 클릭하여 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자의 영숫자 문자와 대시를 포함할 수 있습니다.
    MACHINE_TYPE 새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행합니다.
    gdcloud compute machine-types list
    BOOT_DISK_IMAGE_NAME 새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
    BOOT_DISK_SIZE 부팅 디스크의 크기입니다(예: 20GB).
    이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
    NO_BOOT_DISK_AUTO_DELETE VM 인스턴스를 삭제할 때 부팅 디스크를 유지하려면 true를 지정하고 부팅 디스크를 자동으로 삭제하려면 false를 지정합니다.

API

  1. 모든 커스텀 이미지를 나열합니다.

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

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

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

    다음을 바꿉니다.

    변수정의
    MANAGEMENT_API_SERVER 관리 API 서버 kubeconfig 파일입니다.
    PROJECT 이미지의 프로젝트입니다.
    BOOT_DISK_IMAGE_NAME 커스텀 이미지의 이름입니다.
  2. VM 인스턴스를 만듭니다.

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT \
      apply -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_BOOT_DISK_NAME 새 VM 부팅 디스크의 이름입니다.
    BOOT_DISK_IMAGE_NAME 새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
    BOOT_DISK_SIZE 부팅 디스크의 크기입니다(예: 20Gi).
    이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
    VM_NAME 새 VM의 이름입니다. 이름에는 최대 53자의 영숫자 문자와 대시를 포함할 수 있습니다.
    MACHINE_TYPE 새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행합니다.
    kubectl --kubeconfig MANAGEMENT_API_SERVER get virtualmachinetype.virtualmachine.gdc.goog --namespace vm-system
    BOOT_DISK_AUTO_DELETE VM 인스턴스를 삭제할 때 부팅 디스크를 자동으로 삭제하려면 true를 지정하고 유지하려면 false를 지정합니다.
  3. VM이 생성되었는지 확인하고 VM이 Running 상태로 표시될 때까지 기다립니다. Running 상태라고 해서 OS가 완전히 준비되어 액세스할 수 있는 것은 아닙니다.

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

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

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

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

콘솔

  1. 탐색 메뉴에서 가상 머신 > 인스턴스를 선택합니다.
  2. 인스턴스 만들기를 클릭합니다.
  3. 이름 필드에 VM 이름을 지정합니다.
  4. VM을 만들 영역을 선택합니다.
  5. 선택사항: 라벨 추가를 클릭하여 VM에 라벨을 할당합니다. 이렇게 하면 VM 인스턴스를 정리하는 데 도움이 됩니다.
  6. VM에 사용할 머신 구성을 선택합니다.
    1. 범용: 머신 유형이 워크로드 요구사항에 맞는지 확인합니다.
    2. 커스텀: 머신의 코어 수와 메모리 요구사항을 설정합니다.
  7. 다음을 클릭합니다.
  8. 외부 액세스 허용 체크박스를 선택하여 VM 인스턴스에 외부 액세스를 사용 설정합니다.
  9. 다음을 클릭합니다.
  10. 부팅 디스크 섹션에서 GDC는 기본 구성으로 부팅 디스크를 자동으로 추가합니다. 이 구성을 그대로 유지하거나 변경을 클릭하여 기본 구성을 수정할 수 있습니다.
    1. 디스크 세부정보 섹션에서 디스크 이름을 수정합니다.
    2. 디스크 설정 섹션에서 크기 값을 수정합니다.
    3. 소스 이미지 섹션에서 이미지 이름 메뉴를 클릭하고 이미지 중 하나를 선택합니다.
    4. 보안 부팅 설정을 선택하거나 선택 해제합니다. Windows 이미지를 사용하는 경우 보안 부팅을 사용 설정해야 합니다.
    5. 디스크 유지 또는 디스크 삭제를 선택하여 디스크 삭제 규칙을 구성합니다.
    6. 저장을 클릭합니다.
  11. VM 인스턴스에 디스크를 더 추가하려면 새 디스크 추가를 선택합니다.
    1. VM 디스크에 이름을 할당합니다.
    2. 디스크 크기 및 연결 설정을 구성합니다.
    3. 저장을 클릭합니다.
  12. 만들기를 클릭하여 VM 인스턴스를 만듭니다.

gdcloud

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

    gdcloud compute disks create VM_BOOT_DISK_NAME \
      --size=BOOT_DISK_SIZE \
      --image=BOOT_DISK_IMAGE_NAME \
      --image-project=BOOT_DISK_IMAGE_NAMESPACE
    
  2. 이미지에서 추가 비부팅 디스크를 만듭니다.

    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
    
  3. 빈 비부팅 디스크를 만듭니다.

    gdcloud compute disks create NON_BOOT_BLANK_DISK \
      --size=NON_BOOT_BLANK_DISK_SIZE
    
  4. 이전 단계의 디스크로 인스턴스를 만듭니다.

    gdcloud compute instances create VM_NAME \
      --machine-type=MACHINE_TYPE \
      --disk=name=VM_BOOT_DISK_NAME,boot=true \
      --no-boot-disk-auto-delete=NO_BOOT_DISK_AUTO_DELETE \
      --disk=name=NON_BOOT_DISK_FROM_IMAGE \
      --disk=name=NON_BOOT_BLANK_DISK
    

    다음을 바꿉니다.

    변수정의
    VM_BOOT_DISK_NAME 새 VM 부팅 디스크의 이름입니다.
    BOOT_DISK_SIZE 부팅 디스크의 크기입니다(예: 20GB).
    이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
    BOOT_DISK_IMAGE_NAME 새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
    BOOT_DISK_IMAGE_NAMESPACE 새 VM 부팅 디스크에 사용할 이미지의 네임스페이스입니다. GDC 제공 이미지에는 vm-system를 사용하고 커스텀 이미지에는 필드를 비워 둡니다.
    NON_BOOT_DISK_FROM_IMAGE 이미지에서 만드는 추가 비부팅 디스크의 이름입니다.
    NON_BOOT_DISK_SIZE 추가 비부팅 디스크의 크기입니다(예: 20GB).
    NON_BOOT_DISK_IMAGE_NAME 비부팅 디스크에 사용할 이미지의 이름입니다.
    NON_BOOT_DISK_IMAGE_NAMESPACE 비부팅 디스크에 사용할 이미지의 네임스페이스입니다. GDC 제공 이미지에는 vm-system를 사용하고 커스텀 이미지에는 필드를 비워 둡니다.
    NON_BOOT_BLANK_DISK 추가 비어 있는 비부팅 디스크의 이름입니다.
    NON_BOOT_BLANK_DISK_SIZE 추가 빈 비부팅 디스크의 크기입니다(예: 20GB).
    VM_NAME 새 VM의 이름입니다. 이름에는 최대 53자의 영숫자 문자와 대시를 포함할 수 있습니다.
    MACHINE_TYPE 새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행합니다.
    gdcloud compute machine-types list
    NO_BOOT_DISK_AUTO_DELETE VM 인스턴스를 삭제할 때 부팅 디스크를 유지하려면 true를 지정하고 부팅 디스크를 자동으로 삭제하려면 false를 지정합니다.

API

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

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
      -n PROJECT \
      apply -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 프로젝트입니다.
    NON_BOOT_DISK_FROM_IMAGE 이미지에서 만드는 추가 비부팅 디스크의 이름입니다.
    NON_BOOT_DISK_IMAGE_NAME 비부팅 디스크에 사용할 이미지의 이름입니다.
    NON_BOOT_DISK_IMAGE_NAMESPACE 비부팅 디스크에 사용할 이미지의 네임스페이스입니다. GDC 제공 이미지에는 vm-system를 사용하고 커스텀 이미지에는 비워 둡니다.
    NON_BOOT_DISK_SIZE 이미지에서 만드는 추가 비부팅 디스크의 크기입니다(예: 20Gi).
    NON_BOOT_BLANK_DISK 추가 비어 있는 비부팅 디스크의 이름입니다.
    NON_BOOT_BLANK_DISK_SIZE 추가 빈 비부팅 디스크의 크기입니다(예: 20Gi).
    VM_BOOT_DISK_NAME 새 VM 부팅 디스크의 이름입니다.
    BOOT_DISK_IMAGE_NAME 새 VM 부팅 디스크에 사용할 이미지의 이름입니다.
    BOOT_DISK_IMAGE_NAMESPACE 새 VM 부팅 디스크에 사용할 이미지의 네임스페이스입니다. GDC 제공 이미지에는 네임스페이스 vm-system를 사용하고 커스텀 이미지에는 비워 둡니다.
    BOOT_DISK_SIZE 부팅 디스크의 크기입니다(예: 20Gi).
    이 값은 항상 부팅 디스크 이미지의 minimumDiskSize보다 크거나 같아야 합니다.
    VM_NAME 새 VM의 이름입니다. 이름에는 최대 53자의 영숫자 문자와 대시를 포함할 수 있습니다.
    MACHINE_TYPE 새 VM의 사전 정의된 머신 유형입니다. 사용 가능한 머신 유형을 선택하려면 다음을 실행합니다.
    kubectl --kubeconfig MANAGEMENT_API_SERVER get virtualmachinetype.virtualmachine.gdc.goog --namespace vm-system
    BOOT_DISK_AUTO_DELETE VM 인스턴스를 삭제할 때 부팅 디스크를 자동으로 삭제하려면 true를 지정하고 유지하려면 false를 지정합니다.

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

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

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

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

동일한 부팅 디스크로 VM을 두 개 이상 만들려면 다음을 수행합니다.

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

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

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

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

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

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

서브넷 만들기에 대한 자세한 내용은 GDC의 서브넷 및 IP 주소를 참조하세요.

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

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

특정 CIDR에서 동적으로 할당된 IP 주소를 사용하여 VM을 만듭니다.

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT \
     apply -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:
       - network: NETWORK_NAME
         subnet: SUBNET_NAME
   EOF

다음 변수를 바꿉니다.

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

서브넷의 고정 IP 주소로 VM 만들기

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

   kubectl --kubeconfig MANAGEMENT_API_SERVER \
     -n PROJECT \
     apply  -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:
       - network: NETWORK_NAME
         subnet: SUBNET_NAME
         ipAddresses:
         - address: IP_ADDRESS
   EOF

다음 변수를 바꿉니다.

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

다음 단계