Dokumen ini menjelaskan cara membuat pemesanan satu project, yang hanya dapat digunakan oleh instance virtual machine (VM) dalam project yang sama. Untuk mempelajari pemesanan lebih lanjut, lihat Pemesanan resource zona Compute Engine.
Untuk metode pembuatan pemesanan yang lain, lihat halaman berikut:
Jika Anda memiliki komitmen 1 tahun atau 3 tahun dalam project saat ini, resource yang dipesan akan otomatis menerima diskon abonemen yang berlaku. Anda juga bisa membuat dan melampirkan pemesanan ke komitmen saat membelinya. Untuk mempelajari lebih lanjut, lihat Melampirkan pemesanan ke komitmen.
Untuk membuat pemesanan yang dapat digunakan oleh beberapa project, lihat Membuat pemesanan bersama.
Sebelum memulai
- Tinjau persyaratan dan pembatasan 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.
-
compute.reservations.create
pada project -
Untuk menentukan template instance:
compute.instanceTemplates.useReadOnly
pada template instance Direkomendasikan: Menentukan template instance
Bagian ini menjelaskan cara menggunakan template instance untuk menentukan properti pemesanan. Dengan menggunakan template instance, Anda dapat menentukan properti pemesanan dan VM yang dapat menggunakan pemesanan di tempat yang sama.
-
Bagian ini menjelaskan cara menggunakan VM yang ada untuk menentukan properti pemesanan. Dengan menggunakan properti VM yang ada, Anda dapat menggunakan reservasi dengan membuat VM dengan properti yang cocok dengan VM referensi.
Menentukan properti secara langsung
Bagian ini menjelaskan cara menentukan properti pemesanan secara langsung. Metode ini mengharuskan Anda secara manual memastikan bahwa properti VM dan pemesanan Anda sama persis—setiap properti yang tidak cocok akan mencegah pemakaian.
Buat pemesanan yang hanya dapat dipakai oleh VM yang secara khusus menargetkannya, seperti yang dijelaskan di bagian berikut dalam dokumen ini. Kemudian, konfigurasi VM untuk memakai pemesanan tersebut.
Konfigurasi VM yang tidak dapat memakai pemesanan apa pun.
Buat pemesanan di region dan zona yang sama dengan resource dalam template instance. Setiap resource regional atau resource zona yang ditentukan dalam template instance—seperti jenis mesin atau volume Disk Permanen—akan membatasi penggunaan template ke lokasi tempat resource tersebut berada. Misalnya, jika template instance Anda menentukan volume Persistent Disk yang ada di zona
us-central1-a
, Anda hanya dapat membuat reservasi di zona yang sama. Untuk memeriksa apakah template yang ada menentukan resource yang mengikat template ke region atau zona tertentu, lihat detail template instance dan cari referensi ke resource regional atau resource zona yang ada di dalamnya.Jika template instance menentukan kebijakan penempatan rapat, pastikan template menentukan jenis mesin yang didukung untuk kebijakan penempatan rapat. Jika tidak, pembuatan pemesanan akan gagal.
Di Konsol Google Cloud, buka halaman Pemesanan.
Di tab Pemesanan sesuai permintaan (default), klik
Buat pemesanan.Halaman Create a reservation akan terbuka.
Untuk Nama, masukkan nama untuk pemesanan Anda.
Untuk Region dan Zone, pilih tempat Anda ingin memesan resource.
Di bagian Jenis berbagi, pilih Lokal jika belum dipilih.
Opsional: Untuk mengizinkan reservasi VM GPU digunakan oleh tugas pelatihan kustom atau tugas prediksi di Vertex AI, di bagian Layanan Google Cloud, pilih Bagikan reservasi.
Di bagian Gunakan dengan instance VM, pilih salah satu opsi berikut:
Untuk mengizinkan VM yang cocok menggunakan pemesanan ini secara otomatis, pilih Gunakan pemesanan secara otomatis jika belum dipilih.
Untuk menggunakan resource pemesanan ini hanya saat membuat VM yang sama persis yang secara khusus menargetkan pemesanan ini berdasarkan nama, pilih Pilih pemesanan tertentu.
Untuk Number of VM instances, masukkan jumlah VM yang ingin Anda pesan.
Di bagian Machine configuration, lakukan hal berikut:
Untuk menentukan properti VM Anda dari template instance yang ada, pilih Gunakan template instance.
Di kolom Template instance, pilih template instance pilihan Anda. Jika memilih template instance regional, Anda hanya dapat memesan resource dalam region template instance.
Di bagian Auto-delete, Anda dapat mengaktifkan opsi hapus otomatis agar Compute Engine otomatis menghapus reservasi pada tanggal dan waktu tertentu. Menghapus otomatis pemesanan dapat berguna untuk menghindari biaya yang tidak perlu saat Anda berhenti menggunakan pemesanan.
Untuk membuat pemesanan, klik Buat.
Halaman Reservations akan terbuka. Pembuatan pemesanan satu project mungkin memerlukan waktu hingga satu menit untuk diselesaikan.
RESERVATION_NAME
: nama pemesanan yang akan dibuat.PROJECT_ID
: ID project tempat Anda ingin memesan resource dan tempat template instance berada.LOCATION
: lokasi template instance. Tentukan salah satu nilai berikut:Untuk template instance global:
global
.Untuk template instance regional:
regions/REGION
. GantiREGION
dengan region tempat template instance berada. Jika menentukan template instance regional, Anda hanya dapat memesan VM dalam region yang sama dengan region template.
INSTANCE_TEMPLATE_NAME
: nama template instance yang ada. Jika template instance menentukan jenis mesin A3 atau kebijakan penempatan yang ringkas, Anda harus menyertakan flag--require-specific-reservation
. Hal ini menunjukkan bahwa hanya VM yang secara khusus menargetkan pemesanan yang dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Menggunakan VM dari reservasi tertentu.NUMBER_OF_VMS
: jumlah VM yang akan dipesan.ZONE
: zona tempat memesan resource.Untuk menentukan bahwa hanya VM yang secara khusus menargetkan pemesanan ini yang dapat menggunakannya, sertakan flag
--require-specific-reservation
.gcloud compute reservations create RESERVATION_NAME \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --require-specific-reservation \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Untuk mengizinkan pemesanan VM GPU digunakan oleh tugas pelatihan kustom atau tugas prediksi di Vertex AI, gunakan perintah
gcloud beta compute reservations create
dengan flag--reservation-sharing-policy=ALLOW_ALL
.gcloud beta compute reservations create RESERVATION_NAME \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --reservation-sharing-policy=ALLOW_ALL \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Agar Compute Engine dapat otomatis menghapus reservasi, pilih salah satu metode berikut:
Untuk menghapus reservasi pada tanggal dan waktu tertentu, gunakan perintah
gcloud beta compute reservations create
dengan flag--delete-at-time
.gcloud beta compute reservations create RESERVATION_NAME \ --delete-at-time=DELETE_AT_TIME \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti
DELETE_AT_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:none YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: tanggal yang diformat sebagai tahun 4 digit, bulan 2 digit, dan hari 2 digit dalam sebulan, dipisahkan oleh tanda hubung (-
).HH:MM:SS
: waktu yang diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit, yang dipisahkan oleh titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
Untuk menghapus pemesanan setelah durasi tertentu, gunakan perintah
gcloud beta compute reservations create
dengan flag--delete-after-duration
.gcloud beta compute reservations create RESERVATION_NAME \ --delete-after-duration=DELETE_AFTER_DURATION \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti
DELETE_AFTER_DURATION
dengan durasi dalam hari, jam, menit, atau detik. Misalnya, tentukan30m
selama 30 menit, atau1d2h3m4s
untuk 1 hari, 2 jam, 3 menit, dan 4 detik.
PROJECT_ID
: ID project tempat Anda ingin memesan resource dan tempat template instance berada.ZONE
: zona tempat memesan resource.RESERVATION_NAME
: nama pemesanan yang akan dibuat.NUMBER_OF_VMS
: jumlah VM yang akan dipesan.LOCATION
: lokasi template instance. Tentukan salah satu nilai berikut:Untuk template instance global:
global
.Untuk template instance regional:
regions/REGION
. GantiREGION
dengan region tempat template instance berada. Jika menentukan template instance regional, Anda hanya dapat memesan VM dalam region yang sama dengan region template.
INSTANCE_TEMPLATE_NAME
: nama template instance yang ada. Jika template instance menentukan jenis mesin A3 atau kebijakan penempatan ringkas, Anda harus menyertakan kolomspecificReservationRequired
dalam isi permintaan, dan menetapkan kolom ketrue
. Hal ini menunjukkan bahwa hanya VM yang secara khusus menargetkan reservasi ini yang dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Menggunakan VM dari reservasi tertentu.Untuk menentukan bahwa hanya VM yang secara khusus menargetkan pemesanan ini yang dapat menggunakannya, sertakan kolom
specificReservationRequired
dalam isi permintaan, dan tetapkan kolom ketrue
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME" }, "specificReservationRequired": true }
Untuk mengizinkan reservasi VM GPU digunakan oleh tugas pelatihan kustom atau tugas prediksi di Vertex AI, buat permintaan
POST
ke metodebeta.reservations.insert
. Dalam isi permintaan, sertakan kolomserviceShareType
dan tetapkan keALLOW_ALL
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "reservationSharingPolicy": { "serviceShareType": "ALLOW_ALL" }, "specificReservation": { "count": "NUMBER_OF_VMS", "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME" } }
Agar Compute Engine dapat otomatis menghapus reservasi, pilih salah satu metode berikut:
Untuk menghapus pemesanan pada tanggal dan waktu tertentu, buat permintaan
POST
ke metodebeta.reservations.insert
. Dalam isi permintaan, sertakan kolomdeleteAtTime
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations { "deleteAtTime": "DELETE_AT_TIME", "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME" } }
Ganti
DELETE_AT_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: tanggal yang diformat sebagai tahun 4 digit, bulan 2 digit, dan hari 2 digit dalam sebulan, dipisahkan oleh tanda hubung (-
).HH:MM:SS
: waktu yang diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit, yang dipisahkan oleh titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
Untuk menghapus pemesanan setelah durasi tertentu, buat permintaan
POST
ke metodebeta.reservations.insert
. Dalam isi permintaan, sertakan kolomdeleteAfterDuration
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations { "deleteAfterDuration": { "seconds": "DELETE_AFTER_DURATION" }, "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME" } }
Ganti
DELETE_AFTER_DURATION
dengan durasi dalam detik. Misalnya, tentukan86400
selama 86.400 detik (1 hari).
Buat dan gunakan template instance sebagai berikut:
Buat template instance berdasarkan VM referensi tanpa mengganti properti VM referensi.
Buat VM menggunakan template yang baru dibuat dengan melakukan salah satu atau kedua hal berikut:
Buat VM berdasarkan VM referensi sambil memastikan bahwa properti VM baru dan VM referensi sama persis.
Di konsol Google Cloud, buka halaman Reservations.
Klik
Create reservation.Halaman Create a reservation akan terbuka.
Untuk Nama, masukkan nama untuk pemesanan Anda.
Untuk Region dan Zone, pilih tempat Anda ingin memesan resource.
Di bagian Jenis berbagi, klik Lokal jika belum dipilih.
Di bagian Gunakan dengan instance VM, pilih salah satu opsi berikut:
Untuk mengizinkan VM yang cocok menggunakan reservasi ini secara otomatis, pilih Gunakan pemesanan secara otomatis jika belum dipilih.
Untuk menggunakan resource pemesanan ini hanya saat membuat VM yang sama persis yang secara khusus menargetkan pemesanan ini berdasarkan nama, pilih Pilih pemesanan tertentu.
Untuk Number of VM instances, masukkan jumlah VM yang ingin Anda pesan.
Di bagian Machine configuration, lakukan hal berikut:
Pilih Gunakan VM yang ada.
Untuk VM yang Ada, pilih VM yang propertinya ingin Anda gunakan untuk membuat reservasi.
Opsional: Untuk menentukan kebijakan penempatan rapat untuk reservasi yang memenuhi persyaratan, di bagian Group placement policy, klik daftar Select or create a group placement policy, lalu lakukan salah satu hal berikut:
Untuk membuat kebijakan penempatan rapat yang akan ditentukan dalam pemesanan ini, lakukan hal berikut:
Klik Create group placement policy.
Panel Create a group placement policy akan muncul.
Untuk Nama kebijakan, masukkan nama untuk kebijakan Anda.
Klik Create.
Pembuatan kebijakan penempatan rapat mungkin memerlukan waktu beberapa detik untuk selesai.
Jika tidak, pilih kebijakan penempatan yang ringkas yang ada.
Di bagian Auto-delete, Anda dapat mengaktifkan opsi hapus otomatis agar Compute Engine otomatis menghapus pemesanan pada tanggal dan waktu tertentu. Menghapus otomatis pemesanan dapat berguna untuk menghindari biaya yang tidak perlu saat Anda berhenti menggunakan pemesanan.
Untuk membuat pemesanan, klik Buat.
Halaman Reservations akan terbuka. Mungkin perlu waktu hingga satu menit untuk menyelesaikan pembuatan pemesanan.
Di Konsol Google Cloud, buka halaman Pemesanan.
Di tab Pemesanan sesuai permintaan (default), klik
Buat pemesanan.Halaman Create a reservation akan terbuka.
Untuk Nama, masukkan nama untuk pemesanan Anda.
Untuk Region dan Zone, pilih tempat Anda ingin memesan resource.
Di bagian Jenis berbagi, klik Lokal jika belum dipilih.
Opsional: Untuk mengizinkan reservasi VM GPU digunakan oleh tugas pelatihan kustom atau tugas prediksi di Vertex AI, di bagian Layanan Google Cloud, pilih Bagikan reservasi.
Di bagian Gunakan dengan instance VM, pilih salah satu opsi berikut:
Untuk mengizinkan VM yang cocok menggunakan pemesanan ini secara otomatis, pilih Gunakan pemesanan secara otomatis jika belum dipilih.
Untuk menggunakan resource pemesanan ini hanya saat membuat VM yang sama persis yang secara khusus menargetkan pemesanan ini berdasarkan nama, pilih Pilih pemesanan tertentu.
Untuk Number of VM instances, masukkan jumlah VM yang ingin Anda pesan.
Di bagian Konfigurasi mesin, pilih Tentukan jenis mesin, lalu tentukan hal berikut:
Untuk Machine family, Series, dan Machine type, pilih kelompok mesin, seri, dan jenis mesin.
Opsional: Untuk menentukan platform CPU minimum atau memasang GPU ke VM N1, lakukan hal berikut:
Untuk meluaskan bagian CPU Platform and GPU, klik peluas
.Opsional: Untuk menentukan platform CPU minimum, untuk CPU Platform, pilih salah satu opsi.
Opsional: Untuk memasang GPU ke VM N1, klik
Tambahkan GPU. Kemudian, untuk GPU type dan Number of GPUs, pilih jenis dan jumlah GPU yang akan dilampirkan ke setiap VM N1.
Opsional: Untuk menambahkan disk SSD Lokal, lakukan hal berikut:
Untuk Jumlah disk, pilih jumlah disk SSD Lokal untuk setiap VM.
Untuk Jenis antarmuka, pilih antarmuka untuk disk SSD Lokal.
Opsional: Untuk menentukan kebijakan penempatan rapat untuk pemesanan yang memenuhi persyaratan, klik daftar Select or create a group placement policy, lalu lakukan salah satu tindakan berikut:
Untuk membuat kebijakan penempatan rapat yang akan ditentukan dalam pemesanan ini, ikuti langkah-langkah berikut:
Klik Create group placement policy.
Panel Create a group placement policy akan muncul.
Untuk Nama kebijakan, masukkan nama untuk kebijakan Anda.
Klik Create.
Pembuatan kebijakan penempatan rapat mungkin memerlukan waktu beberapa detik untuk diselesaikan.
Jika tidak, pilih kebijakan penempatan yang ringkas yang ada.
Opsional: Untuk menentukan kebijakan penempatan ringkas untuk reservasi yang memenuhi persyaratan, di bagian Group placement policy, klik daftar Select or create a group placement policy, lalu lakukan salah satu hal berikut:
Untuk membuat kebijakan penempatan rapat yang akan ditentukan dalam pemesanan ini, lakukan tindakan berikut:
Klik Buat kebijakan penempatan grup.
Panel Create a group placement policy akan muncul.
Untuk Nama kebijakan, masukkan nama untuk kebijakan Anda.
Klik Create.
Pembuatan kebijakan penempatan rapat mungkin memerlukan waktu beberapa detik untuk diselesaikan.
Jika tidak, pilih kebijakan penempatan yang ringkas yang ada.
Di bagian Auto-delete, Anda dapat mengaktifkan opsi hapus otomatis agar Compute Engine otomatis menghapus reservasi pada tanggal dan waktu tertentu. Menghapus otomatis pemesanan dapat berguna untuk menghindari biaya yang tidak perlu saat Anda berhenti menggunakan pemesanan.
Untuk membuat pemesanan, klik Buat.
Halaman Reservations akan terbuka. Pembuatan pemesanan satu project mungkin memerlukan waktu hingga satu menit untuk diselesaikan.
RESERVATION_NAME
: nama pemesanan yang akan dibuat.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk setiap VM. Jika menentukan jenis mesin A3, Anda harus menyertakan flag--require-specific-reservation
. Hal ini menunjukkan bahwa hanya VM yang secara khusus menargetkan pemesanan yang dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Menggunakan VM dari reservasi tertentu.NUMBER_OF_VMS
: jumlah VM yang akan dipesan.ZONE
: zona tempat memesan resource.Untuk memasang GPU ke VM N1 yang dipesan, sertakan flag
--accelerator
.gcloud compute reservations create RESERVATION_NAME \ --accelerator=count=NUMBER_OF_ACCELERATORS,type=ACCELERATOR_TYPE --machine-type=MACHINE_TYPE \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti kode berikut:
NUMBER_OF_ACCELERATORS
: jumlah GPU yang akan ditambahkan per VM yang dipesan.ACCELERATOR_TYPE
: model GPU yang didukung untuk VM N1. Pastikan model GPU yang Anda pilih tersedia di zona tempat Anda ingin memesan resource. Jika tidak, pembuatan pemesanan akan gagal.
Untuk menambahkan satu atau beberapa disk SSD Lokal ke setiap VM yang direservasi, sertakan satu atau beberapa flag
--local-ssd
. Anda dapat menentukan hingga 24 disk SSD Lokal. Ukuran setiap disk SSD Lokal adalah 375 GB.Misalnya, untuk menentukan dua disk SSD Lokal saat membuat reservasi, sertakan dua flag
--local-ssd
sebagai berikut:gcloud compute reservations create RESERVATION_NAME \ --local-ssd=size=375,interface=INTERFACE_1 \ --local-ssd=size=375,interface=INTERFACE_2 \ --machine-type=MACHINE_TYPE \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti
INTERFACE_1
danINTERFACE_2
dengan jenis antarmuka yang ingin digunakan setiap disk SSD Lokal. Tentukan salah satu nilai berikut:Antarmuka disk NVME:
nvme
Antarmuka disk SCSI:
scsi
Pastikan jenis mesin yang Anda tentukan untuk VM yang direservasi mendukung antarmuka disk yang dipilih. Jika tidak, pembuatan pemesanan akan gagal. Untuk informasi selengkapnya, lihat cara memilih antarmuka disk.
Agar VM yang dipesan menggunakan platform CPU minimum tertentu, bukan platform CPU default zona, sertakan flag
--min-cpu-platform
.gcloud compute reservations create RESERVATION_NAME \ --machine-type=MACHINE_TYPE \ --min-cpu-platform="MIN_CPU_PLATFORM" \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti
MIN_CPU_PLATFORM
dengan platform CPU minimum. Untuk memastikan platform CPU tersedia di zona tempat Anda menyimpan resource, lihat platform CPU yang tersedia berdasarkan zona.Untuk menentukan bahwa hanya VM yang secara khusus menargetkan pemesanan ini yang dapat menggunakannya, sertakan flag
--require-specific-reservation
.gcloud compute reservations create RESERVATION_NAME \ --machine-type=MACHINE_TYPE \ --require-specific-reservation \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Untuk menentukan kebijakan penempatan rapat untuk latensi jaringan yang lebih rendah di antara VM, sertakan tanda
--resource-policies=policy
.gcloud compute reservations create RESERVATION_NAME \ --machine-type=MACHINE_TYPE \ --resource-policies=policy=COMPACT_PLACEMENT_POLICY_NAME \ --require-specific-reservation \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti COMPACT_PLACEMENT_POLICY_NAME dengan nama kebijakan penempatan yang ringkas yang ada. Selain itu, untuk menghindari error saat membuat pemesanan satu project yang menentukan kebijakan penempatan rapat, pastikan untuk menentukan hal berikut:
Jenis mesin yang didukung dan jumlah maksimum VM untuk kebijakan penempatan rapat.
Zona dalam region tempat kebijakan penempatan rapat berada.
Flag
--require-specific-reservation
. Hal ini menunjukkan bahwa hanya VM yang secara khusus menargetkan reservasi yang dapat menggunakannya.
Untuk mengizinkan pemesanan VM GPU digunakan oleh tugas pelatihan kustom atau tugas prediksi di Vertex AI, gunakan perintah
gcloud beta compute reservations create
dengan flag--reservation-sharing-policy=ALLOW_ALL
.gcloud beta compute reservations create RESERVATION_NAME \ --machine-type=MACHINE_TYPE \ --reservation-sharing-policy=ALLOW_ALL \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Agar Compute Engine dapat otomatis menghapus reservasi, pilih salah satu metode berikut:
Untuk menghapus reservasi pada tanggal dan waktu tertentu, gunakan perintah
gcloud beta compute reservations create
dengan flag--delete-at-time
.gcloud beta compute reservations create RESERVATION_NAME \ --delete-at-time=DELETE_AT_TIME \ --machine-type=MACHINE_TYPE \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti
DELETE_AT_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: tanggal yang diformat sebagai tahun 4 digit, bulan 2 digit, dan hari 2 digit dalam sebulan, dipisahkan oleh tanda hubung (-
).HH:MM:SS
: waktu yang diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit, yang dipisahkan oleh titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
Untuk menghapus pemesanan setelah durasi tertentu, gunakan perintah
gcloud beta compute reservations create
dengan flag--delete-after-duration
.gcloud beta compute reservations create RESERVATION_NAME \ --delete-after-duration=DELETE_AFTER_DURATION \ --machine-type=MACHINE_TYPE \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti
DELETE_AFTER_DURATION
dengan durasi dalam hari, jam, menit, atau detik. Misalnya, tentukan30m
selama 30 menit, atau1d2h3m4s
untuk 1 hari, 2 jam, 3 menit, dan 4 detik.
PROJECT_ID
: ID project tempat Anda ingin memesan resource.ZONE
: zona tempat memesan resource.RESERVATION_NAME
: nama pemesanan yang akan dibuat.NUMBER_OF_VMS
: jumlah VM yang akan dipesan.MACHINE_TYPE
: jenis mesin yang akan digunakan untuk setiap VM. Jika menentukan jenis mesin A3, Anda harus menyertakan kolomspecificReservationRequired
dalam isi permintaan, dan menetapkan kolom ketrue
. Hal ini menunjukkan bahwa hanya VM yang secara khusus menargetkan reservasi yang dapat menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Menggunakan VM dari reservasi tertentu.Untuk memasang GPU ke VM N1 yang dipesan, sertakan kolom
guestAccelerators
dalam isi permintaan.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "guestAccelerators": [ { "acceleratorCount": NUMBER_OF_ACCELERATORS, "acceleratorType": "ACCELERATOR_TYPE" } ], "machineType": "MACHINE_TYPE" } } }
Ganti kode berikut:
NUMBER_OF_ACCELERATORS
: jumlah GPU yang akan ditambahkan per VM yang dipesan.ACCELERATOR_TYPE
: model GPU yang didukung untuk VM N1. Pastikan model GPU yang Anda pilih tersedia di zona tempat Anda ingin memesan resource. Jika tidak, pembuatan pemesanan akan gagal.
Untuk menambahkan satu atau beberapa Disk SSD Lokal ke setiap VM yang dicadangkan, sertakan kolom
localSsds
dalam isi permintaan. Anda dapat menentukan hingga 24 disk SSD Lokal. Setiap disk SSD Lokal berukuran 375 GB.Misalnya, untuk menentukan dua disk SSD Lokal saat membuat reservasi, buat permintaan sebagai berikut:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "localSsds": [ { "diskSizeGb": "375", "interface": "INTERFACE_1" }, { "diskSizeGb": "375", "interface": "INTERFACE_2" } ], "machineType": "MACHINE_TYPE" } } }
Ganti
INTERFACE_1
danINTERFACE_2
dengan jenis antarmuka yang ingin digunakan setiap disk SSD Lokal. Tentukan salah satu nilai berikut:Antarmuka disk NVME:
NVME
Antarmuka disk SCSI:
SCSI
Pastikan jenis mesin yang Anda tentukan untuk VM yang direservasi mendukung antarmuka disk yang dipilih. Jika tidak, pembuatan pemesanan akan gagal. Untuk informasi selengkapnya, lihat cara memilih antarmuka disk.
Agar VM yang direservasi menggunakan platform CPU minimum tertentu, bukan platform CPU default zona, sertakan kolom
minCpuPlatform
dalam isi permintaan.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE", "minCpuPlatform": "MIN_CPU_PLATFORM" } } }
Ganti
MIN_CPU_PLATFORM
dengan platform CPU minimum. Untuk memastikan platform CPU tersedia di zona tempat Anda menyimpan resource, lihat platform CPU yang tersedia berdasarkan zona.Untuk menentukan kebijakan penempatan rapat guna mengurangi latensi jaringan di antara VM yang direservasi, sertakan kolom
resourcePolicies
dalam isi permintaan.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "resourcePolicies": { "policy" : "projects/example-project/regions/REGION/resourcePolicies/COMPACT_PLACEMENT_POLICY_NAME" }, "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE" } }, "specificReservationRequired": true }
Ganti kode berikut:
REGION
: region tempat kebijakan penempatan ringkas berada. Anda hanya dapat membuat reservasi dalam region kebijakan penempatan.COMPACT_PLACEMENT_POLICY_NAME
: nama kebijakan penempatan ringkas yang ada.
Selain itu, untuk menghindari error saat membuat pemesanan satu project yang menentukan kebijakan penempatan rapat, pastikan untuk menentukan hal berikut:
Jenis mesin yang didukung untuk kebijakan penempatan rapat.
Kolom
specificReservationRequired
ditetapkan ketrue
. Hal ini menunjukkan bahwa hanya VM yang secara khusus menargetkan pemesanan ini yang dapat menggunakannya.
Untuk menentukan bahwa hanya VM yang secara khusus menargetkan pemesanan ini yang dapat menggunakannya, sertakan kolom
specificReservationRequired
dalam isi permintaan dan tetapkan kolom ketrue
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE" } }, "specificReservationRequired": true }
Untuk mengizinkan reservasi VM GPU digunakan oleh tugas pelatihan kustom atau tugas prediksi di Vertex AI, buat permintaan
POST
ke metodebeta.reservations.insert
. Dalam isi permintaan, sertakan kolomserviceShareType
dan tetapkan keALLOW_ALL
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "reservationSharingPolicy": { "serviceShareType": "ALLOW_ALL" }, "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE" } } }
Agar Compute Engine dapat otomatis menghapus reservasi, pilih salah satu metode berikut:
Untuk menghapus pemesanan pada tanggal dan waktu tertentu, buat permintaan
POST
ke metodebeta.reservations.insert
. Dalam isi permintaan, sertakan kolomdeleteAtTime
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations { "deleteAtTime": "DELETE_AT_TIME", "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE" } } }
Ganti
DELETE_AT_TIME
dengan tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:YYYY-MM-DDTHH:MM:SSOFFSET
Ganti kode berikut:
YYYY-MM-DD
: tanggal yang diformat sebagai tahun 4 digit, bulan 2 digit, dan hari 2 digit dalam sebulan, dipisahkan oleh tanda hubung (-
).HH:MM:SS
: waktu yang diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit, yang dipisahkan oleh titik dua (:
).OFFSET
: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan-08:00
. Atau, untuk tidak menggunakan penyeimbang, tentukanZ
.
Untuk menghapus pemesanan setelah durasi tertentu, buat permintaan
POST
ke metodebeta.reservations.insert
. Dalam isi permintaan, sertakan kolomdeleteAfterDuration
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations { "deleteAfterDuration": { "seconds": "DELETE_AFTER_DURATION" }, "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE" } } }
Ganti
DELETE_AFTER_DURATION
dengan durasi dalam detik. Misalnya, tentukan86400
selama 86.400 detik (1 hari).
Pelajari cara melihat pemesanan.
Pelajari cara melampirkan pemesanan ke komitmen.
Pelajari cara menggunakan pemesanan.
Pelajari cara memantau pemakaian pemesanan.
Terraform
Untuk menggunakan contoh Terraform 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 untuk membuat pemesanan satu project, minta administrator untuk memberi Anda peran IAM Compute Admin (
roles/compute.admin
) pada 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 membuat pemesanan satu project. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat pemesanan satu project:
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Membuat pemesanan satu project
Untuk menggunakan pemesanan, VM harus memiliki properti yang sama persis dengan pemesanan tersebut. Untuk menentukan properti VM yang ingin Anda pesan, pilih salah satu bagian berikut dalam dokumen ini:
Secara default, pemesanan dapat otomatis dipakai oleh semua VM yang memiliki properti yang sama persis dengannya. Jika Anda ingin mengontrol pemakaian pemesanan, lakukan satu atau beberapa hal berikut:
Selain itu, Anda dapat menentukan kebijakan penempatan yang ringkas saat membuat pemesanan satu project. Kebijakan penempatan rapat menentukan bahwa VM harus ditempatkan sedekat mungkin satu sama lain untuk mengurangi latensi jaringan.
Menentukan template instance
Untuk menghindari error saat membuat pemesanan dengan menentukan template instance, pastikan untuk melakukan hal berikut:
Untuk membuat pemesanan satu project dengan menentukan template instance, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat reservasi satu project, gunakan perintah
gcloud compute reservations create
.Untuk membuat pemesanan satu project dengan menentukan template instance dan tanpa menyertakan flag opsional apa pun, jalankan perintah berikut:
gcloud compute reservations create RESERVATION_NAME \ --source-instance-template=projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti kode berikut:
Misalnya, untuk membuat reservasi untuk sepuluh VM di zona
us-central1-a
dengan menentukan template instance global, jalankan perintah berikut:gcloud compute reservations create my-reservation \ --source-instance-template=projects/example-project/global/example-instance-template \ --vm-count=10 \ --zone=us-central1-a
Secara opsional, Anda dapat melakukan satu atau beberapa hal berikut:
Go
Java
Node.js
Python
REST
Untuk membuat pemesanan satu project, buat permintaan
POST
ke metodereservations.insert
.Untuk membuat pemesanan satu project dengan menentukan template instance dan tanpa menyertakan tanda opsional apa pun, buat permintaan
POST
berikut:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "sourceInstanceTemplate": "projects/PROJECT_ID/LOCATION/instanceTemplates/INSTANCE_TEMPLATE_NAME" } }
Ganti kode berikut:
Misalnya, untuk membuat reservasi untuk sepuluh VM di zona
us-central1-a
dengan menentukan template instance global, buat permintaanPOST
berikut:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations { "name": "my-reservation", "specificReservation": { "count": "10", "sourceInstanceTemplate": "projects/example-project/global/instanceTemplates/example-instance-template" } }
Secara opsional, Anda dapat melakukan satu atau beberapa hal berikut:
Menentukan VM yang ada
Anda hanya dapat membuat reservasi berdasarkan VM yang ada di zona yang sama dengan VM.
Setelah membuat reservasi, Anda dapat menggunakannya dengan membuat VM dengan properti yang cocok dengan VM referensi. Anda dapat melakukannya dengan melakukan salah satu hal berikut:
Untuk membuat reservasi satu project yang menggunakan properti VM yang ada, lakukan hal berikut:
Menentukan properti secara langsung
Untuk membuat pemesanan satu project dengan menentukan properti secara langsung, pilih salah satu opsi berikut:
Konsol
gcloud
Untuk membuat reservasi satu project, gunakan perintah
gcloud compute reservations create
.Untuk membuat pemesanan satu project dengan menentukan properti secara langsung dan tanpa menyertakan flag opsional, jalankan perintah berikut:
gcloud compute reservations create RESERVATION_NAME \ --machine-type=MACHINE_TYPE \ --vm-count=NUMBER_OF_VMS \ --zone=ZONE
Ganti kode berikut:
Misalnya, untuk membuat reservasi di zona
us-central1-a
untuk sepuluh VM yang masing-masing menggunakan jenis mesin standar N2 dengan 4 vCPU, jalankan perintah berikut:gcloud compute reservations create my-reservation \ --machine-type=n2-standard-4 \ --vm-count=10 \ --zone=us-central1-a
Secara opsional, Anda dapat melakukan satu atau beberapa hal berikut:
Go
Java
Node.js
Python
Terraform
Untuk membuat pemesanan satu project, gunakan resource Terraform
google_compute_reservation
.Misalnya, untuk membuat pemesanan satu project untuk satu jenis mesin standar N2 dengan 2 vCPU, gunakan resource berikut:
Untuk informasi selengkapnya tentang cara menggunakan Terraform, baca artikel Menggunakan Terraform dengan Google Cloud.
REST
Untuk membuat pemesanan satu project, buat permintaan
POST
ke metodereservations.insert
.Untuk membuat pemesanan satu project dengan menentukan properti secara langsung dan tanpa menyertakan kolom opsional apa pun, buat permintaan
POST
berikut:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations { "name": "RESERVATION_NAME", "specificReservation": { "count": "NUMBER_OF_VMS", "instanceProperties": { "machineType": "MACHINE_TYPE" } } }
Ganti kode berikut:
Misalnya, untuk membuat reservasi di zona
us-central1-a
untuk sepuluh VM yang masing-masing menggunakan jenis mesin N2 yang telah ditetapkan dengan 4 vCPU, buat permintaanPOST
berikut:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/reservations { "name": "my-reservation", "specificReservation": { "count": "10", "instanceProperties": { "machineType": "n2-standard-4", } } }
Secara opsional, Anda dapat melakukan satu atau beberapa hal berikut:
Pemecahan masalah
Pelajari cara memecahkan masalah pembuatan pemesanan.
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.
-