Membuat VM yang menggunakan model terikat reservasi

Dokumen ini menjelaskan cara membuat instance virtual machine (VM) mandiri menggunakan model penyediaan terikat reservasi. Model penyediaan ini memungkinkan Anda membuat VM A4X, A4, atau A3 Ultra dengan menggunakan kapasitas yang telah dipesan.

Untuk metode lain dalam membuat VM menggunakan model penyediaan yang terikat dengan reservasi, lihat Ringkasan opsi deployment di dokumentasi AI Hypercomputer.

Sebelum memulai

• Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi 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

  1. Menginstal Google Cloud CLI. Setelah penginstalan, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

     gcloud init

     Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

     Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.
  2. Set a default region and zone.

  REST

  Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.

  Menginstal Google Cloud CLI. Setelah penginstalan, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

  gcloud init

  Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.

  Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Peran yang diperlukan

Agar mendapatkan izin yang Anda perlukan untuk membuat VM menggunakan model penyediaan terikat 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 bawaan ini berisi izin yang diperlukan untuk membuat VM menggunakan model penyediaan terikat reservasi. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat VM menggunakan model penyediaan terikat reservasi:

• compute.instances.create di 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 pada template instance
• Untuk menentukan subnet bagi VM Anda: compute.subnetworks.use di project atau di subnet yang dipilih
• Untuk menentukan alamat IP statis untuk VM: compute.addresses.use pada project
• Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan VPC: compute.subnetworks.useExternalIp di project atau di subnet yang dipilih
• Untuk menetapkan jaringan lama ke VM: compute.networks.use pada project
• Untuk menetapkan alamat IP eksternal ke VM saat menggunakan jaringan lama: compute.networks.useExternalIp di project
• Untuk menetapkan metadata instance VM bagi VM: compute.instances.setMetadata di project
• Untuk menyetel tag untuk VM: compute.instances.setTags di VM
• Untuk menetapkan label bagi VM: compute.instances.setLabels di VM
• Untuk menetapkan akun layanan yang akan digunakan VM: compute.instances.setServiceAccount di VM
• Untuk membuat disk baru untuk 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

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Membuat VM yang menggunakan model penyediaan terikat reservasi

Untuk membuat VM Ultra A4X, A4, atau A3 menggunakan model penyediaan terikat reservasi, Anda harus menunggu hingga reservasi otomatis yang ingin digunakan mencapai waktu mulainya. Selain itu, VM yang ingin Anda buat harus memenuhi semua persyaratan berikut:

• VM dan reservasi harus memiliki properti yang cocok.

• VM harus secara khusus menargetkan pemesanan untuk digunakan.

• VM harus dihentikan atau dihapus pada waktu berakhirnya pemesanan.

Contoh berikut membuat permintaan pemesanan untuk masa mendatang dalam mode kalender untuk lima VM A3 Ultra, lalu membuat VM A3 Ultra dengan menggunakan pemesanan yang dibuat otomatis untuk permintaan tersebut.

Untuk membuat VM contoh menggunakan model penyediaan terikat reservasi, pilih salah satu opsi berikut:

Konsol

1. Buat contoh permintaan untuk lima VM A3 Ultra dan kirimkan untuk ditinjau:

   1. Di konsol Google Cloud , buka halaman Reservations.

      Buka Pemesanan

   2. Klik tab Future reservations.

   3. Klik Create future reservation. Halaman Create a future reservation akan muncul.

   4. Di bagian Konfigurasi hardware, pilih Tentukan jenis mesin, lalu tentukan instance A3 Ultra.

   5. Di bagian Metode perolehan, selesaikan langkah-langkah berikut:

      1. Pilih Cari kapasitas hingga 90 hari.

      2. Di daftar Region dan Zone, tentukan region dan zona tempat resource akan dipesan. Untuk contoh ini, pilih us-central1 dan us-central1-a.

      3. Di kolom Total kapasitas yang dibutuhkan, masukkan 5.

      4. Di bagian Periode pemesanan, tentukan periode pemesanan untuk pemesanan.

   6. Tentukan kolom lainnya, lalu klik Kirim.

2. Pada waktu mulai permintaan, untuk membuat VM A3 Ultra yang akan menggunakan contoh pemesanan yang dibuat otomatis, lakukan langkah-langkah berikut:

   Penting: Langkah-langkah berikut menunjukkan cara membuat VM A3 Ultra NIC tunggal, yang berguna untuk pengujian cepat. Untuk membuat VM A3 Ultra multi-NIC, lihat Membuat instance A3 Ultra atau A4.

   1. Di konsol Google Cloud , buka halaman Create an instance.

      Buka halaman Buat instance

   2. Di kolom Nama, masukkan nama untuk VM. Untuk contoh ini, masukkan example-vm.

   3. Tentukan Region dan Zona tempat Anda ingin memesan resource. Untuk contoh ini, pilih us-central1 dan us-central1-a.

   4. Klik tab GPU, lalu di daftar GPU type, pilih NVIDIA H200 141 GB. Tindakan ini menentukan VM A3 Ultra dan menetapkan model penyediaan ke Reservation-bound.

   5. Di menu navigasi, klik Lanjutan.

   6. Di bagian Reservations, pilih Choose a reservation, lalu klik Choose a reservation.

   7. Di panel Choose a reservation, lakukan hal berikut:

      1. Pilih reservasi tertentu. Jika Anda ingin menggunakan pemesanan bersama yang ada di project lain, pilih project tempat pemesanan berada di daftar Project.

      2. Klik Pilih.

   8. Di bagian Model penyediaan, luaskan bagian Setelan lanjutan model penyediaan VM.

   9. Dalam daftar On VM termination, pilih Stop (default) atau Delete.

   10. Klik Buat.

gcloud

1. Untuk membuat contoh permintaan lima VM A3 Ultra dan mengirimkannya untuk ditinjau, gunakan perintah gcloud beta compute future-reservations create:

   gcloud beta compute future-reservations create example-fr \
       --auto-delete-auto-created-reservations \
       --deployment-type=DENSE \
       --planning-status=SUBMITTED \
       --require-specific-reservation \
       --reservation-mode=CALENDAR \
       --reservation-name=example-reservation \
       --share-type=local \
       --start-time=2025-10-05T00:00:00Z \
       --end-time=2025-10-19T00:00:00Z \
       --machine-type=a3-ultragpu-8g \
       --total-count=5 \
       --zone=us-central1-a
   

   Anggaplah Google Cloud menyetujui permintaan dan Compute Engine otomatis membuat pemesanan kosong. Pada waktu mulai permintaan, 5 Oktober 2025, Compute Engine akan menambah jumlah VM GPU yang dicadangkan dalam pemesanan. Kemudian, Anda dapat menggunakan reservasi.

2. Pada waktu mulai permintaan, untuk membuat VM A3 Ultra yang akan menggunakan contoh pemesanan yang dibuat secara otomatis, gunakan perintah gcloud compute instances create dengan flag berikut:

   • Flag --instance-termination-action.

   • Flag --provisioning-model ditetapkan ke RESERVATION_BOUND.

   • Flag --reservation.

   • Flag --reservation-affinity ditetapkan ke specific.

   Perintahnya mirip dengan berikut ini. Untuk mengetahui persyaratan lengkap guna membuat VM A3 Ultra, lihat Membuat instance A3 Ultra atau A4.

   gcloud compute instance create example-vm  \
       --machine-type=a3-ultragpu-8g \
       --instance-termination-action=TERMINATION_ACTION \
       --provisioning-model=RESERVATION_BOUND \
       --reservation-affinity=specific \
       --reservation=RESERVATION_URL \
       --zone=us-central1-a \
       ...
   

   Perintah ini mencakup nilai berikut:

   • TERMINATION_ACTION: apakah Compute Engine menghentikan (STOP) atau menghapus (DELETE) VM di akhir periode reservasi.

   • RESERVATION_URL: URL pemesanan, yang diformat sebagai berikut:

     • Jika pemesanan yang dibuat otomatis ada di project Anda: example-reservation.

     • Jika pemesanan yang dibuat otomatis ada di project lain: projects/PROJECT_ID/reservations/example-reservation.

REST

1. Untuk membuat contoh permintaan lima VM A3 Ultra dan mengirimkannya untuk ditinjau, buat permintaan POST ke metode beta futureReservations.insert:

   POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/futureReservations
   
   {
     "name": "example-request-calendar-mode",
     "autoDeleteAutoCreatedReservations": true,
     "deploymentType": "DENSE",
     "planningStatus": "SUBMITTED",
     "reservationMode": "CALENDAR",
     "reservationName": "example-reservation",
     "shareSettings": {
       "shareType": "LOCAL"
     },
     "specificReservationRequired": true,
     "specificSkuProperties": {
       "machineType": "a3-ultragpu-8g",
       "totalCount": 5
     },
     "timeWindow": {
       "startTime": "2025-10-05T00:00:00Z",
       "endTime": "2025-10-19T00:00:00Z"
     }
   }
   

   Anggaplah Google Cloud menyetujui permintaan dan Compute Engine otomatis membuat pemesanan kosong. Pada waktu mulai permintaan, 5 Oktober 2025, Compute Engine akan menambah jumlah VM GPU yang dicadangkan dalam pemesanan. Kemudian, Anda dapat menggunakan reservasi.

2. Pada waktu mulai permintaan, untuk membuat VM Ultra A3 guna menggunakan contoh pemesanan yang dibuat otomatis, buat permintaan POST ke metode instances.insert. Dalam isi permintaan, sertakan kolom berikut:

   • Kolom reservationAffinity.consumeReservationType ditetapkan ke SPECIFIC_RESERVATION.

   • Kolom reservationAffinity.key ditetapkan ke compute.googleapis.com/reservation-name.

   • Kolom reservationAffinity.values ditetapkan ke URL reservasi.

   • Kolom scheduling.instanceTerminationAction.

   • Kolom scheduling.provisioningModel ditetapkan ke RESERVATION_BOUND.

   Permintaannya mirip dengan berikut ini. Untuk mengetahui persyaratan lengkap guna membuat VM A3 Ultra, lihat Membuat instance A3 Ultra atau A4.

   POST https://compute.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instances
   
   {
     {
       "machineType": "projects/example-project/zones/us-central1-a/machineTypes/a3-ultragpu-8g",
       "name": "example-vm",
       "reservationAffinity": {
         "consumeReservationType": "SPECIFIC_RESERVATION",
         "key": "compute.googleapis.com/reservation-name",
         "values":[
           "RESERVATION_URL"
         ],
       },
       "scheduling": {
         "instanceTerminationAction": "TERMINATION_ACTION",
         "provisioningModel": "RESERVATION_BOUND"
       },
       ...
     }
   }
   

   Isi permintaan mencakup nilai berikut:

   • RESERVATION_URL: URL pemesanan, yang diformat sebagai berikut:

     • Jika pemesanan yang dibuat otomatis ada di project Anda: example-reservation.

     • Jika pemesanan yang dibuat otomatis ada di project lain: projects/PROJECT_ID/reservations/example-reservation.

   • TERMINATION_ACTION: apakah Compute Engine menghentikan (STOP) atau menghapus (DELETE) VM di akhir periode reservasi.

Langkah berikutnya

• Hubungkan ke VM Anda

• Menjalankan skrip shutdown

• Template instance

• Menghentikan atau memulai ulang VM

Coba sendiri

Jika Anda baru pertama kali menggunakan Google Cloud, buat akun untuk mengevaluasi performa Compute Engine dalam skenario dunia nyata. Pelanggan baru mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

Coba Compute Engine gratis