Membuat instance yang dioptimalkan untuk HPC secara massal dengan H4D

Dokumen ini menjelaskan cara membuat sejumlah besar instance virtual machine (VM) komputasi berperforma tinggi (HPC) secara massal yang identik dan independen satu sama lain. Instance menggunakan jenis mesin H4D dan berjalan di blok kapasitas yang dicadangkan.

Untuk mengetahui informasi selengkapnya tentang pembuatan VM secara massal, lihat Tentang pembuatan VM secara massal. Untuk membuat instance secara massal yang tidak menggunakan reservasi untuk kemampuan pengelolaan cluster yang ditingkatkan, lihat Membuat VM secara massal.

Untuk mempelajari cara lain membuat cluster besar VM H4D yang terhubung erat, lihat halaman Ringkasan pembuatan cluster HPC.

Sebelum memulai

  • Pilih opsi penggunaan: untuk membuat instance komputasi secara massal dan mengaktifkan kemampuan pengelolaan cluster yang ditingkatkan, Anda dapat memilih Pemesanan untuk Masa Depan dalam mode Kalender atau Spot VM.

    Jika Anda memilih untuk menggunakan Spot VM, VM mungkin tidak ditempatkan secara rapat. Selain itu, Spot VM dapat di-preempt sesuai kebutuhan dan tidak memenuhi syarat untuk mengelola peristiwa pemeliharaan host untuk grup VM.

  • Mendapatkan kapasitas: proses untuk mendapatkan kapasitas berbeda untuk setiap opsi konsumsi.

    Untuk mempelajari lebih lanjut, lihat Memilih opsi pemakaian dan mendapatkan kapasitas.

  • 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 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

    1. Instal Google Cloud CLI. Setelah penginstalan, 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.

    2. Set a default region and zone.

    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. Setelah penginstalan, 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.

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

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna membuat VM secara massal, minta administrator untuk memberi Anda peran IAM berikut pada project:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk membuat VM secara massal. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat VM secara massal:

  • 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 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 menyetel 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

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

Ringkasan

Membuat instance HPC secara massal dengan jenis mesin H4D mencakup langkah-langkah berikut:

  1. Opsional: Buat jaringan Virtual Private Cloud.
  2. Opsional: Buat kebijakan penempatan jika Anda tidak membuat instance komputasi di blok atau sub-blok yang sama.
  3. Buat instance H4D secara massal.

Opsional: Buat jaringan Virtual Private Cloud

Saat membuat instance komputasi, Anda dapat menentukan jaringan dan subnet VPC. Jika Anda menghapus konfigurasi ini, jaringan dan subnet default akan digunakan.

  • Jika Anda ingin mengonfigurasi instance H4D di MIG untuk menggunakan Cloud RDMA, selesaikan langkah-langkah di bagian ini.
  • Jika tidak ingin menggunakan Cloud RDMA, Anda dapat melewati bagian ini dan menggunakan jaringan default.

Untuk menggunakan Cloud RDMA dengan instance H4D, Anda harus mengonfigurasi setidaknya dua jaringan, satu untuk setiap jenis antarmuka jaringan (NIC):

  • Jenis NIC GVNIC: menggunakan driver gve untuk traffic TCP/IP dan Internet untuk komunikasi VM-VM dan VM-Internet normal.
  • Jenis NIC IRDMA: menggunakan driver IDPF/iRDMA untuk jaringan Cloud RDMA antar-instance.

Instance yang menggunakan Cloud RDMA hanya dapat memiliki satu antarmuka IRDMA. Anda dapat menambahkan hingga delapan antarmuka jaringan GVNIC tambahan dengan total 10 vNIC per instance.

Untuk menyiapkan jaringan VPC Falcon untuk digunakan dengan instance Anda, Anda dapat mengikuti petunjuk yang didokumentasikan atau menggunakan skrip yang disediakan.

Panduan petunjuk

Untuk membuat jaringan, Anda dapat menggunakan petunjuk berikut:

Skrip

Anda dapat membuat hingga sembilan antarmuka jaringan gVNIC dan satu antarmuka jaringan IRDMA per instance. Setiap antarmuka jaringan harus terhubung ke jaringan yang terpisah. Untuk membuat jaringan, Anda dapat menggunakan skrip berikut, yang membuat dua jaringan untuk gVNIC dan satu jaringan untuk IRDMA.

  1. Opsional: Sebelum menjalankan skrip, buat daftar profil jaringan VPC Falcon untuk memverifikasi ketersediaan profil.
      gcloud compute network-profiles list
      
  2. Salin kode berikut dan jalankan di jendela shell Linux.

      #!/bin/bash
      # Set the number of GVNIC interfaces to create. You can create up to 9.
      NUM_GVNIC=NUMBER_OF_GVNIC
    
      # Create regular VPC networks and subnets for the GVNIC interfaces
        for N in $(seq 0 $(($NUM_GVNIC - 1))); do
          gcloud compute networks create GVNIC_NAME_PREFIX-net-$N \
              --subnet-mode=custom
    
          gcloud compute networks subnets create GVNIC_NAME_PREFIX-sub-$N \
              --network=GVNIC_NAME_PREFIX-net-$N \
              --region=REGION \
              --range=10.$N.0.0/16
    
          gcloud compute firewall-rules create GVNIC_NAME_PREFIX-internal-$N \
              --network=GVNIC_NAME_PREFIX-net-$N \
              --action=ALLOW \
              --rules=tcp:0-65535,udp:0-65535,icmp \
              --source-ranges=10.0.0.0/8
      done
    
      # Create SSH firewall rules
      gcloud compute firewall-rules create GVNIC_NAME_PREFIX-ssh \
          --network=GVNIC_NAME_PREFIX-net-0 \
          --action=ALLOW \
          --rules=tcp:22 \
          --source-ranges=IP_RANGE
    
      # Optional: Create a firewall rule for the external IP address for the
      #  first GVNIC network interface
      gcloud compute firewall-rules create GVNIC_NAME_PREFIX-allow-ping-net-0 \
          --network=GVNIC_NAME_PREFIX-net-0 \
          --action=ALLOW \
          --rules=icmp \
          --source-ranges=IP_RANGE
    
      # Create a Falcon VPC network for the Cloud RDMA network interface
      gcloud compute networks create RDMA_NAME_PREFIX-irdma \
          --network-profile=ZONE-vpc-falcon \
          --subnet-mode custom
    
      # Create a subnet in the Falcon VPC network
      gcloud compute networks subnets create RDMA_NAME_PREFIX-irdma-sub \
          --network=RDMA_NAME_PREFIX-irdma \
          --region=REGION \
          --range=10.2.0.0/16  # offset to avoid overlap with GVNIC subnet ranges
      

    Ganti kode berikut:

    • NUMBER_OF_GVNIC: jumlah antarmuka GVNIC yang akan dibuat. Tentukan angka dari 1 hingga 9.
    • GVNIC_NAME_PREFIX: awalan nama yang akan digunakan untuk jaringan dan subnet VPC reguler yang menggunakan jenis NIC GVNIC.
    • REGION: region tempat Anda ingin membuat jaringan. Ini harus sesuai dengan zona yang ditentukan untuk flag --network-profile, saat membuat jaringan VPC Falcon. Misalnya, jika Anda menentukan zona sebagai europe-west4-b, maka region Anda adalah europe-west4.
    • IP_RANGE: rentang alamat IP di luar jaringan VPC yang akan digunakan untuk aturan firewall SSH. Sebagai praktik terbaik, tentukan rentang alamat IP tertentu yang perlu Anda izinkan aksesnya, bukan semua sumber IPv4 atau IPv6. Jangan gunakan 0.0.0.0/0 atau ::/0 sebagai rentang sumber karena hal ini memungkinkan traffic dari semua sumber IPv4 atau IPv6, termasuk sumber di luar Google Cloud.
    • RDMA_NAME_PREFIX: awalan nama yang akan digunakan untuk jaringan VPC dan subnet yang menggunakan jenis NIC IRDMA.
    • ZONE: zona tempat Anda ingin membuat jaringan dan instance komputasi. Gunakan salah satu dari us-central1-a atau europe-west4-b.
  3. Opsional: Untuk memverifikasi bahwa resource jaringan VPC berhasil dibuat, periksa setelan jaringan di konsol Google Cloud :

    1. Di konsol Google Cloud , buka halaman VPC networks.

      Buka jaringan VPC

    2. Telusuri daftar untuk menemukan jaringan yang Anda buat pada langkah sebelumnya.
    3. Untuk melihat subnet, aturan firewall, dan setelan jaringan lainnya, klik nama jaringan.

Opsional: Buat kebijakan penempatan

Anda dapat menentukan penempatan VM dengan membuat kebijakan penempatan yang ringkas. Saat Anda menerapkan kebijakan penempatan yang ringkas ke VM, Compute Engine akan melakukan upaya terbaik untuk membuat VM yang berdekatan satu sama lain. Jika aplikasi Anda sensitif terhadap latensi dan Anda ingin VM berada lebih berdekatan (kepadatan maksimum), tentukan kolom maxDistance (Pratinjau) saat membuat kebijakan penempatan rapat. Nilai maxDistance yang lebih rendah memastikan penempatan VM yang lebih dekat, tetapi juga meningkatkan kemungkinan beberapa VM tidak akan dibuat.

Untuk membuat kebijakan penempatan ringkas, pilih salah satu opsi berikut:

gcloud

Untuk membuat kebijakan penempatan rapat, gunakan perintah gcloud beta compute resource-policies create group-placement:

gcloud beta compute resource-policies create group-placement POLICY_NAME \
    --collocation=collocated \
    --max-distance=MAX_DISTANCE \
    --region=REGION

Ganti kode berikut:

  • POLICY_NAME: nama kebijakan penempatan yang ringkas.
  • MAX_DISTANCE: konfigurasi jarak maksimum untuk VM Anda. Nilai harus 3 untuk menempatkan VM di blok yang berdekatan, atau 2 untuk menempatkan VM di blok yang sama. Untuk mengetahui informasi tentang jumlah maksimum VM yang didukung untuk setiap maxDistance per seri mesin, lihat Tentang kebijakan penempatan rapat dalam dokumentasi Compute Engine.
  • REGION: region tempat Anda ingin membuat kebijakan penempatan yang ringkas. Tentukan region tempat jenis mesin yang ingin Anda gunakan tersedia. Untuk mengetahui informasi tentang region, lihat Region dan zona yang tersedia.

REST

Untuk membuat kebijakan penempatan ringkas, buat permintaan POST ke metode beta resourcePolicies.insert. Dalam isi permintaan, sertakan kolom collocation yang ditetapkan ke COLLOCATED, dan kolom maxDistance.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/resourcePolicies
  {
    "name": "POLICY_NAME",
    "groupPlacementPolicy": {
      "collocation": "COLLOCATED",
      "maxDistance": MAX_DISTANCE
    }
  }

Ganti kode berikut:

  • PROJECT_ID: project ID Anda
  • POLICY_NAME: nama kebijakan penempatan yang ringkas.
  • MAX_DISTANCE: konfigurasi jarak maksimum untuk VM Anda. Nilai harus 3 untuk menempatkan VM di blok yang berdekatan, atau 2 untuk menempatkan VM di blok yang sama. Untuk mengetahui informasi tentang jumlah maksimum VM yang didukung untuk setiap maxDistance per seri mesin, lihat Tentang kebijakan penempatan rapat dalam dokumentasi Compute Engine.
  • REGION: region tempat Anda ingin membuat kebijakan penempatan yang ringkas. Tentukan region tempat jenis mesin yang ingin Anda gunakan tersedia. Untuk mengetahui informasi tentang region, lihat Region dan zona yang tersedia.

Membuat instance VM secara massal

Petunjuk di bagian ini menjelaskan cara membuat VM H4D secara massal.

Tinjau batasan berikut sebelum membuat instance H4D dengan Cloud RDMA:

  • Anda tidak dapat menggunakan Migrasi langsung selama peristiwa pemeliharaan host dengan instance yang memiliki antarmuka jaringan Cloud RDMA. Anda harus mengonfigurasi instance agar dihentikan selama peristiwa pemeliharaan.
  • Antarmuka jaringan gVNIC hanya dapat memiliki satu alamat IPv6, baik internal maupun eksternal, tetapi tidak keduanya.
  • Anda hanya dapat menggunakan alamat IPv4 dengan antarmuka jaringan IRDMA dan jaringan VPC Falcon.

gcloud

Untuk membuat VM secara massal, gunakan perintah gcloud compute instances create.

Parameter yang perlu Anda tentukan bergantung pada opsi penggunaan yang Anda gunakan untuk deployment ini. Pilih tab yang sesuai dengan model penyediaan opsi konsumsi Anda.

Terikat dengan reservasi

Mulai dengan gcloud compute instances create perintah berikut.

   gcloud compute instances bulk create \
       --name-pattern=NAME_PATTERN \
       --count=COUNT \
       --machine-type=MACHINE_TYPE \
       --image-family=IMAGE_FAMILY \
       --image=project= IMAGE_PROJECT \
       --instance-termination=action=DELETE \
       --maintenance-policy=TERMINATE \
       --region=REGION \
       --boot-disk-type=hyperdisk-balanced \
       --boot-disk-size=DISK_SIZE
   

Selesaikan langkah-langkah berikut:

  1. Ganti kode berikut:

    • NAME_PATTERN: pola nama untuk instance. Misalnya, menggunakan vm-# untuk pola nama akan menghasilkan instance dengan nama seperti vm-1 dan vm-2, hingga jumlah yang ditentukan oleh flag --count.
    • COUNT: jumlah instance yang akan dibuat.
    • MACHINE_TYPE: jenis mesin yang akan digunakan untuk instance. Gunakan salah satu jenis mesin H4D, misalnya h4d-highmem-192-lssd.
    • IMAGE_FAMILY: kelompok image image OS yang ingin Anda gunakan, misalnya rocky-linux-9-optimized-gcp.

      Untuk mengetahui daftar image OS yang didukung, lihat Sistem operasi yang didukung. Pilih versi image OS yang mendukung antarmuka IRDMA.

    • IMAGE_PROJECT: project ID untuk image OS, misalnya, rocky-linux-cloud.
    • REGION: tentukan region tempat jenis mesin yang ingin Anda gunakan tersedia, misalnya europe-west4. Untuk mengetahui informasi tentang region yang tersedia, lihat Region dan zona yang tersedia.
    • DISK_SIZE: Opsional: ukuran boot disk dalam GiB. Nilai harus berupa bilangan bulat.
  2. Opsional: Jika Anda memilih untuk menggunakan kebijakan penempatan rapat, sertakan flag --resource-policies:

             --resource-policies=POLICY_NAME
             

    Ganti POLICY_NAME dengan nama kebijakan penempatan yang ringkas.

  3. Untuk menentukan reservasi, lakukan salah satu hal berikut:

    • Jika Anda menggunakan kebijakan penempatan atau jika VM dapat ditempatkan di mana saja dalam blok pemesanan, tambahkan flag berikut ke perintah:

                 --provisioning-model=RESERVATION_BOUND \
                 --reservation-affinity=specific \
                 --reservation=RESERVATION_NAME \
                 

      Ganti RESERVATION_NAME dengan nama reservasi, misalnya, h4d-highmem-exfr-prod.

    • Jika Anda tidak menggunakan kebijakan penempatan rapat dan ingin instance ditempatkan dalam blok tertentu, tambahkan flag berikut ke perintah:

                 --provisioning-model=RESERVATION_BOUND \
                 --reservation-affinity=specific \
                 --reservation=<RESERVATION_BLOCK_NAME \
                 

      Ganti RESERVATION_BLOCK_NAME dengan nama blok dalam reservasi, misalnya, h4d-highmem-exfr-prod/reservationBlocks/h4d-highmem-exfr-prod-block-1.

    Untuk melihat nama reservasi atau blok reservasi yang tersedia, lihat Melihat kapasitas.

  4. Opsional: Untuk mengonfigurasi instance agar menggunakan Cloud RDMA, tambahkan tanda yang mirip dengan berikut ke perintah. Contoh ini mengonfigurasi dua antarmuka jaringan GVNIC dan satu antarmuka jaringan IRDMA:

            --network-interface=nic-type=GVNIC, \
                network=GVNIC_NAME_PREFIX-net-0, \
                subnet=GVNIC_NAME_PREFIX-sub-0, \
                stack-type=STACK_TYPE, \
                address=EXTERNAL_IPV4_ADDRESS \
            --network-interface=nic-type=GVNIC, \
                network=GVNIC_NAME_PREFIX-net-1, \
                subnet=GVNIC_NAME_PREFIX-sub-1, no-address \
            --network-interface=nic-type=IRDMA, \
                network=RDMA_NAME_PREFIX-irdma, \
                subnet=RDMA_NAME_PREFIX-irdma-sub, \
                stack-type=IPV4_ONLY, no-address \
            

    Ganti kode berikut:

    • GVNIC_NAME_PREFIX: awalan nama yang Anda gunakan saat membuat jaringan VPC dan subnet untuk antarmuka GVNIC.

      Untuk antarmuka jaringan GVNIC pertama, Anda dapat menghilangkan flag network dan subnet untuk menggunakan jaringan default.

    • STACK_TYPE: Opsional: jenis stack untuk antarmuka jaringan GVNIC. STACK_TYPE harus salah satu dari IPV4_ONLY, atau IPV4_IPV6. Nilai defaultnya adalah IPV4_ONLY.
    • EXTERNAL_IPV4_ADDRESS: Opsional: alamat IPv4 eksternal statis yang akan digunakan dengan antarmuka jaringan. Anda harus sudah mencadangkan alamat IPv4 eksternal. Lakukan salah satu hal berikut:
      • Tentukan alamat IPv4 yang valid dari subnet.
      • Gunakan tanda no-address sebagai gantinya jika Anda tidak ingin antarmuka jaringan memiliki alamat IP eksternal.
      • Tentukan address='' jika Anda ingin antarmuka menerima alamat IP eksternal sementara.

      Untuk menentukan alamat IPv6 eksternal, gunakan flag --external-ipv6-address.

    • RDMA_NAME_PREFIX: awalan nama yang Anda gunakan saat membuat jaringan VPC dan subnet untuk antarmuka IRDMA.
  5. Opsional: Tambahkan flag tambahan untuk menyesuaikan properti instance lainnya sesuai kebutuhan.
  6. Jalankan perintah.

Spot

Mulai dengan gcloud compute instances create perintah berikut.

   gcloud compute instances bulk create \
       --name-pattern=NAME_PATTERN \
       --count=COUNT \
       --machine-type=MACHINE_TYPE \
       --image-family=IMAGE_FAMILY \
       --image=project= IMAGE_PROJECT \
       --region=REGION \
       --boot-disk-type=hyperdisk-balanced \
       --boot-disk-size=DISK_SIZE \
       --provisioning-model=SPOT \
       --instance-termination=action=TERMINATION_ACTION
   

Selesaikan langkah-langkah berikut:

  1. Ganti kode berikut:

    • NAME_PATTERN: pola nama untuk instance. Misalnya, menggunakan vm-# untuk pola nama akan menghasilkan instance dengan nama seperti vm-1 dan vm-2, hingga jumlah yang ditentukan oleh flag --count.
    • COUNT: jumlah instance yang akan dibuat.
    • MACHINE_TYPE: jenis mesin yang akan digunakan untuk instance. Gunakan salah satu jenis mesin H4D, misalnya h4d-highmem-192-lssd.
    • IMAGE_FAMILY: kelompok image image OS yang ingin Anda gunakan, misalnya rocky-linux-9-optimized-gcp.

      Untuk mengetahui daftar image OS yang didukung, lihat Sistem operasi yang didukung. Pilih versi image OS yang mendukung antarmuka IRDMA.

    • IMAGE_PROJECT: project ID untuk image OS, misalnya, rocky-linux-cloud.
    • REGION: tentukan region tempat jenis mesin yang ingin Anda gunakan tersedia, misalnya europe-west4. Untuk mengetahui informasi tentang region yang tersedia, lihat Region dan zona yang tersedia.
    • DISK_SIZE: Opsional: ukuran boot disk dalam GiB. Nilai harus berupa bilangan bulat.
    • TERMINATION_ACTION: tindakan yang harus dilakukan saat Compute Engine melakukan preempt terhadap instance, baik STOP (default) atau DELETE.

  2. Opsional: Jika Anda memilih untuk menggunakan kebijakan penempatan rapat, maka tambahkan flag berikut ke perintah:

          --resource-policies=POLICY_NAME \
          

    Ganti POLICY_NAME dengan nama kebijakan penempatan ringkas.

  3. Opsional: Untuk mengonfigurasi instance agar menggunakan Cloud RDMA, tambahkan tanda yang mirip dengan berikut ke perintah. Contoh ini mengonfigurasi dua antarmuka jaringan GVNIC dan satu antarmuka jaringan IRDMA:

          --network-interface=nic-type=GVNIC, \
              network=GVNIC_NAME_PREFIX-net-0, \
              subnet=GVNIC_NAME_PREFIX-sub-0, \
              stack-type=STACK_TYPE, \
              address=EXTERNAL_IPV4_ADDRESS \
          --network-interface=nic-type=GVNIC, \
              network=GVNIC_NAME_PREFIX-net-1, \
              subnet=GVNIC_NAME_PREFIX-sub-1, no-address \
          --network-interface=nic-type=IRDMA, \
              network=RDMA_NAME_PREFIX-irdma, \
              subnet=RDMA_NAME_PREFIX-irdma-sub, \
              stack-type=IPV4_ONLY, no-address \
          

    Ganti kode berikut:

    • GVNIC_NAME_PREFIX: awalan nama yang Anda gunakan saat membuat jaringan VPC dan subnet untuk antarmuka GVNIC.

      Untuk antarmuka jaringan GVNIC pertama, Anda dapat menghilangkan flag network dan subnet untuk menggunakan jaringan default.

    • STACK_TYPE: Opsional: jenis stack untuk antarmuka jaringan GVNIC. STACK_TYPE harus salah satu dari IPV4_ONLY, atau IPV4_IPV6. Nilai defaultnya adalah IPV4_ONLY.
    • EXTERNAL_IPV4_ADDRESS: Opsional: alamat IPv4 eksternal statis yang akan digunakan dengan antarmuka jaringan. Anda harus sudah mencadangkan alamat IPv4 eksternal. Lakukan salah satu hal berikut:
      • Tentukan alamat IPv4 yang valid dari subnet.
      • Gunakan tanda no-address sebagai gantinya jika Anda tidak ingin antarmuka jaringan memiliki alamat IP eksternal.
      • Tentukan address='' jika Anda ingin antarmuka menerima alamat IP eksternal sementara.

      Untuk menentukan alamat IPv6 eksternal, gunakan flag --external-ipv6-address.

    • RDMA_NAME_PREFIX: awalan nama yang Anda gunakan saat membuat jaringan VPC dan subnet untuk antarmuka IRDMA.
  4. Opsional: Tambahkan flag tambahan untuk menyesuaikan properti instance lainnya sesuai kebutuhan.
  5. Jalankan perintah.

REST

Untuk membuat instance VM secara massal, buat permintaan POST ke metode instances.bulkInsert

Parameter yang perlu Anda tentukan bergantung pada opsi penggunaan yang Anda gunakan untuk deployment ini. Pilih tab yang sesuai dengan model penyediaan opsi konsumsi Anda.

Terikat dengan reservasi

Mulai dengan permintaan POST berikut ke metode instances.bulkInsert.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert
    {
      "namePattern":"NAME_PATTERN",
      "count":"COUNT",
      "instanceProperties":{
        "machineType":"MACHINE_TYPE",
        "disks":[
          {
            "boot":true,
            "initializeParams":{
              "diskSizeGb":"DISK_SIZE",
              "diskType":"hyperdisk-balanced",
              "sourceImage":"projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
            },
            "mode":"READ_WRITE",
            "type":"PERSISTENT"
          }
        ],
        "scheduling":{
            "provisioningModel":"RESERVATION_BOUND",
            "instanceTerminationAction":"DELETE",
            "onHostMaintenance": "TERMINATE",
            "automaticRestart":true
        }
      }
    }
    

Selesaikan langkah-langkah berikut:

  1. Ganti kode berikut:

    • PROJECT_ID: project ID dari project tempat Anda ingin membuat instance.
    • ZONE: tentukan zona tempat jenis mesin yang ingin Anda gunakan tersedia. Jika Anda menggunakan kebijakan penempatan rapat, gunakan zona di region yang sama dengan kebijakan penempatan rapat. Untuk mengetahui informasi tentang region tempat jenis mesin H4D tersedia, lihat Region dan zona yang tersedia.
    • NAME_PATTERN: pola nama untuk instance. Misalnya, menggunakan vm-# untuk pola nama akan menghasilkan instance dengan nama seperti vm-1 dan vm-2, hingga jumlah yang ditentukan oleh kolom count.
    • COUNT: jumlah instance yang akan dibuat.
    • MACHINE_TYPE: jenis mesin yang akan digunakan untuk instance. Gunakan salah satu jenis mesin H4D, misalnya h4d-highmem-192-lssd.
    • DISK_SIZE: ukuran boot disk dalam GiB.
    • IMAGE_PROJECT: project ID untuk image OS, misalnya, debian-cloud.
    • IMAGE_FAMILY: kelompok image OS image yang ingin Anda gunakan, misalnya rocky-linux-9-optimized-gcp. Untuk daftar image OS yang didukung, lihat Sistem operasi yang didukung. Pilih versi image OS yang mendukung antarmuka IRDMA.
  2. Opsional: Jika Anda memilih untuk menggunakan kebijakan penempatan ringkas, sertakan parameter resourcePolicies dalam isi permintaan sebagai bagian dari parameter "instanceProperties".

              "resourcePolicies": [
                "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
              ],
              

    Ganti POLICY_NAME dengan nama kebijakan penempatan yang ringkas.

  3. Untuk menentukan reservasi, lakukan salah satu hal berikut:

    • Jika Anda menggunakan kebijakan penempatan atau jika VM dapat ditempatkan di mana saja dalam blok pemesanan, tambahkan berikut ke isi permintaan sebagai bagian dari parameter "instanceProperties":

                 "reservationAffinity":{
                   "consumeReservationType":"SPECIFIC_RESERVATION",
                   "key":"compute.googleapis.com/reservation-name",
                   "values":[
                     "RESERVATION_NAME"
                   ],
                 },
                 

      Ganti RESERVATION_NAME dengan nama reservasi, misalnya, h4d-highmem-exfr-prod.

    • Jika Anda tidak menggunakan kebijakan penempatan yang ringkas atau ingin instance ditempatkan dalam blok tertentu, tambahkan berikut ke isi permintaan sebagai bagian dari parameter "instanceProperties":

                  "reservationAffinity":{
                    "consumeReservationType":"SPECIFIC_RESERVATION",
                    "key":"compute.googleapis.com/reservation-name",
                    "values":[
                      "RESERVATION_BLOCK_NAME"
                    ],
                  },
                 

      Ganti RESERVATION_BLOCK_NAME dengan nama blok dalam reservasi, misalnya, h4d-highmem-exfr-prod/reservationBlocks/h4d-highmem-exfr-prod-block-1.

    Untuk melihat nama reservasi atau blok reservasi yang tersedia, lihat Melihat kapasitas.

  4. Jika Anda ingin mengonfigurasi instance untuk menggunakan Cloud RDMA, sertakan blok parameter yang mirip dengan berikut ke isi permintaan sebagai bagian dari parameter "instanceProperties". Contoh ini mengonfigurasi dua antarmuka jaringan GVNIC dan satu antarmuka jaringan IRDMA:

              "networkInterfaces": [
              {
                "network": "GVNIC_NAME_PREFIX-net-0",
                "subnetwork": "GVNIC_NAME_PREFIX-sub-0",
                "accessConfigs": [
                   {
                      "type": "ONE_TO_ONE_NAT",
                      "name": "External IP",
                      "natIP": "EXTERNAL_IPV4_ADDRESS"
                   }
                ],
                "stackType": "IPV4_ONLY",
                "nicType": "GVNIC",
              },
              {
                "network": "GVNIC_NAME_PREFIX-net-1",
                "subnetwork": "GVNIC_NAME_PREFIX-sub-1",
                "stackType": "IPV4_ONLY",
                "nicType": "GVNIC",
              },
              {
                "network": "RDMA_NAME_PREFIX-irdma",
                "subnetwork": "RDMA_NAME_PREFIX-irdma-sub",
                "stackType": "IPV4_ONLY",
                "nicType": "IRDMA",
              }
            ],
             

    Ganti kode berikut:

    • GVNIC_NAME_PREFIX: awalan nama yang Anda gunakan saat membuat jaringan VPC dan subnet untuk antarmuka GVNIC.

      Untuk antarmuka jaringan GVNIC, Anda dapat menghilangkan kolom network dan subnetwork untuk menggunakan jaringan default sebagai gantinya.

    • EXTERNAL_IPV4_ADDRESS: Opsional: alamat IPv4 eksternal statis yang akan digunakan dengan antarmuka jaringan. Anda harus sudah mencadangkan alamat IPv4 eksternal sebelumnya.
    • RDMA_NAME_PREFIX: awalan nama yang Anda gunakan saat membuat jaringan dan subnet VPC untuk antarmuka IRDMA.
  5. Opsional: Sesuaikan properti instance lainnya, sesuai kebutuhan.
  6. Kirim permintaan.

Spot

Mulai dengan permintaan POST berikut ke metode instances.bulkInsert.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert
    {
      "namePattern":"NAME_PATTERN",
      "count":"COUNT",
      "instanceProperties":{
        "machineType":"MACHINE_TYPE",
        "disks":[
          {
            "boot":true,
            "initializeParams":{
              "diskSizeGb":"DISK_SIZE",
              "diskType":"hyperdisk-balanced",
              "sourceImage":"projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY"
            },
            "mode":"READ_WRITE",
            "type":"PERSISTENT"
          }
        ],
        "scheduling":{
            "provisioningModel":"SPOT",
            "instanceTerminationAction":"TERMINATION_ACTION"
        }
      }
    }
    

Selesaikan langkah-langkah berikut:

  1. Ganti kode berikut:

    • PROJECT_ID: project ID dari project tempat Anda ingin membuat instance.
    • ZONE: tentukan zona tempat jenis mesin yang ingin Anda gunakan tersedia. Jika Anda menggunakan kebijakan penempatan rapat, gunakan zona di region yang sama dengan kebijakan penempatan rapat. Untuk mengetahui informasi tentang region tempat jenis mesin H4D tersedia, lihat Region dan zona yang tersedia.
    • NAME_PATTERN: pola nama untuk instance. Misalnya, menggunakan vm-# untuk pola nama akan menghasilkan instance dengan nama seperti vm-1 dan vm-2, hingga jumlah yang ditentukan oleh kolom count.
    • COUNT: jumlah instance yang akan dibuat.
    • MACHINE_TYPE: jenis mesin yang akan digunakan untuk instance. Gunakan salah satu jenis mesin H4D, misalnya h4d-highmem-192-lssd.
    • DISK_SIZE: ukuran boot disk dalam GiB.
    • IMAGE_PROJECT: project ID untuk image OS, misalnya, debian-cloud.
    • IMAGE_FAMILY: kelompok image OS image yang ingin Anda gunakan, misalnya rocky-linux-9-optimized-gcp. Untuk daftar image OS yang didukung, lihat Sistem operasi yang didukung. Pilih versi image OS yang mendukung antarmuka IRDMA.
    • TERMINATION_ACTION: tindakan yang akan diambil saat Compute Engine melakukan preempt terhadap instance, baik STOP (default) atau DELETE.

  2. Opsional: Jika Anda memilih untuk menggunakan kebijakan penempatan rapat, sertakan parameter resourcePolicies sebagai bagian dari parameter "instanceProperties".

              "resourcePolicies": [
                "projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
              ]
              
  3. Jika Anda ingin mengonfigurasi instance untuk menggunakan Cloud RDMA, sertakan blok parameter yang mirip dengan berikut ke isi permintaan sebagai bagian dari parameter "instanceProperties". Contoh ini mengonfigurasi dua antarmuka jaringan GVNIC dan satu antarmuka jaringan IRDMA:

              "networkInterfaces": [
              {
                "network": "GVNIC_NAME_PREFIX-net-0",
                "subnetwork": "GVNIC_NAME_PREFIX-sub-0",
                "accessConfigs": [
                   {
                      "type": "ONE_TO_ONE_NAT",
                      "name": "External IP",
                      "natIP": "EXTERNAL_IPV4_ADDRESS"
                   }
                ],
                "stackType": "IPV4_ONLY",
                "nicType": "GVNIC",
              },
              {
                "network": "GVNIC_NAME_PREFIX-net-1",
                "subnetwork": "GVNIC_NAME_PREFIX-sub-1",
                "stackType": "IPV4_ONLY",
                "nicType": "GVNIC",
              },
              {
                "network": "RDMA_NAME_PREFIX-irdma",
                "subnetwork": "RDMA_NAME_PREFIX-irdma-sub",
                "stackType": "IPV4_ONLY",
                "nicType": "IRDMA",
              }
            ],
             

    Ganti kode berikut:

    • GVNIC_NAME_PREFIX: awalan nama yang Anda gunakan saat membuat jaringan VPC dan subnet untuk antarmuka GVNIC.

      Untuk antarmuka jaringan GVNIC, Anda dapat menghilangkan kolom network dan subnetwork untuk menggunakan jaringan default sebagai gantinya.

    • EXTERNAL_IPV4_ADDRESS: Opsional: alamat IPv4 eksternal statis yang akan digunakan dengan antarmuka jaringan. Anda harus sudah mencadangkan alamat IPv4 eksternal.
    • RDMA_NAME_PREFIX: awalan nama yang Anda gunakan saat membuat jaringan dan subnet VPC untuk antarmuka IRDMA.
  4. Opsional: Sesuaikan properti instance lainnya, sesuai kebutuhan.
  5. Kirim permintaan.

Langkah berikutnya