이 문서에서는 Compute Engine을 사용하여 다음 작업을 실행하는 방법을 설명합니다.
예약된 가상 머신(VM) 인스턴스를 사용합니다.
예약 사용을 확인합니다.
예약 사용 보고서를 봅니다.
VM을 사용하는 다른 Google Cloud 제품의 예약을 사용하는 방법에 대한 자세한 내용은 다음 제품의 예약 문서를 참조하세요.
시작하기 전에
- 예약에 대해서는 요구사항 및 제한사항을 참조하세요.
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
예약 만들기: 프로젝트에 대한
compute.reservations.create
권한 -
VM 만들기:
- 프로젝트에 대한
compute.instances.create
권한 - 커스텀 이미지를 사용하여 VM 만들기: 이미지에 대한
compute.images.useReadOnly
권한 - 스냅샷을 사용하여 VM 만들기: 스냅샷에 대한
compute.snapshots.useReadOnly
권한 - 인스턴스 템플릿을 사용하여 VM 만들기: 인스턴스 템플릿에 대한
compute.instanceTemplates.useReadOnly
권한 - VM에 기존 네트워크 할당: 프로젝트에 대한
compute.networks.use
권한 - VM의 고정 IP 주소 지정: 프로젝트에 대한
compute.addresses.use
권한 - 기존 네트워크 사용 시 VM에 외부 IP 주소 할당: 프로젝트에 대한
compute.networks.useExternalIp
권한 - VM의 서브넷 지정: 프로젝트 또는 선택한 서브넷에 대한
compute.subnetworks.use
권한 - VPC 네트워크를 사용할 때 VM에 외부 IP 주소 할당: 프로젝트 또는 선택한 서브넷에 대한
compute.subnetworks.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
권한
- 프로젝트에 대한
-
인스턴스 템플릿 만들기: 프로젝트에 대한
compute.instanceTemplates.create
권한 일치하는 예약 사용—VM이 일치하는 속성이 있는 예약을 자동으로 사용할 수 있습니다(기본값).
이 옵션은 많은 수의 VM을 생성하고 삭제하며, 가능할 때마다 예약을 사용하려는 경우에 유용합니다. 이 시나리오에서는 속성이 예약과 일치하는지 여부에 관계없이 VM을 만들 수 있습니다. 일치하면 VM은 예약의 사용 순서에 따라 예약을 사용하기 시작합니다.
특정 예약 사용: VM이 특정 예약만 사용할 수 있습니다. 예약을 자동으로 사용할 수 없습니다.
이 옵션은 예를 들어 일정한 용량을 특정 이벤트의 백업으로 유지하려는 경우에 유용합니다. 이 시나리오에서는 VM 속성과 특정 예약 속성이 일치하는 경우에만 VM을 만들 수 있습니다.
예약을 전혀 사용할 수 없음: VM이 예약을 사용할 수 없습니다.
이 옵션은 예약된 리소스를 사용하지 않으려는 임시 VM을 만드는 경우 등에 유용합니다.
예약을 만들고 모든 예약을 사용하도록 구성된 예약 어피니티 속성이 있는 VM에서 이 예약의 리소스를 사용할 수 있도록 하려면(기본값) 다음 단계를 따르세요.
만들려는 예약 유형을 선택합니다.
독립형 예약을 만들려면 다음을 수행합니다.
Google Cloud console에서 예약 페이지로 이동합니다.
온디맨드 예약 탭(기본값)에서
예약 만들기를 클릭합니다.예약 만들기 페이지가 열립니다.
약정에 연결된 예약을 만들려면 다음을 수행합니다.
Google Cloud 콘솔에서 약정 사용 할인 페이지로 이동합니다.
약정 목록 페이지가 열립니다.
약정 구매를 클릭합니다.
약정 사용 할인 구매 페이지가 열립니다.
약정 속성을 지정합니다. 그런 다음 예약 섹션에서 항목 추가를 클릭합니다.
새 예약 추가 섹션이 표시됩니다.
연결된 예약이 있는 약정을 구매하는 방법에 대한 자세한 내용은 예약이 연결된 약정 구매를 참조하세요.
이름 필드에 예약 이름을 입력합니다. 이 예시에서는
reservation-01
를 입력합니다.리소스를 예약할 리전 및 영역을 선택합니다. 이 예시에서는
us-central1
을 리전으로,us-central1-a
를 영역으로 선택합니다.원하는 공유 유형을 선택합니다.
- 단일 프로젝트에 대한 예약을 만들려면 로컬을 선택합니다.
- 여러 프로젝트 간에 공유 예약을 만들려면 공유를 선택합니다. 이 예약을 다른 프로젝트와 공유하려면 프로젝트 추가를 클릭하고 현재 프로젝트의 조직에서 원하는 프로젝트를 선택합니다.
일치하는 VM에서 이 예약을 자동으로 사용할 수 있도록 하려면 VM 인스턴스와 함께 사용 섹션에서 예약 자동 사용을 선택합니다.
VM 인스턴스 수 필드에 예약할 VM 수를 입력합니다. 이 예시에서는
2
을 입력합니다.각 VM별로 예약할 리소스를 지정합니다.
- 기존 인스턴스 템플릿과 일치하는 VM을 예약하려면 인스턴스 템플릿 사용을 선택하고 목록에서 인스턴스 템플릿을 선택합니다.
- 또는 머신 유형 지정을 선택하고 다음을 지정합니다.
- 머신 계열, 시리즈, 머신 유형 필드에서 머신 계열, 시리즈, 머신 유형을 선택합니다.
- 선택사항: 최소 CPU 플랫폼 또는 GPU를 지정합니다.
- CPU 플랫폼 및 GPU 섹션을 확장하려면 확장 화살표를 클릭합니다.
- 선택사항: 최소 CPU 플랫폼을 지정하려면 CPU 플랫폼 목록에서 옵션을 선택합니다.
- 선택사항: GPU를 추가하려면 GPU 추가를 클릭합니다. 그런 다음 GPU 유형 필드와 GPU 수 필드에서 각 VM의 GPU 유형과 수를 선택합니다.
- 선택사항: 로컬 SSD를 추가합니다.
- 디스크 수 필드에서 각 VM의 로컬 SSD 수를 선택합니다.
- 인터페이스 유형 필드에서 로컬 SSD의 인터페이스를 선택합니다.
이 예시에서는 머신 유형 지정을 선택합니다. 그런 다음
General-purpose
머신 계열 및N2
시리즈에 대해n2-standard-32
머신 유형을 선택하고 최소 CPU 플랫폼Intel Cascade Lake
를 선택합니다.예약 만들기를 완료합니다.
독립형 예약을 만드는 경우 만들기를 클릭합니다.
약정에 연결된 예약을 만드는 경우 다음 안내를 따르세요.
- 이 예약의 속성 지정을 완료하려면 완료를 클릭합니다.
- 약정 및 연결된 예약 만들기를 완료하려면 구매를 클릭합니다.
동일한 프로젝트 또는 예약이 공유된 프로젝트에서 공개 예약을 타겟팅하는 VM을 만듭니다.
영역, 머신 유형(머신 계열, vCPU, 메모리), 최소 CPU 플랫폼, GPU 크기 및 유형, 로컬 SSD 인터페이스 및 크기를 포함하여 VM의 속성이
reservation-01
의 VM 속성과 일치하는지 확인합니다.VM을 만드는 방법에 대한 자세한 내용은 VM 만들기 및 시작을 참조하세요.
Google Cloud 콘솔에서 인스턴스 만들기 페이지로 이동합니다.
인스턴스 만들기 페이지가 열립니다.
VM의 이름을 지정합니다.
다음 섹션에서는 선택적인 속성을 포함하여 예약의 모든 속성과 정확하게 일치하는 구성을 선택합니다. 이 예시에서는 다음 VM 속성이
reservation-01
과 일치하는지 확인해야 합니다.- 리전:
us-central1
- 영역:
us-central1-a
- 머신 유형:
n2-standard-32
- 최소 CPU 플랫폼:
Intel Cascade Lake
- GPU: 없음
- 로컬 SSD: 없음
- 리전:
고급 옵션 섹션을 펼친 후 관리 섹션을 펼칩니다. 예약 목록에서 생성된 예약 자동 사용을 선택합니다.
만들기를 클릭하여 VM을 만듭니다.
reservation-01
공개 예약을 생성합니다.gcloud compute reservations create reservation-01 \ --vm-count=2 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --zone=us-central1-a
모든 공개 예약을 타겟팅하고 영역, 머신 유형(머신 계열, vCPU, 메모리), 최소 CPU 플랫폼, GPU 크기 및 유형, 로컬 SSD 크기 및 인터페이스를 비롯한
reservation-01
의 VM 속성과 일치하는 VM을 만듭니다.gcloud compute instances create instance-1 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --zone=us-central1-a \ --reservation-affinity=any
reservation-01
공개 예약을 생성합니다.POST https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations { "name": "reservation-01", "specificReservation": { "count": "2", "instanceProperties": { "machineType": "n2-standard-32", "minCpuPlatform": "Intel Cascade Lake", } } }
모든 공개 예약을 타겟팅하고 영역, 머신 유형(머신 계열, vCPU, 메모리), 최소 CPU 플랫폼, GPU 크기 및 유형, 로컬 SSD 크기 및 인터페이스를 비롯한
reservation-01
의 VM 속성과 일치하는 VM을 만듭니다.POST https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances { "name": "instance-1", "machineType": "zones/us-central1-a/machineTypes/n2-standard-32", "minCpuPlatform": "Intel Cascade Lake", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/debian-cloud/global/images/family/debian-12" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "ANY_RESERVATION" } }
- Google Cloud 콘솔에서 특정 예약 선택 체크박스를 선택합니다.
- gcloud CLI에
--require-specific-reservation
플래그를 포함합니다. - Compute Engine API에서
specificReservationRequired
필드를true
로 설정합니다. - Terraform에서
specific_reservation_required
필드를true
로 설정합니다. 예약을 만들고 이름으로 예약을 명시적으로 타겟팅하는 VM에서만 이 예약의 리소스를 사용할 수 있도록 하려면 다음 단계를 따르세요.
다음 옵션 중 하나를 선택합니다.
독립형 예약을 만들려면 다음을 수행합니다.
Google Cloud console에서 예약 페이지로 이동합니다.
온디맨드 예약 탭(기본값)에서
예약 만들기를 클릭합니다.예약 만들기 페이지가 열립니다.
약정에 연결된 예약을 만들려면 다음을 수행합니다.
Google Cloud 콘솔에서 약정 사용 할인 페이지로 이동합니다.
약정 구매를 클릭합니다.
약정 사용 할인 구매 페이지가 열립니다.
약정 속성을 지정합니다. 그런 다음 예약 섹션에서 항목 추가를 클릭합니다.
새 예약 추가 섹션이 표시됩니다.
연결된 예약이 있는 약정을 구매하는 방법에 대한 자세한 내용은 예약이 연결된 약정 구매를 참조하세요.
이름 필드에 예약 이름을 입력합니다. 이 예시에서는
reservation-02
를 입력합니다.리소스를 예약할 리전 및 영역을 선택합니다. 이 예시에서는
us-central1
을 리전으로,us-central1-a
를 영역으로 선택합니다.예약이 단일 프로젝트 예약임을 지정하려면 공유 유형에 로컬을 선택합니다.
이름을 통해 이 예약을 명시적으로 타겟팅하는 일치하는 VM만 이 예약을 사용할 수 있도록 하려면 VM 인스턴스와 함께 사용 섹션에서 특정 예약 선택을 선택합니다.
VM 인스턴스 수 필드에 예약할 VM 수를 입력합니다. 이 예시에서는
10
을 입력합니다.각 VM별로 예약할 리소스를 지정합니다.
- 기존 인스턴스 템플릿과 일치하는 VM을 예약하려면 인스턴스 템플릿 사용을 선택하고 목록에서 인스턴스 템플릿을 선택합니다.
- 또는 머신 유형 지정을 선택하고 다음을 지정합니다.
- 머신 계열, 시리즈, 머신 유형 필드에서 머신 계열, 시리즈, 머신 유형을 선택합니다.
- 선택사항: 최소 CPU 플랫폼 또는 GPU를 지정합니다.
- CPU 플랫폼 및 GPU 섹션을 확장하려면 확장 화살표를 클릭합니다.
- 선택사항: 최소 CPU 플랫폼을 지정하려면 CPU 플랫폼 목록에서 옵션을 선택합니다.
- 선택사항: GPU를 추가하려면 GPU 추가를 클릭합니다. 그런 다음 GPU 유형 필드와 GPU 수 필드에서 각 VM의 GPU 유형과 수를 선택합니다.
- 선택사항: 로컬 SSD를 추가합니다.
- 디스크 수 필드에서 각 VM의 로컬 SSD 수를 선택합니다.
- 인터페이스 유형 필드에서 로컬 SSD의 인터페이스를 선택합니다.
이 예시에서는 머신 유형 지정을 선택합니다. 그런 다음
General-purpose
머신 계열 및N2
시리즈에 대해n2-standard-32
머신 유형을 선택하고 최소 CPU 플랫폼Intel Cascade Lake
를 선택합니다.예약 만들기를 완료합니다.
독립형 예약을 만드는 경우 만들기를 클릭합니다.
약정에 연결된 예약을 만드는 경우 다음 안내를 따르세요.
- 이 예약의 속성 지정을 완료하려면 완료를 클릭합니다.
- 약정 및 연결된 예약 만들기를 완료하려면 구매를 클릭합니다.
동일한 프로젝트에서 이름으로 특정 예약을 타겟팅하는 VM을 만듭니다.
영역, 머신 유형(머신 계열, vCPU, 메모리), 최소 CPU 플랫폼, GPU 크기 및 유형, 로컬 SSD 인터페이스 및 크기를 포함하여 VM의 속성이 특정 예약의 VM 속성과 일치하는지 확인합니다.
VM을 만드는 방법에 대한 자세한 내용은 VM 만들기 및 시작을 참조하세요.
Google Cloud 콘솔에서 인스턴스 만들기 페이지로 이동합니다.
이름 필드에 VM의 이름을 입력합니다.
다음 섹션에서는 선택적인 속성을 포함하여 예약의 모든 속성과 정확하게 일치하는 구성을 선택합니다. 이 예시에서는 다음 VM 속성이
reservation-02
과 일치하는지 확인해야 합니다.- 리전:
us-central1
- 영역:
us-central1-a
- 머신 유형:
n2-standard-32
- 최소 CPU 플랫폼:
Intel Cascade Lake
- GPU: 없음
- 로컬 SSD: 없음
- 리전:
고급 옵션 섹션을 펼친 후 다음을 수행합니다.
관리 섹션을 펼칩니다.
예약 섹션의 애플리케이션 정책 목록에서 특정 예약 선택을 선택합니다.
VM에 사용하려는 것과 일치하는 VM 속성이 포함된 예약을 선택합니다. 이 예시에서는
reservation-02
를 선택합니다.
만들기를 클릭하여 VM을 만듭니다.
--require-specific-reservation
플래그로reservation-02
라는 예약을 생성합니다. 이렇게 예약된 리소스는 이름으로 이 예약을 명시적으로 타겟팅하는 VM에서만 사용할 수 있습니다.gcloud compute reservations create reservation-02 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --vm-count=10 \ --zone=us-central1-a \ --require-specific-reservation
--reservation-affinity
및--reservation
플래그를 사용하여 이름으로reservation-02
를 타겟팅하는 VM을 만듭니다.영역, 머신 유형(머신 계열, vCPU, 메모리), 최소 CPU 플랫폼, GPU 크기 및 유형, 로컬 SSD 인터페이스 및 크기를 포함하여 VM의 속성이 예약의 VM 속성과 일치하는지 확인합니다.
gcloud compute instances create instance-2 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --zone=us-central1-a \ --reservation-affinity=specific \ --reservation=reservation-02
specificReservationRequired
필드를true
로 설정하여reservation-02
라는 예약을 생성합니다.POST https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/reservations { "name":"reservation-02", "specificReservation":{ "count":"10", "instanceProperties":{ "machineType":"n2-standard-32", "minCpuPlatform": "Intel Cascade Lake", } }, "specificReservationRequired": true }
reservationAffinity
필드를 사용하여 이름으로reservation-02
을 타겟팅하는 VM을 생성합니다.영역, 머신 유형(머신 계열, vCPU, 메모리), 최소 CPU 플랫폼, GPU 크기 및 유형, 로컬 SSD 인터페이스 및 크기를 포함하여 VM의 속성이 예약의 VM 속성과 일치하는지 확인합니다.
POST https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances { "name": "instance-2", "machineType": "zones/us-central1-a/machineTypes/n2-standard-32", "minCpuPlatform": "Intel Cascade Lake", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/debian-clouid/global/images/family/debian-12" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "SPECIFIC_RESERVATION", "key": "compute.googleapis.com/reservation-name", "values": [ "reservation-02" ] } }
공유 예약을 만들고 이름으로 해당 예약을 명시적으로 타겟팅하는 VM에서만 이 예약의 리소스를 사용할 수 있도록 하려면 다음 단계를 따르세요.
다음 옵션 중 하나를 선택합니다.
독립형 예약을 만들려면 다음을 수행합니다.
Google Cloud console에서 예약 페이지로 이동합니다.
온디맨드 예약 탭(기본값)에서
예약 만들기를 클릭합니다.예약 만들기 페이지가 열립니다.
약정에 연결된 예약을 만들려면 다음을 수행합니다.
Google Cloud 콘솔에서 약정 사용 할인 페이지로 이동합니다.
약정 구매를 클릭합니다.
약정 사용 할인 구매 페이지가 열립니다.
약정 속성을 지정합니다. 그런 다음 예약 섹션에서 항목 추가를 클릭합니다.
새 예약 추가 섹션이 표시됩니다.
연결된 예약이 있는 약정을 구매하는 방법에 대한 자세한 내용은 예약이 연결된 약정 구매를 참조하세요.
이름 필드에 예약 이름을 입력합니다. 이 예시에서는
reservation-02
를 입력합니다.리소스를 예약할 리전 및 영역을 선택합니다. 이 예시에서는
us-central1
을 리전으로,us-central1-a
를 영역으로 선택합니다.예약을 공유 예약으로 지정하려면 공유 유형으로 공유를 선택합니다.
프로젝트 추가를 클릭하고 예약을 공유하려는 현재 프로젝트의 조직에서 프로젝트를 선택합니다.
이름을 통해 이 예약을 명시적으로 타겟팅하는 일치하는 VM만 이 예약을 사용할 수 있도록 하려면 VM 인스턴스와 함께 사용 섹션에서 특정 예약 선택을 선택합니다.
VM 인스턴스 수 필드에 예약할 VM 수를 입력합니다. 이 예시에서는
10
을 입력합니다.각 VM별로 예약할 리소스를 지정합니다.
- 기존 인스턴스 템플릿과 일치하는 VM을 예약하려면 인스턴스 템플릿 사용을 선택하고 목록에서 인스턴스 템플릿을 선택합니다.
- 또는 머신 유형 지정을 선택하고 다음을 지정합니다.
- 머신 계열, 시리즈, 머신 유형 필드에서 머신 계열, 시리즈, 머신 유형을 선택합니다.
- 선택사항: 최소 CPU 플랫폼 또는 GPU를 지정합니다.
- CPU 플랫폼 및 GPU 섹션을 확장하려면 확장 화살표를 클릭합니다.
- 선택사항: 최소 CPU 플랫폼을 지정하려면 CPU 플랫폼 목록에서 옵션을 선택합니다.
- 선택사항: GPU를 추가하려면 GPU 추가를 클릭합니다. 그런 다음 GPU 유형 필드와 GPU 수 필드에서 각 VM의 GPU 유형과 수를 선택합니다.
- 선택사항: 로컬 SSD를 추가합니다.
- 디스크 수 필드에서 각 VM의 로컬 SSD 수를 선택합니다.
- 인터페이스 유형 필드에서 로컬 SSD의 인터페이스를 선택합니다.
이 예시에서는 머신 유형 지정을 선택합니다. 그런 다음
General-purpose
머신 계열 및N2
시리즈에 대해n2-standard-32
머신 유형을 선택하고 최소 CPU 플랫폼Intel Cascade Lake
를 선택합니다. 1. 예약 만들기를 완료합니다.독립형 예약을 만드는 경우 만들기를 클릭합니다.
약정에 연결된 예약을 만드는 경우 다음 안내를 따르세요.
- 이 예약의 속성 지정을 완료하려면 완료를 클릭합니다.
- 약정 및 연결된 예약 만들기를 완료하려면 구매를 클릭합니다.
동일한 프로젝트 또는 예약이 공유된 프로젝트에서 이름으로 특정 예약을 타겟팅하는 VM을 만듭니다.
영역, 머신 유형(머신 계열, vCPU, 메모리), 최소 CPU 플랫폼, GPU 크기 및 유형, 로컬 SSD 인터페이스 및 크기를 포함하여 VM의 속성이 특정 예약의 VM 속성과 일치하는지 확인합니다.
Google Cloud 콘솔에서 인스턴스 만들기 페이지로 이동합니다.
인스턴스 만들기 페이지가 열립니다.
VM의 이름을 지정합니다.
다음 섹션에서는 선택적인 속성을 포함하여 예약의 모든 속성과 정확하게 일치하는 구성을 선택합니다. 이 예시에서는 다음 VM 속성이
reservation-02
과 일치하는지 확인해야 합니다.- 리전:
us-central1
- 영역:
us-central1-a
- 머신 유형:
n2-standard-32
- 최소 CPU 플랫폼:
Intel Cascade Lake
- GPU: 없음
- 로컬 SSD: 없음
- 리전:
고급 옵션 섹션을 펼친 후 관리 섹션을 펼칩니다. 예약 목록에서 특정 예약 선택을 선택한 후 다음을 수행합니다.
- 현재 프로젝트와 예약이 공유된 예약 프로젝트를 선택합니다. 이 예시에서는
reservation-02
를 만들기 위해 사용된 프로젝트를 선택합니다. - 이 VM에 사용하려는 공유 예약의 예약 이름을 선택합니다. 이 예시에서는
reservation-02
를 선택합니다.
- 현재 프로젝트와 예약이 공유된 예약 프로젝트를 선택합니다. 이 예시에서는
만들기를 클릭하여 VM을 만듭니다.
--require-specific-reservation
플래그로reservation-02
라는 예약을 생성합니다. 이렇게 예약된 리소스는 이름으로 이 예약을 명시적으로 타겟팅하는 VM에서만 사용할 수 있습니다.gcloud compute reservations create reservation-02 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --vm-count=10 \ --zone=us-central1-a \ --project=my-owner-project \ --share-setting=projects \ --share-with=project-1,project-2 \ --require-specific-reservation
--reservation-affinity
및--reservation
플래그를 사용하여 이름으로reservation-02
를 타겟팅하는 VM을 만듭니다. 이 예약을 공유하는 소비자 프로젝트에서 이 예약을 사용하려면 예약을 만든 프로젝트인my-owner-project
도 지정해야 합니다.영역, 머신 유형(머신 계열, vCPU, 메모리), 최소 CPU 플랫폼, GPU 크기 및 유형, 로컬 SSD 인터페이스 및 크기를 포함하여 VM의 속성이 예약의 VM 속성과 일치하는지 확인합니다.
gcloud compute instances create instance-2 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --zone=us-central1-a \ --reservation-affinity=specific \ --reservation=projects/my-owner-project/reservations/reservation-02
specificReservationRequired
필드를true
로 설정하여reservation-02
라는 예약을 생성합니다.POST https://compute.googleapis.com/compute/v1/projects/my-owner-project/zones/us-central1-a/reservations { "name":"reservation-02", "specificReservation":{ "count":"10", "instanceProperties":{ "machineType":"n2-standard-32", "minCpuPlatform": "Intel Cascade Lake" } }, "shareSettings": { "shareType": "SPECIFIC_PROJECTS", "projectMap": { "project-1": { "projectId": "project-1" }, "project-2": { "projectId": "project-2" } } }, "specificReservationRequired": true }
reservationAffinity
필드를 사용하여 이름으로reservation-02
을 타겟팅하는 VM을 생성합니다. 이 예약을 공유하는 소비자 프로젝트에서 이 예약을 사용하려면 예약의 소유자 프로젝트인my-owner-project
도 지정해야 합니다.영역, 머신 유형(머신 계열, vCPU, 메모리), 최소 CPU 플랫폼, GPU 크기 및 유형, 로컬 SSD 인터페이스 및 크기를 포함하여 VM의 속성이 예약의 VM 속성과 일치하는지 확인합니다.
POST https://compute.googleapis.com/compute/v1/projects/project-2/zones/us-central1-a/instances { "name": "instance-2", "machineType": "zones/us-central1-a/machineTypes/n2-standard-32", "minCpuPlatform": "Intel Cascade Lake", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/debian-clouid/global/images/family/debian-12" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "SPECIFIC_RESERVATION", "key": "compute.googleapis.com/reservation-name", "values": [ "projects/my-owner-project/reservations/reservation-02" ] } }
이 섹션에 설명된 대로 예약을 명시적으로 사용하지 않도록 VM의 예약 어피니티 속성을 설정합니다.
VM이 예약의 VM 속성과 일치하지 않는지 확인합니다.
Google Cloud 콘솔에서 인스턴스 만들기 페이지로 이동합니다.
이름 필드에 VM의 이름을 입력합니다.
리전 및 영역 목록에서 VM을 만들 리전과 영역을 선택합니다.
머신 구성 섹션에서 VM에 사용할 머신 유형을 지정합니다.
고급 옵션 섹션을 펼친 후 다음을 수행합니다.
관리 섹션을 펼칩니다.
예약 섹션의 애플리케이션 정책 목록에서 사용 안함을 선택합니다.
만들기를 클릭합니다.
VM_NAME
: VM의 이름입니다.MACHINE_TYPE
: VM에 사용할 머신 유형입니다.ZONE
: VM을 만들 영역입니다.PROJECT_ID
: VM을 만들 프로젝트의 ID입니다.ZONE
: VM을 만들 영역입니다.VM_NAME
: VM의 이름입니다.MACHINE_TYPE
: VM에 사용할 머신 유형입니다.IMAGE_PROJECT
: OS 이미지가 포함된 이미지 프로젝트입니다(예:debian-cloud
). 지원되는 이미지 프로젝트에 대한 자세한 내용은 공개 이미지를 참조하세요.IMAGE
: 다음 중 하나를 지정합니다.OS 이미지의 특정 버전입니다(예:
debian-12-bookworm-v20240617
).이미지 계열이며 형식은
family/IMAGE_FAMILY
여야 합니다. 중단되지 않은 최신 OS 이미지를 지정합니다. 예를 들어family/debian-12
를 지정하면 Debian 12 이미지 계열의 최신 버전이 사용됩니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.
Google Cloud 콘솔에서 인스턴스 템플릿 만들기 페이지로 이동합니다.
이름 필드에 인스턴스 템플릿의 이름을 입력합니다.
위치 섹션에서 리전(기본값) 또는 전역 인스턴스 템플릿을 만들지 여부를 지정합니다.
머신 구성 섹션에서 템플릿을 사용하여 만든 VM에 사용할 머신 유형을 지정합니다.
고급 옵션 섹션을 펼친 후 다음을 수행합니다.
관리 섹션을 펼칩니다.
예약 섹션의 애플리케이션 정책 목록에서 사용 안함을 선택합니다.
만들기를 클릭합니다.
INSTANCE_TEMPLATE_NAME
: 인스턴스 템플릿의 이름입니다.MACHINE_TYPE
: 인스턴스 템플릿을 사용하여 만든 VM에 사용할 머신 유형입니다.전역 인스턴스 템플릿을 만들려면
instanceTemplates.insert
메서드를 사용합니다.리전 인스턴스 템플릿을 만들려면
regionInstanceTemplates.insert
메서드를 사용합니다.PROJECT_ID
: 인스턴스 템플릿을 만들 프로젝트의 ID입니다.INSTANCE_TEMPLATE_NAME
: 인스턴스 템플릿의 이름입니다.MACHINE_TYPE
: 인스턴스 템플릿을 사용하여 만든 VM에 사용할 머신 유형입니다.IMAGE_PROJECT
: OS 이미지가 포함된 이미지 프로젝트입니다(예:debian-cloud
). 지원되는 이미지 프로젝트에 대한 자세한 내용은 공개 이미지를 참조하세요.IMAGE
: 다음 중 하나를 지정합니다.OS 이미지의 특정 버전입니다(예:
debian-12-bookworm-v20240617
).이미지 계열이며 형식은
family/IMAGE_FAMILY
여야 합니다. 중단되지 않은 최신 OS 이미지를 지정합니다. 예를 들어family/debian-12
를 지정하면 Debian 12 이미지 계열의 최신 버전이 사용됩니다. 이미지 계열 사용에 대한 자세한 내용은 이미지 계열 권장사항을 참조하세요.
VM을 만들거나 업데이트하기 전후에 예약의 세부정보를 확인합니다.
변경 후 예약에서 사용된 VM 수가 1개 증가하면 변경으로 인해 VM에서 이 예약을 사용하기 시작했을 수 있습니다. 예약 사용을 확인하는 가장 간단한 방법이지만 예약을 사용하는 정확한 VM을 확인하는 데 효과적이지 않을 수 있습니다.
-
특정 예약을 타겟팅하는 VM을 성공적으로 만들 수 있다면 해당 VM에서 예약을 사용합니다. 특정 VM이 예약을 사용하고 있는지, VM 속성이 예약과 일치하는지 확인하는 가장 안정적인 방법입니다.
예약 사용을 모니터링합니다.
Cloud Monitoring을 사용하면 현재 프로젝트에서 생성된 예약의 사용과 관련된 정보에 액세스하여 확인할 수 있습니다. 예약 측정값이 변경되었다면 VM이 예약을 사용했다는 의미입니다. 하나 이상의 예약에 대한 소비 추세를 확인하고 사용량이 적거나 사용되지 않은 예약에 대한 알림을 받는 데 유용한 방법입니다.
- 사용 중인 예약 리소스. 이러한 항목은 일반 vCPU, 메모리, GPU, 로컬 SSD 리소스로 표시됩니다.
- 사용하지 않는 예약 리소스. 이러한 항목에는 일반 SKU 이름과 예약 리소스 URI가 있습니다.
- 총 예약 리소스. 이러한 항목에는 예약 SKU 이름과 예약 리소스 URI가 있습니다. 이 항목과 관련된 비용은 없습니다. 사용 중인 예약의 양을 계산할 때 이 항목을 사용합니다.
- 행 1은 현재 사용 중인 예약 RAM을 보여줍니다. 행의
ResourceId
는 이 RAM이my-instance
라는 VM에서 사용되고 있음을 보여줍니다. - 행 2는 사용하지 않는 예약 RAM을 보여줍니다. 행의
ResourceId
는 이 예약이my-reservation
에 있음을 보여줍니다. 이 RAM은 어떤 VM에서도 사용되지 않습니다. - 행 3은 예약의 총 예약 RAM을 보여줍니다.
- 예약 사용 모니터링 방법 알아보기
- 예약 수정 방법 알아보기
- 예약 삭제 방법 알아보기
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공하는 사용자 인증 정보를 사용합니다.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
자세한 내용은 Google Cloud 인증 문서의 REST 사용 인증을 참조하세요.
필요한 역할
예약 사용에 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 인스턴스 관리자(v1)(
roles/compute.instanceAdmin.v1
) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.이 사전 정의된 역할에는 예약을 사용하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
예약을 사용하려면 다음 권한이 필요합니다.
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
예약된 VM 사용
가상 머신(VM) 인스턴스를 만들면 VM 및 예약의 속성이 일치하는 경우에만 VM에서 예약을 사용하기 시작합니다. 또한 VM의 예약 어피니티 속성을 다음 옵션 중 하나로 설정해야 합니다.
일치하는 예약에서 VM 사용
이 소비 모델의 경우 기존 VM과 새 VM에서 속성이 예약에 지정된 VM 속성과 일치하면 예약을 자동으로 사용합니다.
이 소비 모델을 사용하는 경우 현재 프로젝트의 VM이 공유 예약을 사용하기 전에 먼저 모든 단일 프로젝트 예약을 사용합니다. 예약이 자동으로 사용되는 방법에 대한 자세한 내용은 사용 순서를 참조하세요.
예약을 생성할 때 특정 예약이 필요함을 나타내는 플래그 또는 옵션을 사용하지 않는 한 이 모델이 기본 소비 모델입니다.
콘솔
gcloud
REST
특정 예약에서 VM 사용
이 사용 모델에서는 이름으로 특정 예약을 타겟팅하는 새로운 VM만 해당 예약을 사용하며 예약은 자동으로 사용되지 않습니다.
예약을 생성할 때 다음 방법 중 하나를 사용하여 VM이 특정 예약을 타겟팅하도록 지정합니다.
그런 다음 해당 예약을 명시적으로 타겟팅하는 VM을 생성합니다. VM 속성 및 예약 속성이 일치하는 경우에만 특정 예약을 대상으로 하는 VM을 만들 수 있습니다. 그렇지 않으면 VM 만들기가 실패합니다.
인스턴스 템플릿을 사용해 리전 관리형 인스턴스 그룹에서 VM을 만들려면 해당 영역별로 이름이 같은 동일한 예약을 생성합니다. 그런 다음 그룹의 인스턴스 템플릿에서 이름으로 예약을 타겟팅합니다.
예를 들어
reservation-02
라는 특정 예약을 생성한 다음 해당 예약을 타겟팅하고 예약의 VM 속성과 일치하는 VM을 만듭니다.사용할 VM 유형에 따라 특정 단일 프로젝트 예약 사용 또는 특정 공유 예약 사용 단계를 따릅니다.
특정 단일 프로젝트 예약 사용
특정 단일 프로젝트 예약을 사용하려면 다음 옵션 중 하나를 선택합니다.
콘솔
gcloud
REST
특정 공유 예약 사용
특정 공유 예약을 사용하려면 다음 옵션 중 하나를 선택합니다.
콘솔
gcloud
REST
예약을 사용하지 않고 VM 만들기
자동으로 사용되는 예약을 만들면 프로젝트에서 일치하는 속성이 있는 실행 중인 모든 VM에서 예약을 사용할 수 있습니다. 하나 이상의 VM에서 예약을 사용하지 못하도록 하려면 다음을 수행합니다.
예약을 명시적으로 사용하지 않는 VM을 만들려면 다음 방법 중 하나를 선택합니다.
예약을 사용하지 않는 VM 만들기
예약을 명시적으로 사용하지 않는 VM을 만들려면 다음 옵션 중 하나를 선택합니다.
콘솔
gcloud
예약을 명시적으로 사용하지 않는 VM을 만들려면
--reservation-affinity=none
플래그와 함께gcloud compute instances create
명령어를 사용합니다.gcloud compute instances create VM_NAME \ --machine-type=MACHINE_TYPE \ --reservation-affinity=none \ --zone=ZONE
다음을 바꿉니다.
REST
예약을 명시적으로 사용하지 않는 VM을 만들려면
instances.insert
메서드에POST
요청을 수행합니다. 요청 본문에NO_RESERVATION
으로 설정된consumeReservationType
필드를 포함합니다.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances { "name": "VM_NAME", "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" } }
다음을 바꿉니다.
VM 만들기에 대한 자세한 내용은 Compute Engine 인스턴스 만들기 및 시작을 참고하세요.
예약을 사용하지 않는 인스턴스 템플릿 만들기
예약을 명시적으로 사용하지 않는 VM을 만드는 인스턴스 템플릿을 만들려면 다음 옵션 중 하나를 선택합니다.
콘솔
gcloud
예약을 명시적으로 사용하지 않는 VM을 만드는 인스턴스 템플릿을 만들려면
--reservation-affinity=none
플래그와 함께gcloud compute instances-templates create
명령어를 사용합니다.예를 들어 예약을 명시적으로 사용하지 않는 VM을 만드는 전역 인스턴스 템플릿을 만들려면 다음 명령어를 실행합니다.
gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \ --machine-type=MACHINE_TYPE \ --reservation-affinity=none
다음을 바꿉니다.
REST
예약을 명시적으로 사용하지 않는 VM을 만드는 인스턴스 템플릿을 만들려면 다음 방법 중 하나로
POST
요청을 수행합니다.요청 본문에
consumeReservationType
필드를 포함하고NO_RESERVATION
으로 설정합니다.예를 들어 예약을 명시적으로 사용하지 않는 VM을 만드는 전역 인스턴스 템플릿을 만들려면 다음과 같이 요청합니다.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/InstanceTemplates { "name": "INSTANCE_TEMPLATE_NAME", "properties": { "machineType": "MACHINE_TYPE", "disks": [ { "boot": true, "initializeParams": { "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE" } } ], "networkInterfaces": [ { "network": "global/networks/default" } ], "reservationAffinity": { "consumeReservationType": "NO_RESERVATION" } } }
다음을 바꿉니다.
인스턴스 템플릿 만들기에 대한 자세한 내용은 인스턴스 템플릿 만들기를 참조하세요.
VM 속성이 예약과 일치하는지 테스트
VM이 예약을 자동으로 사용할 수 있는지 여부를 테스트하려면 예약 사본을 특정 예약으로 만든 다음 만들려는 VM이 해당 예약을 사용할 수 있는지 확인하면 됩니다. VM을 성공적으로 만들 수 있으면 VM이 일치하는 예약만 올바르게 소비할 수 있는지 확인된 것입니다. 그렇지 않으면 일치하지 않는 속성 으로 인해 또는 사용 가능한 예약 리소스 없음으로 인해 VM 만들기가 실패합니다. 테스트 후 다음 중 하나 이상을 수행할 수 있습니다.
예약 사용 확인
VM이 예약을 올바르게 사용하고 있는지 확인하려면 다음 방법 중 하나를 사용합니다.
VM의 예약 어피니티가 예약을 사용할 수 있고 예약이 완전히 사용되지 않았으며 VM과 예약의 속성이 일치함을 확인했는데 VM이 예약을 사용하지 않으면 리소스 가용성에 대한 문제 해결 문서를 참조하세요.
예약 사용량 보고서 보기
사용량 내보내기 기능을 사용하여 Compute Engine 사용량의 상세한 보고서를 Cloud Storage 버킷으로 내보냅니다. 자세한 안내는 사용량 보고서 보기를 참조하세요.
사용량 보고서에는 다음이 표시됩니다.
Measurement MeasurementId
formatResource URI
format사용 중인 예약 리소스 com.google.cloud/services/compute-engine/SKU_NAME
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/RESOURCE_TYPE/RESOURCE_NAME
.
예를 들면https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance
입니다.사용하지 않는 예약 리소스 com.google.cloud/services/compute-engine/SKU_NAME
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
.
예를 들면https://compute.googleapis.com/compute/v1/projects/my-project/zones/europe-west1-b/reservations/my-reservation
입니다.총 예약 리소스 com.google.cloud/services/compute-engine/ReservationSKU_NAME
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
.
예를 들면https://compute.googleapis.com/compute/v1/projects/my-project/zones/europe-west1-b/reservations/my-reservation
입니다.예를 들어 다음 스니펫에서
my-reservation
이라는 예약의 사용량 보고서에 포함된 각 항목의 의미는 다음과 같습니다.Report Date,MeasurementId,Quantity,Unit,Resource URI,ResourceId,Location 2019-06-06,com.google.cloud/services/compute-engine/VmimageN2StandardRam,166970074857472,byte-seconds,https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central2-a/instances/my-instance,1775485842510981624,us-central2-a 2019-06-06,com.google.cloud/services/compute-engine/VmimageN2StandardRam,166970074857472,byte-seconds,https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central2-a/reservations/my-reservation,7.58809E+17,us-central2-a 2019-06-06,com.google.cloud/services/compute-engine/ReservationN2StandardRam,333940149714944,byte-seconds,https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central2-a/reservations/my-reservation,7.58809E+17,us-central2-a ...
문제 해결
예약 사용 관련 문제 해결 방법을 알아보세요.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-11-12(UTC)
-