Menggunakan antarmuka jaringan IDPF

Instance bare metal yang tersedia dengan seri mesin seperti C3 dan X4 menggunakan Infrastructure Data Plane Function (IDPF), yang merupakan perangkat fungsi bidang data jaringan PCIe multi-vendor yang standar. IDPF adalah perangkat fisik. Driver IDPF disertakan dalam kernel image sistem operasi (OS) Linux.

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:

    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.

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

Fitur yang didukung dengan IDPF

Mirip dengan gVNIC, fitur berikut didukung dengan IDPF:

Batasan antarmuka jaringan IDPF

Saat menggunakan antarmuka jaringan IDPF, perhatikan batasan berikut:

  • Hanya satu NIC yang didukung untuk instance. Anda tidak dapat membuat instance compute dengan beberapa NIC.
  • IDPF hanya mendukung alokasi antrean default dengan 16 Antrean penerimaan dan transmisi (RX/TX) per NIC.
  • Jika Anda menggunakan DPDK dengan instance bare metal, DPDK akan menggantikan IDPF sebagai driver untuk NIC fisik. Aplikasi DPDK harus meneruskan paket ke kernel, seperti melalui antarmuka TAP.

Ringkasan penggunaan IDPF dengan instance bare metal

Untuk membuat instance bare metal yang menggunakan IDPF, selesaikan langkah-langkah berikut:

  1. Pilih image OS publik yang mendukung IDPF, atau buat image OS kustom yang diberi tag untuk menggunakan IDPF.
  2. Buat instance bare metal menggunakan image OS publik atau kustom. Selama pembuatan instance, konfigurasikan antarmuka jaringan untuk menggunakan IDPF.
  3. Pastikan IDPF diaktifkan.

Dukungan sistem operasi

Di Compute Engine, IDPF tersedia dengan sejumlah kecil image OS publik yang didukung.

Untuk mengetahui informasi tentang sistem operasi yang didukung dengan IDPF, lihat tab Interfaces untuk sistem operasi.

Penggunaan pada sistem operasi yang tidak didukung

Untuk image OS yang tidak mendukung IDPF, hubungi distributor sistem operasi untuk mengetahui apakah driver IDPF disertakan.

Setelah mendapatkan image sistem operasi yang menyertakan IDPF, impor disk virtual yang dapat di-booting yang berisi sistem operasi yang disesuaikan. Kemudian, Anda dapat menggunakan image OS kustom untuk membuat instance bare metal yang menggunakan IDPF pada sistem operasi tersebut. Untuk mengetahui informasi selengkapnya tentang cara membuat image OS kustom untuk digunakan dengan instance bare metal, lihat Membuat image OS kustom yang mendukung IDPF di halaman ini.

Membuat image OS kustom yang mendukung IDPF

Jika Anda memerlukan OS image atau versi yang berbeda untuk instance bare metal dari yang disediakan oleh Google Cloud, Anda dapat membuat OS image menggunakan Google Cloud CLI atau REST. Untuk mengetahui informasi mendetail dan praktik terbaik dalam membuat OS image kustom, baca Membuat OS image kustom.

gcloud

Saat membuat image kustom, baik dari Google Cloud image yang disediakan atau image OS yang diimpor, Anda harus memberi tag pada image OS dengan IDPF. Gunakan perintah gcloud compute images create seperti yang ditunjukkan dalam contoh berikut:

gcloud compute images create IMAGE_NAME \
    --source-image=SOURCE_IMAGE \
    --source-image-project=SOURCE_IMAGE_PROJECT \
    --guest-os-features=IDPF

Ganti kode berikut:

  • IMAGE_NAME: nama untuk image kustom.

  • SOURCE_IMAGE: image OS tertentu yang mendukung IDPF, misalnya: sles-15-sp4-sap-v20240208-x86-64.

    Jika Anda ingin menggunakan OS image terbaru dalam kelompok image, ganti flag --source-image dengan flag --source-image-family dan setel nilainya ke kelompok image yang mendukung IDPF, misalnya: --source-image-family=sles-15-sp4-sap.

  • SOURCE_IMAGE_PROJECT: nama project yang berisi OS image sumber atau kelompok image.

    Contoh

    Untuk membuat OS image SUSE Linux Enterprise Server (SLES) menggunakan OS image terbaru dari kelompok image sles-15-sp5-sap Compute Engine, jalankan perintah berikut:

    gcloud compute images create my-sles15sp5-metal-os \
  --source-image-family=sles-15-sp5-sap \
  --source-image-project=suse-sap-cloud \
  --guest-os-features=IDPF

    Untuk mengetahui informasi selengkapnya tentang kapan harus menggunakan kelompok image, baca Praktik terbaik kelompok image.

REST

  1. Pilih image OS atau kelompok image yang mendukung IDPF Untuk mengetahui informasi selengkapnya, lihat Detail sistem operasi.

  2. Dengan menggunakan OS image atau kelompok image yang dipilih di langkah sebelumnya, buat OS image dan beri tag pada OS image ini dengan IDPF. Untuk membuat OS image, gunakan metode images.insert.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images
{
 "name":"IMAGE_NAME",
 "sourceImage":"SOURCE_IMAGE_URI",
 "guestOsFeatures":[
  {
     "type":"IDPF"
   }
 ]
}

    Ganti kode berikut:

    • IMAGE_NAME: nama untuk image kustom yang Anda buat.

    • SOURCE_IMAGE_URI: URI untuk OS image atau kelompok image tertentu yang ingin Anda gunakan.

      Contoh:

      • OS image tertentu: "sourceImage": "projects/suse-sap-cloud/global/images/sles-15-sp5-sap-v20240427-x86-64"
      • Kelompok image: "sourceImage": "projects/suse-sap-cloud/global/images/family/sles-15-sp5-sap".

      Saat Anda menentukan kelompok image, Compute Engine akan membuat VM dari OS image terbaru yang tidak ditiadakan dalam kelompok tersebut. Untuk mengetahui informasi selengkapnya tentang kapan harus menggunakan kelompok image, lihat Praktik terbaik kelompok image.

Membuat instance bare metal dengan dukungan IDPF

Anda dapat membuat instance bare metal menggunakan salah satu image OS publik yang mendukung IDPF atau menggunakan image OS kustom yang Anda buat menggunakan langkah-langkah di Membuat image OS kustom yang mendukung IDPF.

Membuat instance bare metal menggunakan image OS publik

Untuk membuat instance bare metal menggunakan OS image publik yang mendukung IDPF, ikuti petunjuk di Membuat instance bare metal.

Membuat instance bare metal menggunakan image OS kustom

Jika tidak menggunakan image OS publik yang mendukung IDPF, Anda harus membuat image OS kustom yang mendukung IDPF terlebih dahulu. Kemudian, Anda menggunakan image OS kustom tersebut untuk membuat instance bare metal menggunakan Google Cloud CLI atau REST.

gcloud

  1. Buat instance bare metal menggunakan perintah gcloud compute instances create. Untuk image boot disk, tentukan image OS kustom yang Anda buat sebelumnya. Untuk antarmuka jaringan, tetapkan nilai flag nic-type ke IDPF.

    gcloud compute instances create INSTANCE_NAME \
    --zone=ZONE \
    --image=IMAGE_NAME \
    --image-project=YOUR_IMAGE_PROJECT \
    --network-interface=nic-type=IDPF

    Ganti kode berikut:

    • INSTANCE_NAME: nama untuk instance baru.
    • ZONE: zona tempat instance dibuat.
    • IMAGE_NAME: OS image kustom yang dibuat sebelumnya.
    • YOUR_IMAGE_PROJECT: nama project yang berisi OS image kustom.

  2. Opsional: Pastikan Compute Engine membuat instance dan nicType ditetapkan ke IDPF.

    gcloud compute instances describe INSTANCE_NAME \
   --zone=ZONE

    Ganti kode berikut:

    • INSTANCE_NAME: nama instance.
    • ZONE: zona tempat Anda membuat instance.

    Contoh

    Untuk membuat instance bare metal di zona eu-west4-b menggunakan OS image SLES 15 SP5 untuk SAP yang disesuaikan bernama my-sles15sp5-metal-os yang ada dalam project my-project-12345, jalankan perintah berikut:

    gcloud compute instances create test-x4-metal-custom-os \
    --zone=eu-west4-b \
    --machine-type=x4-1440-24t-metal \
    --image=my-sles15sp5-metal-os \
    --image-project=my-project-12345 \
    --network-interface=nic-type=IDPF

    Hal-hal yang perlu dipertimbangkan

    Flag --network-interface memiliki flag sub-level seperti berikut:

    • --address: Menetapkan alamat IP ke instance
    • --network: Jaringan tempat antarmuka akan menjadi bagiannya
    • --network-tier: Tingkat jaringan antarmuka
    • --subnet: Subnet tempat antarmuka akan menjadi bagiannya. Jika --network juga ditentukan, subnet harus menjadi bagian dari jaringan yang ditentukan.
    • --private-network-ip: Tentukan IP RFC 1918 yang akan ditetapkan ke instance.

    Untuk mengetahui daftar lengkapnya, baca flag --network-interface.

REST

Buat instance bare metal menggunakan metode instances.insert.

  • Untuk boot disk image, tentukan OS image kustom yang Anda buat sebelumnya.
  • Untuk antarmuka jaringan, tetapkan nilai kolom nicType ke IDPF.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "name":"INSTANCE_NAME",
  "networkInterfaces":[
    {
      "nicType":"IDPF",
      "network":"NETWORK",
      "subnetwork":"SUBNET_NAME"
    }
  ],
  "disks":[
    {
      "initializeParams":{
        "sourceImage":"projects/YOUR_IMAGE_PROJECT/global/images/IMAGE_NAME"
      },
      "boot":true
    }
  ]
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat instance akan dibuat.
  • ZONE: zona tempat instance dibuat.
  • INSTANCE_NAME: nama untuk instance baru.
  • NETWORK: URL resource jaringan untuk instance ini. Jika jaringan atau subnetwork tidak ditentukan, jaringan default global/networks/default akan digunakan.
  • SUBNET_NAME: nama subnet. Jaringan disimpulkan dari subnet yang ditentukan. Kolom ini bersifat opsional.
  • YOUR_IMAGE_PROJECT: nama project Anda yang berisi OS image.
  • IMAGE_NAME: nama image OS kustom yang dibuat di langkah sebelumnya.

Memastikan IDPF diaktifkan

Anda dapat menggunakan alat lshw untuk mengekstrak informasi mendetail tentang konfigurasi hardware instance bare metal.

Untuk menginstal alat lshw di instance Linux, buka koneksi SSH ke OS tamu, lalu jalankan perintah berikut:

sudo apt-get install lshw -y

Untuk menentukan apakah instance menggunakan antarmuka jaringan IDPF, jalankan perintah berikut:

sudo lshw -class network

Berikut adalah contoh output-nya:

*-network
       description: Ethernet interface
       product: Intel Corporation
       vendor: Intel Corporation
       physical id: 0
       bus info: pci@0000:05:00.0
       logical name: enp5s0f0
       version: 11
       serial: 42:01:0a:96:00:02
       width: 64 bits
       clock: 33MHz
       capabilities: pm msi msix pciexpress bus_master cap_list ethernet physical
       configuration: autonegotiation=off broadcast=yes driver=idpf driverversion=6.5.0-1023-gcp duplex=full ip=10.150.0.2 latency=0 link=yes multicast=yes
       resources: iomemory:21ff0-21fef iomemory:21ff0-21fef irq:16 memory:21ffe0000000-21ffefffffff memory:21fff2000000-21fff203ffff

Langkah berikutnya