Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Membuat instance yang menggunakan Cloud RDMA

Dokumen ini menjelaskan cara membuat instance komputasi dengan antarmuka jaringan Cloud RDMA (IRDMA) untuk komunikasi berlatensi rendah dan throughput tinggi antar-instance.

Membuat instance yang mendukung Cloud RDMA melibatkan langkah-langkah berikut:

Buat kebijakan penempatan rapat.
Buat jaringan Virtual Private Cloud, termasuk jaringan VPC standar (GVNIC atau IDPF) dan jaringan VPC Falcon (IRDMA).
Buat instance dengan antarmuka jaringan dan kebijakan penempatan.

Untuk mengetahui petunjuk cara membuat instance yang dioptimalkan akselerator (seperti A4X Max, A4X, A4, atau A3 Ultra) yang menggunakan RDMA, lihat Membuat instance yang dioptimalkan AI.

Sebelum memulai

Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau sampel 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 Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.
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.
  
  Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.
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.

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 untuk membuat instance yang mendukung Cloud RDMA, 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 yang mendukung Cloud RDMA. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat instance yang mendukung Cloud RDMA:

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 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 metadata instance VM untuk VM: compute.instances.setMetadata pada 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 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.

Persyaratan

Tinjau aturan berikut untuk mengonfigurasi antarmuka jaringan untuk instance:

Untuk mengonfigurasi antarmuka jaringan IRDMA, Anda harus membuat jaringan VPC dengan profil jaringan Falcon RDMA terlebih dahulu di region dan zona yang sama dengan instance.
Untuk antarmuka jaringan gVNIC atau IDPF, Anda harus menggunakan VPC reguler. Jika Anda tidak menentukan jaringan atau subnet, Compute Engine akan menggunakan jaringan VPC default dan subnet otomatis yang berada di dalam region yang sama dengan instance tersebut.
Jika Anda menentukan subnet, tetapi tidak menentukan jaringan, Compute Engine akan menyimpulkan jaringan dari subnet yang telah ditentukan.
Jika menentukan jaringan, Anda harus menentukan subnet dan subnet tersebut harus berasal dari jaringan yang sama. Jika tidak, pembuatan instance akan gagal.

Batasan

Anda tidak dapat menggunakan migrasi langsung dengan virtual machine (VM) yang menggunakan Cloud RDMA. Anda harus mengonfigurasi instance agar dihentikan selama peristiwa pemeliharaan.
Anda tidak dapat menggunakan Cloud RDMA dengan grup instance terkelola (MIG) (terkelola atau tidak terkelola).
Anda hanya dapat menggunakan jenis stack jaringan IPv4_ONLY dengan instance yang mendukung Cloud RDMA.
Anda hanya dapat menggunakan seri mesin yang mendukung Cloud RDMA, seperti seri mesin H4D atau seri mesin Z4M.
Instance harus menggunakan OS image yang mendukung IRDMA.

Membuat instance yang mendukung Cloud RDMA

Instance yang menggunakan Cloud RDMA memerlukan setidaknya dua antarmuka jaringan virtual (vNIC) per NIC fisik, yang dikonfigurasi dari jenis antarmuka jaringan berikut:

Jenis antarmuka jaringan GVNIC: VM menggunakan driver gve untuk traffic TCP/IP dan traffic internet untuk komunikasi VM ke VM dan VM ke Internet yang normal
Jenis antarmuka jaringan IDPF: instance bare metal menggunakan jenis antarmuka jaringan IDPF, bukan GVNIC untuk komunikasi normal antar-instance dan instance ke Internet.
Jenis antarmuka jaringan IRDMA: menggunakan driver IDPF/iRDMA untuk komunikasi berbasis RDMA antar-instance komputasi. Antarmuka ini harus menggunakan profil jaringan RDMA Falcon.

Jumlah antarmuka jaringan dari setiap jenis yang dapat Anda konfigurasi untuk instance bergantung pada seri mesin, seperti yang dijelaskan dalam tabel berikut:

Seri mesin	Jenis antarmuka jaringan	Jumlah yang akan dikonfigurasi
H4D	Khusus GVNIC	GVNIC: 1 hingga 10
H4D	GVNIC dan IRDMA	GVNIC: 1 hingga 9 IRDMA: 1
VM Z4M	Khusus GVNIC	GVNIC: 1 hingga 10
VM Z4M (< 192 vCPU)	GVNIC dan IRDMA	GVNIC: 1 hingga 9 IRDMA: 1
VM Z4M (192 vCPU)	GVNIC dan IRDMA	GVNIC: 1 hingga 9 IRDMA: 1 hingga 2
Z4M (bare metal)	Khusus IDPF	IDPF: 1 hingga 2
Z4M (bare metal)	IDPF dan IRDMA	1 IDPF dan 1 IRDMA atau 2 IDPF dan 1 atau 2 IRDMA

Jumlah antarmuka jaringan IRDMA untuk instance bare metal tidak boleh melebihi jumlah antarmuka jaringan IDPF. Selain itu, untuk instance multi-NIC, agar dapat menetapkan jenis antarmuka jaringan dengan benar ke setiap NIC fisik, Anda harus menentukan antarmuka GVNIC atau IDPF sebelum setiap antarmuka IRDMA. Contoh berikut menjelaskan kemungkinan konfigurasi:

VM multi-NIC dengan 1 antarmuka jaringan IRDMA dan 4 antarmuka jaringan GVNIC: Konfigurasikan antarmuka jaringan dalam urutan ini: GVNIC, IRDMA, GVNIC, GVNIC, GVNIC. Hal ini menghasilkan penetapan berikut:
- NIC 0: GVNIC, IRDMA, GVNIC
- NIC 1: GVNIC, GVNIC
VM multi-NIC dengan 2 antarmuka jaringan IRDMA dan 5 antarmuka jaringan GVNIC: Konfigurasikan antarmuka jaringan dalam urutan ini: GVNIC, IRDMA, GVNIC, IRDMA, GVNIC, GVNIC, GVNIC. Hal ini menghasilkan penetapan berikut:
- NIC 0: GVNIC, IRDMA, GVNIC, GVNIC
- NIC 1: GVNIC, IRDMA, GVNIC

Untuk ringkasan beberapa antarmuka jaringan di Google Cloud, lihat Beberapa antarmuka jaringan.

Untuk membuat instance yang menggunakan IRDMA, selesaikan langkah-langkah di bagian berikut:

Buat kebijakan penempatan, jika belum ada kebijakan yang sesuai.
Buat jaringan VPC baru, atau gunakan jaringan VPC Falcon yang sudah ada.
Buat instance yang mendukung Cloud RDMA yang memiliki setidaknya satu antarmuka jaringan GVNIC atau IDPF, setidaknya satu antarmuka jaringan IRDMA, dan menggunakan kebijakan penempatan rapat.

Membuat kebijakan penempatan untuk instance Cloud RDMA

Instance yang berkomunikasi menggunakan Cloud RDMA harus berada di satu zona, dan lebih ketat lagi dalam satu fabric cluster. Anda dapat membuat kebijakan penempatan rapat dan menentukan nilai jarak maksimum untuk menetapkan kerapatan minimum dalam zona. Ada batasan jumlah instance yang dapat Anda tetapkan kebijakan penempatan rapatnya saat Anda menentukan nilai jarak maksimum, dan batasnya berubah bergantung pada nilai yang Anda pilih.

Untuk membuat kebijakan penempatan rapat yang akan digunakan dengan instance Cloud RDMA Anda, ikuti langkah-langkah di bagian Membuat kebijakan penempatan rapat dan tentukan nilai jarak maksimum 3 atau lebih rendah.

Membuat jaringan Virtual Private Cloud

Untuk menyiapkan jaringan, Anda dapat mengikuti petunjuk yang terdokumentasi atau menggunakan skrip yang disediakan.

Panduan petunjuk

Untuk membuat jaringan, Anda dapat menggunakan petunjuk berikut:

Untuk membuat jaringan host untuk antarmuka jaringan GVNIC atau IDPF, lihat Membuat dan mengelola jaringan VPC.

Jika Anda hanya mengonfigurasi satu antarmuka jaringan GVNIC atau IDPF, Anda dapat menggunakan jaringan VPC default dan subnet otomatis yang berada di region yang sama dengan instance.
Untuk membuat jaringan untuk antarmuka jaringan IRDMA, lihat Membuat jaringan VPC untuk NIC RDMA dan gunakan profil jaringan RDMA Falcon. Tetapkan unit transmisi maksimum (MTU) ke 8896 untuk jaringan VPC Falcon.

Skrip

Untuk membuat jaringan, Anda dapat menggunakan skrip berikut.

Opsional: Sebelum menjalankan skrip, cantumkan profil jaringan Falcon RDMA untuk memverifikasi ketersediaannya.
```
gcloud compute network-profiles list --filter=falcon
```
Salin kode berikut dan jalankan di jendela shell Linux.

#!/bin/bash

# Create standard VPC (network and subnet) for the GVNIC or IDPF interface
  gcloud compute networks create GVNIC_NAME_PREFIX-net-0 \
    --subnet-mode=custom

  gcloud compute networks subnets create GVNIC_NAME_PREFIX-sub-0 \
    --network=GVNIC_NAME_PREFIX-net-0 \
    --region=REGION \
    --range=10.0.0.0/16

  gcloud compute firewall-rules create GVNIC_NAME_PREFIX-internal-0 \
    --network=GVNIC_NAME_PREFIX-net-0 \
    --action=ALLOW \
    --rules=tcp:0-65535,udp:0-65535,icmp \
    --source-ranges=10.0.0.0/8

# 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 an external IP for only the GVNIC or IDPF 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 network for Cloud RDMA over Falcon transport
gcloud compute networks create RDMA_NAME_PREFIX-irdma \
  --network-profile=ZONE-vpc-falcon \
  --subnet-mode custom

# Create subnet for Cloud RDMA
gcloud compute networks subnets create RDMA_NAME_PREFIX-irdma-sub \
    --network=RDMA_NAME_PREFIX-irdma \
    --region=REGION \
    --range=10.1.0.0/16  # offset to avoid overlap with GVNIC or IDPF network

Ganti kode berikut:

GVNIC_NAME_PREFIX: awalan nama yang akan digunakan untuk jaringan dan subnet Virtual Private Cloud reguler yang menggunakan jenis NIC GVNIC atau IDPF.
RDMA_NAME_PREFIX: awalan nama yang akan digunakan untuk jaringan dan subnet Virtual Private Cloud yang menggunakan jenis NIC IRDMA.
ZONE: zona tempat Anda ingin membuat jaringan dan instance komputasi. Gunakan us-central1-a atau europe-west4-b.
REGION: region tempat Anda ingin membuat jaringan. Ini harus sesuai dengan zona yang ditentukan. Misalnya, jika zona Anda adalah 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 mengizinkan traffic dari semua sumber IPv4 atau IPv6, termasuk sumber di luarGoogle Cloud.

Membuat instance yang mendukung Cloud RDMA

Langkah-langkah berikut menunjukkan cara membuat instance dengan antarmuka jaringan pertama yang dikonfigurasi sebagai antarmuka gVNIC atau IDPF, dan antarmuka jaringan kedua yang dikonfigurasi sebagai antarmuka jaringan IRDMA:

Konsol

Di konsol Google Cloud , buka halaman Create an instance.

Buka halaman Buat instance

Jika diminta, pilih project Anda, lalu klik Lanjutkan.

Halaman Create an instance akan muncul dan menampilkan panel Machine configuration.
Di panel Machine configuration, lakukan hal berikut:
1. Di kolom Name, tentukan nama untuk instance Anda. Untuk mengetahui informasi selengkapnya, lihat Konvensi penamaan resource.
2. Opsional: Di kolom Zone, pilih zona untuk instance ini.
  
  Pilih zona yang Anda gunakan untuk menyiapkan jaringan VPC Falcon.
3. Pilih kelompok mesin dan seri mesin yang didukung.
4. Di bagian Machine type, pilih jenis mesin untuk instance Anda.
Di menu navigasi sebelah kiri, klik OS and Storage. Di panel Sistem operasi dan penyimpanan yang muncul, lakukan hal berikut:
1. Di bagian bawah Sistem operasi & Penyimpanan, klik Ubah.
2. Dalam daftar Sistem operasi dan Versi, pilih jenis dan versi OS yang menawarkan dukungan Cloud RDMA.
3. Pastikan Boot disk type ditetapkan ke Hyperdisk Balanced.
4. Klik Select di bagian bawah panel untuk menyimpan perubahan.
Di menu navigasi sisi kiri, klik Networking. Di panel Networking yang muncul, lakukan hal berikut:
1. Buka bagian Network interfaces. Seharusnya sudah ada satu antarmuka jaringan, berlabel default.
2. Klik Add a network interface. Di bagian New network interface yang muncul, lakukan hal berikut:
  1. Dalam daftar kartu antarmuka jaringan (NIC), pilih IRDMA.
  2. Di kolom Network, pilih jaringan VPC Falcon.
  3. Opsional: Di daftar Subnetwork, pilih subnet yang akan digunakan instance.
  4. Di kolom IP stack type, pastikan kolom tersebut disetel ke IPV4-only.
  5. Dalam daftar External IPv4 address, pilih None.
  6. Untuk mengonfirmasi detail antarmuka jaringan, klik Done.
Opsional: Tentukan opsi konfigurasi lainnya untuk instance. Untuk mengetahui informasi selengkapnya, lihat Opsi konfigurasi selama pembuatan instance.
Untuk membuat dan memulai instance, klik Create.

gcloud

Di konsol Google Cloud , aktifkan Cloud Shell.

Aktifkan Cloud Shell

Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan prompt command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.
Gunakan perintah gcloud compute instances create dengan setidaknya dua flag --network-interface, satu untuk antarmuka GVNIC atau IDPF dan satu untuk antarmuka IRDMA. Anda dapat menyesuaikan opsi perintah lainnya sesuai kebutuhan.

Catatan: Antarmuka jaringan gVNIC atau IDPF hanya dapat memiliki satu alamat IPv6, baik internal maupun eksternal, tetapi tidak keduanya. Antarmuka jaringan IRDMA hanya dapat menggunakan alamat IPv4.
```
gcloud compute instances create INSTANCE_NAME \
    --zone=ZONE \
    --machine-type=MACHINE_TYPE \
    --create-disk=boot=yes, \
        image=projects/IMAGE_PROJECT/global/images/IMAGE, \
        size=SIZE \
    --maintenance-policy=TERMINATE \
    --network-interface \
        nic-type=GVNIC, \
        network=NETWORK_NAME,subnet=SUBNET_NAME, \
        stack-type=STACK_TYPE, \
        private-network-ip=INTERNAL_IPV4_ADDRESS, \
        address=EXTERNAL_IPV4_ADDRESS \
    --network-interface \
        nic-type=IRDMA, \
        network=RDMA_NETWORK_NAME,subnet=RDMA_SUBNET_NAME, \
        stack-type=IPV4_ONLY, \
        no-address \
```
Ganti kode berikut:
- INSTANCE_NAME: name instance komputasi
- ZONE: zona tempat instance dibuat, seperti europe-west1-b. Region instance diinferensikan dari zona tersebut.
- MACHINE_TYPE: jenis mesin yang didukung untuk digunakan pada instance.
- IMAGE_PROJECT: Opsional: project image yang berisi image
- IMAGE: Opsional: tentukan salah satu dari berikut ini:
  - Versi tertentu dari OS image—misalnya, hpc-rocky-linux-8-v20250721.
  - Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Hal ini akan membuat instance dari OS image terbaru yang masih digunakan. Misalnya, jika Anda menentukan family/hpc-rocky-linux-8, Compute Engine akan membuat instance menggunakan versi OS image terbaru dalam kelompok image HPC Rocky Linux 8. Untuk mengetahui informasi selengkapnya tentang cara menggunakan kelompok image, lihat Praktik terbaik kelompok image.
- SIZE: Opsional: ukuran disk baru. Nilai harus berupa bilangan bulat. Satuan ukuran default adalah GiB.
- NETWORK_NAME: Opsional: nama jaringan tersebut
- SUBNET_NAME: nama subnet yang akan digunakan untuk antarmuka jaringan. Untuk melihat daftar subnet di dalam jaringan, gunakan perintah gcloud compute networks subnets list.
  
  Untuk antarmuka jaringan GVNIC atau IDPF, Anda dapat menghilangkan flag network dan subnet, lalu menggunakan jaringan default.
- STACK_TYPE: Opsional: jenis stack untuk antarmuka jaringan GVNIC atau IDPF. STACK_TYPE harus berupa salah satu dari: IPV4_ONLY, IPV4_IPV6, atau IPV6_ONLY. Nilai defaultnya adalah IPV4_ONLY.
- INTERNAL_IPV4_ADDRESS: Opsional: alamat IPv4 internal yang Anda inginkan untuk digunakan oleh instance komputasi di subnet target. Hilangkan flag ini jika Anda tidak memerlukan alamat IP tertentu.
  
  Untuk menentukan alamat IPv6 internal, gunakan flag --internal-ipv6-address.
- EXTERNAL_IPV4_ADDRESS: Opsional: alamat IPv4 eksternal statis yang akan digunakan dengan antarmuka jaringan. Anda harus sudah mencadangkan alamat IPv4 eksternal sebelumnya. Lakukan salah satu hal berikut:
  - Tentukan alamat IPv4 yang valid dari subnet.
  - Gunakan flag no-address 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_NETWORK_NAME: Nama jaringan VPC yang Anda buat dengan profil jaringan RDMA Falcon.
- RDMA_SUBNET_NAME: Nama subnet di jaringan VPC Falcon.

REST

Untuk membuat instance yang dikonfigurasi untuk menggunakan Cloud RDMA, buat permintaan POST ke metode instances.insert. Sertakan objek networkInterfaces dengan setidaknya dua konfigurasi jaringan, satu untuk antarmuka gVNIC atau IDPF dan satu untuk antarmuka IRDMA. Anda dapat menyesuaikan properti instance lainnya sesuai kebutuhan.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: ID project tempat instance akan dibuat
ZONE: zona untuk membuat instance
MACHINE_TYPE: jenis mesin yang didukung, misalnya, h4d-highmem-192-lssd
INSTANCE_NAME: nama untuk instance baru
IMAGE_PROJECT: Opsional: project image yang berisi image
IMAGE: Opsional: tentukan salah satu dari berikut ini:
- Versi tertentu dari OS image—misalnya, debian-12-bookworm-v20250415
- Kelompok image, yang harus diformat sebagai family/IMAGE_FAMILY. Hal ini akan membuat instance dari OS image terbaru yang masih digunakan. Misalnya, jika Anda menentukan family/debian-12, Compute Engine akan membuat instance menggunakan versi OS image terbaru dalam kelompok image Debian 12. Untuk mengetahui informasi selengkapnya tentang cara menggunakan kelompok image, lihat Praktik terbaik kelompok image.
NETWORK_NAME: Opsional: nama jaringan yang akan digunakan dengan antarmuka jaringan gVNIC atau IDPF
SUBNET_NAME: nama subnet yang akan digunakan dengan antarmuka jaringan gVNIC atau IDPF

Untuk antarmuka jaringan GVNIC atau IDPF, Anda dapat menghilangkan properti network dan subnet, lalu menggunakan jaringan default.
INTERNAL_IPV4_ADDRESS: Opsional: alamat IPv4 internal yang Anda inginkan untuk digunakan instance komputasi di subnet target. Hapus tanda ini jika Anda tidak memerlukan alamat IP tertentu.
EXTERNAL_IPV4_ADDRESS: Opsional: alamat IPv4 eksternal statis yang akan digunakan dengan antarmuka jaringan. Anda harus sebelumnya mencadangkan alamat IPv4 eksternal.
RDMA_NETWORK_NAME: nama jaringan yang Anda buat dengan profil jaringan RDMA
RDMA_SUBNET_NAME: nama subnet di jaringan RDMA

Metode HTTP dan URL:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

Meminta isi JSON:

{
    "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
    "name": "INSTANCE_NAME",
    "disks": [
      {
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        },
        "boot": true
      }
    ],
    "networkInterfaces": [
      {
        "network": "NETWORK_NAME",
        "subnetwork": "SUBNET_NAME",
        "networkIP": "INTERNAL_IPV4_ADDRESS",
        "accessConfigs": [
          {
            "type": "ONE_TO_ONE_NAT",
            "name": "External IP",
            "natIP": "EXTERNAL_IPV4_ADDRESS"
          }
        ],
        "stackType": "IPV4_ONLY",
        "nicType": "GVNIC",
      },
      {
        "network": "RDMA_NETWORK_NAME",
        "subnetwork": "RDMA_SUBNET_NAME",
        "stackType": "IPV4_ONLY",
        "nicType": "IRDMA",
      }
    ]
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "kind": "compute#operation",
  "id": "9216044482154695709",
  "name": "operation-1739207409646-62dccc7d7bc58-d1350b42-64fdb7f7",
  "zone": "https://www.googleapis.com/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`",
  "operationType": "insert",
  "targetLink": "https://www.googleapis.com/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`/instances/`INSTANCE_NAME`",
  "targetId": "2679381553616227357",
  "status": "RUNNING",
  "user": "USER_ID",
  "progress": 0,
  "insertTime": "2025-02-10T09:10:10.551-08:00",
  "startTime": "2025-02-10T09:10:10.551-08:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/`PROJECT_ID`/zones/`ZONE`/operations/operation-1565289606387-58f9f62f5989c-e582f586-6d22f38"
 "kind": "compute#operation"
}

Apa langkah selanjutnya?

Pelajari cara memeriksa status instance untuk mengetahui kapan instance siap digunakan.
Pelajari cara terhubung ke instance Anda.
Pelajari alamat IP yang ditetapkan saat Anda membuat instance.
Pelajari cara membuat instance dual-stack atau khusus IPv6.

Membuat instance yang menggunakan Cloud RDMA Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Konsol

gcloud

REST

Peran yang diperlukan

Izin yang diperlukan

Persyaratan

Batasan

Membuat instance yang mendukung Cloud RDMA

Membuat kebijakan penempatan untuk instance Cloud RDMA

Membuat jaringan Virtual Private Cloud

Panduan petunjuk

Skrip

Membuat instance yang mendukung Cloud RDMA

Konsol

gcloud

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Apa langkah selanjutnya?

Membuat instance yang menggunakan Cloud RDMA