Dokumen ini menjelaskan cara menggunakan Compute Engine untuk melakukan hal berikut:
Menggunakan instance virtual machine (VM) yang direservasi.
Memverifikasi pemakaian reservasi.
Melihat laporan penggunaan reservasi.
Untuk informasi selengkapnya tentang menggunakan reservasi di produk Google Cloud lainnya yang menggunakan VM, lihat dokumentasi reservasi untuk produk berikut:
- Batch
- Dataflow
- Dataproc
- Google Kubernetes Engine
- Vertex AI:
Sebelum memulai
- Tinjau persyaratan dan batasan untuk pemesanan.
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud.
Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:
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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
-
Untuk membuat pemesanan:
compute.reservations.create
pada project -
Untuk membuat VM:
compute.instances.create
pada project- Untuk menggunakan image kustom guna membuat VM:
compute.images.useReadOnly
pada image - Untuk menggunakan snapshot guna membuat VM:
compute.snapshots.useReadOnly
pada snapshot - Untuk menggunakan template instance guna membuat VM:
compute.instanceTemplates.useReadOnly
di template instance - Untuk menetapkan jaringan lama ke VM:
compute.networks.use
di project - Untuk menentukan alamat IP statis untuk VM:
compute.addresses.use
pada project - Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan lama:
compute.networks.useExternalIp
di project - Untuk menentukan subnet bagi VM:
compute.subnetworks.use
di project atau di subnet yang dipilih - Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC:
compute.subnetworks.useExternalIp
di project atau di subnet yang dipilih - Untuk menetapkan metadata instance VM untuk VM:
compute.instances.setMetadata
pada project - Untuk menetapkan tag untuk VM:
compute.instances.setTags
di VM - Untuk menetapkan label untuk VM:
compute.instances.setLabels
di VM - Untuk menetapkan akun layanan yang akan digunakan VM:
compute.instances.setServiceAccount
di VM - Untuk membuat disk baru bagi VM:
compute.disks.create
pada project - Untuk memasang disk yang ada dalam mode hanya baca atau baca-tulis:
compute.disks.use
pada disk - Untuk memasang disk yang ada dalam mode hanya baca:
compute.disks.useReadOnly
pada disk
-
Untuk membuat template instance:
compute.instanceTemplates.create
pada project Memakai reservasi yang cocok—VM dapat otomatis memakai reservasi apa pun dengan properti yang cocok (default).
Opsi ini berguna jika Anda membuat dan menghapus banyak VM, serta Anda ingin menggunakan reservasi jika memungkinkan. Dalam skenario ini, VM dapat dibuat, baik propertinya cocok dengan reservasi maupun tidak. Jika properti tersebut cocok, VM akan mulai menggunakan reservasi, bergantung pada urutan pemakaian reservasi.
Memakai reservasi tertentu—VM hanya dapat memakai reservasi tertentu. Reservasi tidak dapat digunakan secara otomatis.
Opsi ini berguna jika, misalnya, Anda ingin menyimpan jumlah kapasitas tertentu sebagai cadangan untuk acara khusus. Dalam skenario ini, VM hanya dapat dibuat jika propertinya dan properti reservasi tertentu cocok.
Tidak dapat memakai reservasi apa pun—VM tidak dapat memakai reservasi apa pun.
Opsi ini berguna jika, misalnya, Anda membuat VM sementara yang tidak Anda kehendaki untuk memakai resource yang direservasi.
Untuk membuat reservasi dengan resource yang dapat digunakan oleh VM dengan properti afinitas reservasi yang dikonfigurasi untuk menggunakan reservasi apa pun (default), ikuti langkah-langkah berikut:
Pilih jenis reservasi yang ingin dibuat:
Untuk membuat reservasi mandiri, lakukan langkah berikut:
Di Konsol Google Cloud, buka halaman Reservations.
Di tab Pemesanan sesuai permintaan (default), klik
Buat pemesanan.Halaman Create a reservation akan terbuka.
Untuk membuat reservasi yang terkait dengan komitmen, lakukan tindakan berikut:
Di Konsol Google Cloud, buka halaman Committed use discounts.
Buka halaman Committed use discounts
Halaman Daftar komitmen akan terbuka.
Klik
Purchase commitment.Halaman Purchase a committed use discount akan terbuka.
Tentukan properti komitmen. Lalu, di bagian Reservations, klik Add an item.
Halaman Add a new reservation akan muncul.
Untuk mengetahui informasi lebih lanjut cara membeli komitmen dengan reservasi terlampir, lihat Membeli reservasi dengan reservasi terlampir.
Di kolom Name, masukkan nama reservasi Anda. Untuk contoh ini, masukkan
reservation-01
.Pilih Region dan Zone tempat Anda ingin mereservasi resource. Untuk contoh ini, pilih
us-central1
sebagai region danus-central1-a
sebagai zona.Pilih Share type yang Anda inginkan:
- Untuk membuat reservasi bagi satu project, pilih Local.
- Untuk membuat pemesanan yang dibagikan dengan banyak project, pilih Dibagikan. Untuk membagikan pemesanan ini dengan project lain, klik Tambahkan project, lalu pilih project yang diinginkan dari organisasi project saat ini.
Di bagian Use with VM instance, pilih Use reservation automatically, sehingga setiap VM yang cocok dapat otomatis menggunakan reservasi ini.
Di kolom Jumlah instance VM, masukkan jumlah VM yang ingin Anda pesan. Untuk contoh ini, masukkan
2
.Tentukan resource yang ingin Anda pesan untuk setiap VM:
- Jika Anda ingin memesan VM yang cocok dengan template instance yang ada, pilih Gunakan template instance dan klik salah satu template instance dari daftar.
- Jika tidak, pilih Tentukan jenis mesin dan tentukan properti berikut:
- Di kolom Kelompok mesin, Seri, dan Jenis mesin, pilih kelompok mesin, seri, dan jenis mesin.
- Opsional: Tentukan platform CPU dan/atau GPU minimum:
- Untuk meluaskan bagian CPU Platform and GPU, klik panah perluas .
- Opsional: Untuk menentukan platform CPU minimum, dalam daftar CPU Platform, pilih salah satu opsi.
- Opsional: Untuk menambahkan GPU, klik Add GPU. Kemudian, di kolom Jenis GPU dan Jumlah GPU, pilih jenis dan jumlah GPU untuk setiap VM.
- Opsional: Tambahkan SSD lokal:
- Di kolom Jumlah disk, pilih jumlah SSD lokal untuk setiap VM.
- Di kolom Interface type, pilih antarmuka untuk SSD lokal.
Untuk contoh ini, pilih Specify machine type. Kemudian, pilih jenis mesin
n2-standard-32
untuk kelompok mesinGeneral-purpose
dan seriN2
, lalu pilih platform CPU minimumIntel Cascade Lake
.Selesaikan pembuatan reservasi:
Jika Anda membuat reservasi mandiri, klik Create.
Jika Anda membuat reservasi yang terkait dengan komitmen:
- Untuk menyelesaikan penentuan properti reservasi ini, klik Done.
- Untuk menyelesaikan pembuatan komitmen dan reservasi terlampir, klik Purchase.
Dalam project yang sama atau project yang reservasinya digunakan bersama, buat VM yang menargetkan semua reservasi yang terbuka.
Pastikan properti VM sesuai dengan properti VM di
reservation-01
, termasuk zona, jenis mesin (kelompok mesin, vCPU, dan memori), platform CPU minimum, jumlah dan jenis GPU, serta antarmuka dan ukuran SSD lokal.Untuk mengetahui informasi selengkapnya tentang cara membuat VM, lihat Membuat dan memulai VM
Di konsol Google Cloud, buka halaman Create an instance.
Halaman Create an instance akan terbuka.
Tentukan nama untuk VM Anda.
Di bagian berikut, pilih konfigurasi yang sama persis dengan semua properti reservasi Anda, termasuk properti opsional apa pun. Untuk contoh ini, Anda harus mencocokkan properti VM berikut dengan
reservation-01
:- Region:
us-central1
- Zone:
us-central1-a
- Machine type:
n2-standard-32
- CPU platform minimum:
Intel Cascade Lake
- GPUs: tidak ada
- Local SSDs: tidak ada
- Region:
Luaskan bagian Advanced options, lalu luaskan bagian Management. Dalam daftar Reservations, pilih Automatically use created reservation.
Untuk membuat VM, klik Create.
Buat reservasi terbuka bernama
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
Buat VM yang menargetkan semua reservasi terbuka dan yang cocok dengan properti VM di
reservation-01
, termasuk zona, jenis mesin (kelompok mesin, vCPU, dan memori), platform CPU minimum, jumlah dan jenis GPU, serta jumlah dan antarmuka SSD lokal.gcloud compute instances create instance-1 \ --machine-type=n2-standard-32 \ --min-cpu-platform="Intel Cascade Lake" \ --zone=us-central1-a \ --reservation-affinity=any
Buat reservasi terbuka bernama
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", } } }
Buat VM yang menargetkan semua reservasi terbuka dan yang cocok dengan properti VM di
reservation-01
, termasuk zona, jenis mesin (kelompok mesin, vCPU, dan memori), platform CPU minimum, jumlah dan jenis GPU, serta jumlah dan antarmuka SSD lokal.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" } }
- Di Konsol Google Cloud, centang kotak Select specific reservation.
- Di gcloud CLI, sertakan flag
--require-specific-reservation
. - Di Compute Engine API, tetapkan kolom
specificReservationRequired
ketrue
. - Di Terraform, tetapkan kolom
specific_reservation_required
ketrue
. Untuk membuat reservasi dengan resource yang hanya dapat digunakan oleh VM yang secara khusus menargetkan reservasi berdasarkan nama, ikuti langkah-langkah berikut:
Pilih salah satu opsi berikut:
Untuk membuat reservasi mandiri, lakukan langkah berikut:
Di Konsol Google Cloud, buka halaman Reservations.
Di tab Pemesanan sesuai permintaan (default), klik
Buat pemesanan.Halaman Create a reservation akan terbuka.
Untuk membuat reservasi yang terkait dengan komitmen, lakukan tindakan berikut:
Di Konsol Google Cloud, buka halaman Committed use discounts.
Klik
Purchase commitment.Halaman Purchase a committed use discount akan terbuka.
Tentukan properti komitmen. Lalu, di bagian Reservations, klik Add an item.
Halaman Add a new reservation akan muncul.
Untuk mengetahui informasi lebih lanjut cara membeli komitmen dengan reservasi terlampir, lihat Membeli reservasi dengan reservasi terlampir.
Di kolom Name, masukkan nama reservasi Anda. Untuk contoh ini, masukkan
reservation-02
.Pilih Region dan Zone tempat Anda ingin mereservasi resource. Untuk contoh ini, pilih
us-central1
sebagai region danus-central1-a
sebagai zona.Untuk menentukan bahwa reservasi Anda akan menjadi reservasi satu project, pilih Local sebagai Share type.
Di bagian Use with VM instance, pilih Select specific reservation, sehingga hanya VM yang cocok yang secara khusus menargetkan reservasi ini berdasarkan nama yang dapat menggunakan reservasi ini.
Di kolom Jumlah instance VM, masukkan jumlah VM yang ingin Anda pesan. Untuk contoh ini, masukkan
10
.Tentukan resource yang ingin Anda pesan untuk setiap VM:
- Jika Anda ingin memesan VM yang cocok dengan template instance yang ada, pilih Gunakan template instance dan klik salah satu template instance dari daftar.
- Jika tidak, pilih Tentukan jenis mesin dan tentukan properti berikut:
- Di kolom Kelompok mesin, Seri, dan Jenis mesin, pilih kelompok mesin, seri, dan jenis mesin.
- Opsional: Tentukan platform CPU dan/atau GPU minimum:
- Untuk meluaskan bagian CPU Platform and GPU, klik panah perluas .
- Opsional: Untuk menentukan platform CPU minimum, dalam daftar CPU Platform, pilih salah satu opsi.
- Opsional: Untuk menambahkan GPU, klik Add GPU. Kemudian, di kolom Jenis GPU dan Jumlah GPU, pilih jenis dan jumlah GPU untuk setiap VM.
- Opsional: Tambahkan SSD lokal:
- Di kolom Jumlah disk, pilih jumlah SSD lokal untuk setiap VM.
- Di kolom Interface type, pilih antarmuka untuk SSD lokal.
Untuk contoh ini, pilih Specify machine type. Kemudian, pilih jenis mesin
n2-standard-32
untuk kelompok mesinGeneral-purpose
dan seriN2
, lalu pilih platform CPU minimumIntel Cascade Lake
.Selesaikan pembuatan reservasi:
Jika Anda membuat reservasi mandiri, klik Create.
Jika Anda membuat reservasi yang terkait dengan komitmen:
- Untuk menyelesaikan penentuan properti reservasi ini, klik Done.
- Untuk menyelesaikan pembuatan komitmen dan reservasi terlampir, klik Purchase.
Dalam project yang sama, buat VM yang menargetkan reservasi spesifik tersebut berdasarkan nama.
Pastikan properti VM sesuai dengan properti VM dari reservasi tertentu tersebut, termasuk zona, jenis mesin (kelompok mesin, vCPU, dan memori), platform CPU minimum, jumlah dan jenis GPU, serta antarmuka dan ukuran SSD lokal.
Untuk mengetahui informasi selengkapnya tentang cara membuat VM, lihat Membuat dan memulai VM.
Di konsol Google Cloud, buka halaman Create an instance.
Di kolom Nama, masukkan nama untuk VM.
Di bagian berikut, pilih konfigurasi yang sama persis dengan semua properti reservasi Anda, termasuk properti opsional apa pun. Untuk contoh ini, Anda harus mencocokkan properti VM berikut dengan
reservation-02
:- Region:
us-central1
- Zone:
us-central1-a
- Machine type:
n2-standard-32
- CPU platform minimum:
Intel Cascade Lake
- GPUs: tidak ada
- Local SSDs: tidak ada
- Region:
Luaskan bagian Advanced options, lalu lakukan hal berikut:
Luaskan bagian Management.
Di bagian Reservations, dalam daftar Application policy, pilih Select specific reservation.
Pilih reservasi dengan properti VM yang cocok yang Anda inginkan untuk digunakan VM. Untuk contoh ini, pilih
reservation-02
.
Untuk membuat VM, klik Create.
Buat reservasi bernama
reservation-02
dengan flag--require-specific-reservation
. Resource yang direservasi ini hanya dapat digunakan oleh VM yang secara khusus menargetkan reservasi ini berdasarkan nama.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
Buat VM yang menargetkan
reservation-02
berdasarkan nama menggunakan flag--reservation-affinity
dan--reservation
.Pastikan properti VM sesuai dengan properti VM reservasi, termasuk zona, jenis mesin (kelompok mesin, vCPU, dan memori), platform CPU minimum, jumlah dan jenis GPU, serta antarmuka dan ukuran SSD lokal.
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
Buat reservasi bernama
reservation-02
dengan kolomspecificReservationRequired
ditetapkan ketrue
.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 }
Buat VM yang menargetkan
reservation-02
berdasarkan nama menggunakan kolomreservationAffinity
.Pastikan properti VM sesuai dengan properti VM reservasi, termasuk zona, jenis mesin (kelompok mesin, vCPU, dan memori), platform CPU minimum, jumlah dan jenis GPU, serta antarmuka dan ukuran SSD lokal.
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" ] } }
Untuk membuat reservasi bersama menggunakan resource yang hanya dapat digunakan oleh VM yang secara khusus menargetkan reservasi ini berdasarkan nama, ikuti langkah-langkah berikut:
Pilih salah satu opsi berikut:
Untuk membuat reservasi mandiri, lakukan langkah berikut:
Di Konsol Google Cloud, buka halaman Reservations.
Di tab Pemesanan sesuai permintaan (default), klik
Buat pemesanan.Halaman Create a reservation akan terbuka.
Untuk membuat reservasi yang terkait dengan komitmen, lakukan tindakan berikut:
Di Konsol Google Cloud, buka halaman Committed use discounts.
Klik
Purchase commitment.Halaman Purchase a committed use discount akan terbuka.
Tentukan properti komitmen. Lalu, di bagian Reservations, klik Add an item.
Halaman Add a new reservation akan muncul.
Untuk mengetahui informasi lebih lanjut cara membeli komitmen dengan reservasi terlampir, lihat Membeli reservasi dengan reservasi terlampir.
Di kolom Name, masukkan nama reservasi Anda. Untuk contoh ini, masukkan
reservation-02
.Pilih Region dan Zone tempat Anda ingin mereservasi resource. Untuk contoh ini, pilih
us-central1
sebagai region danus-central1-a
sebagai zona.Untuk menentukan bahwa reservasi Anda adalah reservasi bersama, pilih Shared sebagai Share type.
Klik
Add projects, lalu pilih project dari organisasi project saat ini yang ingin diajak berbagi reservasi.Di bagian Use with VM instance, pilih Select specific reservation, sehingga hanya VM yang cocok yang secara khusus menargetkan reservasi ini berdasarkan nama yang dapat menggunakan reservasi ini.
Di kolom Jumlah instance VM, masukkan jumlah VM yang ingin Anda pesan. Untuk contoh ini, masukkan
10
.Tentukan resource yang ingin Anda pesan untuk setiap VM:
- Jika Anda ingin memesan VM yang cocok dengan template instance yang ada, pilih Gunakan template instance dan klik salah satu template instance dari daftar.
- Jika tidak, pilih Tentukan jenis mesin dan tentukan properti berikut:
- Di kolom Kelompok mesin, Seri, dan Jenis mesin, pilih kelompok mesin, seri, dan jenis mesin.
- Opsional: Tentukan platform CPU dan/atau GPU minimum:
- Untuk meluaskan bagian CPU Platform and GPU, klik panah perluas .
- Opsional: Untuk menentukan platform CPU minimum, dalam daftar CPU Platform, pilih salah satu opsi.
- Opsional: Untuk menambahkan GPU, klik Add GPU. Kemudian, di kolom Jenis GPU dan Jumlah GPU, pilih jenis dan jumlah GPU untuk setiap VM.
- Opsional: Tambahkan SSD lokal:
- Di kolom Jumlah disk, pilih jumlah SSD lokal untuk setiap VM.
- Di kolom Interface type, pilih antarmuka untuk SSD lokal.
Untuk contoh ini, pilih Specify machine type. Kemudian, pilih jenis mesin
n2-standard-32
untuk kelompok mesinGeneral-purpose
dan seriN2
, lalu pilih platform CPU minimumIntel Cascade Lake
. 1. Selesaikan pembuatan reservasi:Jika Anda membuat reservasi mandiri, klik Create.
Jika Anda membuat reservasi yang terkait dengan komitmen:
- Untuk menyelesaikan penentuan properti reservasi ini, klik Done.
- Untuk menyelesaikan pembuatan komitmen dan reservasi terlampir, klik Purchase.
Dalam project yang sama atau project yang reservasinya digunakan bersama, buat VM yang menargetkan reservasi spesifik tersebut berdasarkan nama.
Pastikan properti VM sesuai dengan properti VM dari reservasi tertentu tersebut, termasuk zona, jenis mesin (kelompok mesin, vCPU, dan memori), platform CPU minimum, jumlah dan jenis GPU, serta antarmuka dan ukuran SSD lokal.
Di konsol Google Cloud, buka halaman Create an instance.
Halaman Create an instance akan terbuka.
Tentukan Name untuk VM Anda.
Di bagian berikut, pilih konfigurasi yang sama persis dengan semua properti reservasi Anda, termasuk properti opsional apa pun. Untuk contoh ini, Anda harus mencocokkan properti VM berikut dengan
reservation-02
:- Region:
us-central1
- Zone:
us-central1-a
- Machine type:
n2-standard-32
- CPU platform minimum:
Intel Cascade Lake
- GPUs: tidak ada
- Local SSDs: tidak ada
- Region:
Luaskan bagian Advanced options, lalu luaskan bagian Management. Dalam daftar Reservations, pilih Select specific reservation, lalu lakukan hal berikut:
- Pilih Reservation project yang memiliki reservasi yang dibagikan dengan project Anda saat ini. Untuk contoh ini, pilih project yang Anda gunakan untuk membuat
reservation-02
. - Pilih Reservation name untuk reservasi bersama yang Anda inginkan untuk dipakai oleh instance VM ini. Untuk contoh ini, pilih
reservation-02
.
- Pilih Reservation project yang memiliki reservasi yang dibagikan dengan project Anda saat ini. Untuk contoh ini, pilih project yang Anda gunakan untuk membuat
Untuk membuat VM, klik Create.
Buat reservasi bernama
reservation-02
dengan flag--require-specific-reservation
. Resource yang direservasi ini hanya dapat digunakan oleh VM yang secara khusus menargetkan reservasi ini berdasarkan nama.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
Buat VM yang menargetkan
reservation-02
berdasarkan nama menggunakan flag--reservation-affinity
dan--reservation
. Untuk memakai reservasi ini dari project konsumen yang juga memakai reservasi bersama ini, Anda juga harus menentukan project yang membuat reservasi,my-owner-project
.Pastikan properti VM sesuai dengan properti VM reservasi, termasuk zona, jenis mesin (kelompok mesin, vCPU, dan memori), platform CPU minimum, jumlah dan jenis GPU, serta antarmuka dan ukuran SSD lokal.
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
Buat reservasi bernama
reservation-02
dengan kolomspecificReservationRequired
ditetapkan ketrue
.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 }
Buat VM yang menargetkan
reservation-02
berdasarkan nama menggunakan kolomreservationAffinity
. Untuk memakai reservasi ini dari project konsumen yang memakai reservasi bersama ini, Anda juga harus menentukan project pemilik reservasi,my-owner-project
.Pastikan properti VM sesuai dengan properti VM reservasi, termasuk zona, jenis mesin (kelompok mesin, vCPU, dan memori), platform CPU minimum, jumlah dan jenis GPU, serta antarmuka dan ukuran SSD lokal.
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" ] } }
Tetapkan properti afinitas reservasi VM agar secara eksplisit tidak menggunakan reservasi apa pun seperti yang dijelaskan di bagian ini.
Pastikan VM Anda tidak cocok dengan properti VM reservasi.
Di konsol Google Cloud, buka halaman Create an instance.
Di kolom Nama, masukkan nama untuk VM.
Di daftar Region dan Zone, pilih region dan zona tempat VM akan dibuat.
Di bagian Machine configuration, tentukan jenis mesin yang akan digunakan untuk VM.
Luaskan bagian Opsi lanjutan, lalu lakukan hal berikut:
Luaskan bagian Management.
Di bagian Reservations, dalam daftar Application policy, pilih Don't use.
Klik Create.
VM_NAME
: nama VM.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk VM.ZONE
: zona tempat untuk membuat VM.PROJECT_ID
: ID project tempat VM akan dibuat.ZONE
: zona tempat untuk membuat VM.VM_NAME
: nama VM.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk VM.IMAGE_PROJECT
: project image yang berisi image OS, misalnya,debian-cloud
. Untuk informasi selengkapnya tentang project image yang didukung, lihat Image publik.IMAGE
: tentukan salah satu dari hal berikut:Versi tertentu dari image OS—misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Tindakan ini menentukan image OS terbaru yang masih digunakan. Misalnya, jika Anda menentukanfamily/debian-12
, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.
Di konsol Google Cloud, buka halaman Create an instance template.
Di kolom Name, masukkan nama untuk template instance.
Di bagian Location, tentukan apakah Anda ingin membuat template instance regional (default) atau global.
Di bagian Machine configuration, tentukan jenis mesin yang akan digunakan untuk VM yang dibuat menggunakan template.
Luaskan bagian Opsi lanjutan, lalu lakukan hal berikut:
Luaskan bagian Management.
Di bagian Reservations, dalam daftar Application policy, pilih Don't use.
Klik Create.
INSTANCE_TEMPLATE_NAME
: nama template instance.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk VM yang dibuat menggunakan template instance.Untuk membuat template instance global: metode
instanceTemplates.insert
.Untuk membuat template instance regional: metode
regionInstanceTemplates.insert
.PROJECT_ID
: ID project tempat membuat template instance.INSTANCE_TEMPLATE_NAME
: nama template instance.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk VM yang dibuat menggunakan template instance.IMAGE_PROJECT
: project image yang berisi image OS, misalnya,debian-cloud
. Untuk informasi selengkapnya tentang project image yang didukung, lihat Image publik.IMAGE
: tentukan salah satu dari hal berikut:Versi tertentu dari image OS—misalnya,
debian-12-bookworm-v20240617
.Kelompok image, yang harus diformat sebagai
family/IMAGE_FAMILY
. Tindakan ini menentukan image OS terbaru yang masih digunakan. Misalnya, jika Anda menentukanfamily/debian-12
, versi terbaru dalam kelompok image Debian 12 akan digunakan. Untuk mengetahui informasi selengkapnya tentang penggunaan kelompok image, lihat Praktik terbaik kelompok image.
Hapus atau perbarui reservasi tertentu yang Anda gunakan untuk pengujian.
Hapus VM atau perbarui VM tersebut agar memiliki afinitas reservasi yang berbeda (
reservationAffinity
).-
Jika jumlah VM yang menggunakan reservasi meningkat sebesar 1 setelah Anda membuat atau mengupdate VM, tindakan Anda mungkin menyebabkan VM mulai menggunakan reservasi. Ini adalah cara tercepat untuk memeriksa apakah pemesanan sedang digunakan. Namun, metode ini mungkin tidak berfungsi dengan baik untuk memverifikasi VM mana yang memakai reservasi.
Membuat VM untuk menargetkan reservasi tertentu
Jika Anda berhasil membuat VM yang menargetkan reservasi tertentu, VM akan memakai reservasi. Ini adalah metode yang paling andal untuk memverifikasi bahwa VM tertentu memakai reservasi dan properti VM cocok dengan properti reservasi.
Memantau pemakaian reservasi Anda
Dengan menggunakan Cloud Monitoring, Anda dapat mengakses dan melihat informasi yang terkait dengan pemakaian reservasi yang dibuat dalam project Anda. Monitoring memperbarui data konsumsi pemesanan Anda setidaknya sekali setiap 30 menit. Metode ini berguna untuk memverifikasi tren pemakaian dari satu atau beberapa reservasi dalam project, serta menerima notifikasi untuk reservasi yang jarang digunakan atau tidak digunakan.
Melihat histori penggunaan reservasi Anda
Dengan menggunakan Capacity Planner (Pratinjau), Anda dapat mengakses dan melihat histori penggunaan reservasi dari pembuatan hingga penghapusannya. Capacity Planner memperbarui data konsumsi pemesanan setiap 24 jam. Metode ini berguna untuk memverifikasi penggunaan pemesanan Anda sebelumnya dalam project, folder, atau organisasi, serta membantu Anda merencanakan kebutuhan kapasitas di masa mendatang.
- Resource yang direservasi sedang digunakan. Entri ini muncul sebagai vCPU, memori, GPU, dan resource SSD lokal normal.
- Resource yang direservasi tidak sedang digunakan. Entri ini memiliki nama SKU normal dan URI resource reservasi.
- Total resource yang direservasi. Entri ini memiliki nama SKU reservasi dan URI resource reservasi. Tidak ada biaya yang terkait dengan entri ini. Gunakan entri ini untuk menghitung jumlah reservasi yang Anda gunakan.
- Baris 1 menunjukkan RAM yang direservasi saat ini sedang digunakan. Baris
ResourceId
menunjukkan bahwa RAM ini digunakan oleh VM bernamamy-instance
. - Baris 2 menunjukkan RAM yang direservasi sedang tidak digunakan. Baris
ResourceId
menunjukkan bahwa RAM yang direservasi ini dipegang olehmy-reservation
; belum digunakan oleh VM mana pun. - Baris 3 menunjukkan total RAM yang direservasi untuk reservasi.
- Pelajari cara memantau pemakaian reservasi.
- Pelajari cara mengubah reservasi.
- Pelajari cara menghapus pemesanan.
Go
Untuk menggunakan contoh Go di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Untuk informasi selengkapnya, lihat Set up authentication for a local development environment.
Java
Untuk menggunakan contoh Java di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Untuk informasi selengkapnya, lihat Set up authentication for a local development environment.
Node.js
Untuk menggunakan contoh Node.js di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Untuk informasi selengkapnya, lihat Set up authentication for a local development environment.
Python
Untuk menggunakan contoh Python di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.
Untuk informasi selengkapnya, lihat Set up authentication for a local development environment.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Untuk informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan guna menggunakan reservasi, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (
roles/compute.instanceAdmin.v1
) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.Peran yang telah ditentukan ini berisi izin yang diperlukan untuk menggunakan reservasi. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk menggunakan reservasi:
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Menggunakan VM yang direservasi
Saat Anda membuat instance virtual machine (VM), VM mulai memakai reservasi hanya jika properti untuk VM dan reservasi cocok. Selain itu, Anda harus menetapkan properti afinitas reservasi VM ke salah satu opsi berikut:
Menggunakan VM dari reservasi yang cocok
Dalam model pemakaian ini, VM lama dan baru akan otomatis memakai reservasi jika propertinya sesuai dengan properti VM yang ditentukan di reservasi.
Saat menggunakan model pemakaian ini, VM dalam project saat ini memakai semua reservasi satu project terlebih dahulu sebelum memakai reservasi bersama. Untuk mengetahui informasi selengkapnya tentang cara reservasi digunakan secara otomatis, lihat urutan pemakaian.
Saat Anda membuat reservasi, ini adalah model pemakaian default, selama Anda tidak menggunakan tanda atau opsi yang menunjukkan bahwa reservasi tertentu diperlukan.
Konsol
gcloud
Go
Java
Node.js
Python
REST
Menggunakan VM dari reservasi tertentu
Dalam model pemakaian ini, hanya VM baru yang menargetkan reservasi tertentu berdasarkan nama yang dapat memakai reservasi tersebut, dan reservasi otomatis tidak digunakan.
Saat membuat reservasi, tentukan bahwa VM diwajibkan untuk menargetkan reservasi tertentu memakai salah satu metode berikut:
Lalu, buat VM yang secara khusus menargetkan reservasi tersebut. Anda hanya dapat membuat VM yang menargetkan reservasi tertentu jika properti VM dan properti reservasi cocok. Jika tidak, pembuatan VM akan gagal.
Jika Anda menggunakan template instance untuk membuat VM di grup instance terkelola regional, buat reservasi yang identik dengan nama yang sama di setiap zona yang berlaku. Kemudian, targetkan reservasi berdasarkan nama di template instance grup.
Misalnya, buat reservasi spesifik bernama
reservation-02
, lalu buat VM yang cocok yang menargetkan reservasi tersebut dan yang cocok dengan properti VM reservasi.Bergantung pada jenis VM yang ingin Anda pakai, ikuti langkah-langkah untuk Memakai reservasi project tunggal tertentu atau Memakai reservasi bersama tertentu.
Memakai reservasi satu project tertentu
Untuk menggunakan reservasi satu project tertentu, pilih salah satu opsi berikut:
Konsol
gcloud
Go
Java
Node.js
Python
REST
Memakai reservasi bersama tertentu
Untuk menggunakan reservasi bersama tertentu, pilih salah satu opsi berikut:
Konsol
gcloud
Go
Java
Python
REST
Membuat VM tanpa memakai reservasi
Jika Anda membuat reservasi yang digunakan secara otomatis, VM apa pun yang berjalan dengan properti yang cocok di project Anda dapat menggunakan reservasi. Untuk mencegah satu atau beberapa VM Anda menggunakan pemesanan, lakukan tindakan berikut:
Untuk membuat VM yang secara eksplisit tidak menggunakan reservasi, pilih salah satu metode berikut:
Membuat VM agar tidak menggunakan reservasi
Untuk membuat VM yang secara eksplisit tidak menggunakan reservasi, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat VM yang secara eksplisit tidak menggunakan reservasi, gunakan perintah
gcloud compute instances create
dengan flag--reservation-affinity=none
.gcloud compute instances create VM_NAME \ --machine-type=MACHINE_TYPE \ --reservation-affinity=none \ --zone=ZONE
Ganti kode berikut:
Go
Java
Node.js
Python
REST
Untuk membuat VM yang secara eksplisit tidak menggunakan reservasi, buat permintaan
POST
ke metodeinstances.insert
. Dalam isi permintaan, sertakan kolomconsumeReservationType
yang ditetapkan keNO_RESERVATION
.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" } }
Ganti kode berikut:
Untuk mengetahui informasi selengkapnya tentang cara membuat VM, lihat Membuat dan memulai instance Compute Engine.
Membuat template instance agar tidak menggunakan reservasi
Untuk membuat template instance yang membuat VM yang tidak secara eksplisit menggunakan reservasi, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat template instance yang membuat VM yang tidak secara eksplisit menggunakan pemesanan, gunakan perintah
gcloud compute instances-templates create
dengan flag--reservation-affinity=none
.Misalnya, untuk membuat template instance global yang membuat VM yang tidak secara eksplisit menggunakan reservasi, jalankan perintah berikut:
gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \ --machine-type=MACHINE_TYPE \ --reservation-affinity=none
Ganti kode berikut:
Go
Java
Node.js
Python
REST
Untuk membuat template instance yang membuat VM yang tidak secara eksplisit menggunakan reservasi, buat permintaan
POST
ke salah satu metode berikut:Dalam isi permintaan, sertakan kolom
consumeReservationType
dan tetapkan keNO_RESERVATION
.Misalnya, untuk membuat template instance global yang membuat VM yang tidak secara eksplisit menggunakan reservasi, buat permintaan sebagai berikut:
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" } } }
Ganti kode berikut:
Untuk mengetahui informasi selengkapnya tentang cara membuat template instance, baca Membuat template instance.
Menguji apakah properti VM cocok dengan reservasi
Untuk menguji apakah VM dapat memakai reservasi secara otomatis, Anda dapat membuat salinan reservasi sebagai reservasi tertentu, lalu melihat apakah VM yang akan Anda buat dapat memakai reservasi tersebut. Jika berhasil membuat VM, berarti Anda telah memverifikasi bahwa VM dapat memakai reservasi yang cocok dengan benar. Jika tidak, pembuatan VM akan gagal karena properti tidak cocok atau ada resource yang dipesan tidak tersedia. Setelah pengujian, Anda dapat melakukan satu atau beberapa hal berikut:
Memverifikasi pemakaian reservasi
Untuk memastikan VM menggunakan reservasi secara efektif, Anda dapat memverifikasi penggunaannya menggunakan metode berikut:
Jika Anda melihat bahwa VM tidak menggunakan reservasi setelah memverifikasi bahwa afinitas reservasi VM dapat menggunakan reservasi, reservasi tidak digunakan sepenuhnya, dan VM serta properti reservasi cocok, lihat Ketersediaan resource.
Melihat laporan penggunaan reservasi
Ekspor laporan mendetail tentang penggunaan Compute Engine ke bucket Cloud Storage menggunakan fitur ekspor penggunaan. Untuk mengetahui petunjuknya, lihat Melihat laporan penggunaan.
Laporan penggunaan menunjukkan hal berikut:
Pengukuran Format MeasurementId
Format Resource URI
Resource yang direservasi sedang digunakan com.google.cloud/services/compute-engine/SKU_NAME
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/RESOURCE_TYPE/RESOURCE_NAME
.
Misalnya,https://compute.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/my-instance
Resource yang direservasi sedang tidak digunakan com.google.cloud/services/compute-engine/SKU_NAME
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
.
Misalnya,https://compute.googleapis.com/compute/v1/projects/my-project/zones/europe-west1-b/reservations/my-reservation
Total resource yang direservasi com.google.cloud/services/compute-engine/ReservationSKU_NAME
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME
.
Misalnya,https://compute.googleapis.com/compute/v1/projects/my-project/zones/europe-west1-b/reservations/my-reservation
Misalnya, dalam cuplikan berikut dari laporan penggunaan untuk reservasi bernama
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 ...
Memecahkan masalah
Pelajari cara memecahkan masalah terkait pemakaian reservasi.
Langkah selanjutnya
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-12-22 UTC.
-