Membuat instance dengan model terikat pemesanan

Dokumen ini menjelaskan cara membuat instance Compute Engine mandiri menggunakan model penyediaan terikat pemesanan. Model penyediaan ini memungkinkan Anda membuat instance A5X, A4X Max, A4X, A4, A3 Ultra, A3 Mega, A3 High dengan 8 GPU, A3 Edge, atau H4D dengan menggunakan kapasitas yang telah dipesan sebelumnya.

Untuk metode lain dalam membuat instance komputasi menggunakan model penyediaan terikat pemesanan, lihat Ringkasan opsi deployment dalam dokumentasi AI Hypercomputer.

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan konsol Google Cloud untuk mengakses layanan dan API Google Cloud , Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

      gcloud init
  • Tetapkan region dan zona default.
  • REST

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

      Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda.

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna membuat instance komputasi menggunakan model penyediaan terikat pemesanan, 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 instance komputasi menggunakan model penyediaan terikat pemesanan. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat instance komputasi menggunakan model penyediaan terikat pemesanan:

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

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

Membuat instance yang menggunakan model penyediaan terikat pemesanan

Untuk membuat instance A5X, A4X Max, A4X, A4, A3 Ultra, A3 Mega, A3 High dengan 8 GPU, A3 Edge, atau H4D menggunakan model penyediaan terikat pemesanan, Anda harus menunggu hingga pemesanan yang dibuat otomatis yang ingin Anda gunakan mencapai waktu mulainya. Selain itu, instance komputasi yang ingin Anda buat harus memenuhi semua persyaratan berikut:

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

Untuk membuat contoh instance komputasi menggunakan model penyediaan terikat pemesanan, pilih salah satu opsi berikut:

Konsol

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

    1. Di konsol Google Cloud , buka halaman Reservations.

      Buka Reservations

    2. Klik tab Pemesanan untuk masa mendatang.

    3. Klik Buat pemesanan untuk masa mendatang. Halaman Create a future reservation akan muncul.

    4. Klik tab GPU, lalu di daftar GPU type, pilih NVIDIA H200 141GB. Tindakan ini menentukan instance A3 Ultra.

    5. Di kolom Total capacity needed, masukkan 5.

    6. Di bagian Reservation period, tentukan waktu mulai dan durasi untuk periode pemesanan Anda.

    7. Klik Search for capacity, lalu di bagian Available capacity, pilih salah satu mesin yang tersedia.

    8. Klik Create.

  2. Pada waktu mulai permintaan, untuk membuat instance A3 Ultra guna menggunakan contoh pemesanan yang dibuat otomatis, lakukan hal berikut:

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

      Buka halaman Buat instance

    2. Di kolom Name, masukkan nama untuk instance komputasi. Untuk contoh ini, masukkan example-instance.

    3. Tentukan Region dan Zone tempat pemesanan yang dibuat otomatis berada. Untuk contoh ini, pilih us-central1 dan us-central1-b.

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

    5. Di menu navigasi, klik Advanced.

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

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

      1. Pilih contoh pemesanan yang dibuat otomatis.

      2. Klik Choose.

    8. Di bagian Provisioning model, luaskan bagian VM provisioning model advanced settings.

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

    10. Klik Create.

gcloud

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

    gcloud 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-setting=local \
        --start-time=2026-03-05T00:00:00Z \
        --end-time=2026-03-19T00:00:00Z \
        --machine-type=a3-ultragpu-8g \
        --total-count=5 \
        --zone=us-central1-b
    

    Misalkan Google Cloud menyetujui permintaan tersebut dan Compute Engine otomatis membuat pemesanan kosong. Pada waktu mulai permintaan, yaitu 5 Maret 2026, Compute Engine akan meningkatkan jumlah instance GPU yang dipesan dalam pemesanan. Kemudian, Anda dapat menggunakan pemesanan.

  2. Pada waktu mulai permintaan, untuk membuat instance A3 Ultra yang menggunakan contoh pemesanan kreasi 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 yang berikut ini. Untuk mengetahui persyaratan lengkap dalam membuat instance A3 Ultra, lihat Membuat instance A3 Ultra atau A4.

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

    Perintah tersebut menyertakan nilai berikut:

    • TERMINATION_ACTION: apakah Compute Engine menghentikan (STOP) atau menghapus (DELETE) instance komputasi di akhir periode pemesanan.

    • RESERVATION_URL: URL pemesanan, yang diformat sebagai berikut:

      • Jika pemesanan yang dibuat secara 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 untuk lima instance A3 Ultra dan mengirimkannya untuk ditinjau, buat permintaan POST ke metode futureReservations.insert:

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

    Misalkan Google Cloud menyetujui permintaan tersebut dan Compute Engine otomatis membuat pemesanan kosong. Pada waktu mulai permintaan, yaitu 5 Maret 2026, Compute Engine akan meningkatkan jumlah instance GPU yang dipesan dalam pemesanan. Kemudian, Anda dapat menggunakan pemesanan.

  2. Pada waktu mulai permintaan, untuk membuat instance A3 Ultra 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./reservation-name.

    • Kolom reservationAffinity.values ditetapkan ke URL pemesanan.

    • Kolom scheduling.instanceTerminationAction.

    • Kolom scheduling.provisioningModel ditetapkan ke RESERVATION_BOUND.

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

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

    Isi permintaan menyertakan nilai-nilai berikut:

    • RESERVATION_URL: URL pemesanan, yang diformat sebagai berikut:

      • Jika pemesanan yang dibuat secara 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) instance komputasi di akhir periode pemesanan.

Langkah berikutnya