Menggunakan antarmuka jaringan IDPF

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

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. 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:

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

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

Fitur yang didukung dengan IDPF

Serupa dengan gVNIC, fitur berikut didukung dengan IDPF:

Keterbatasan 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 terima dan kirim (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 terbatas 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 menyertakan driver IDPF.

Setelah Anda 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 memerlukan image atau versi OS yang berbeda untuk instance bare metal Anda dari yang disediakan oleh Google Cloud, Anda dapat membuat image OS menggunakan Google Cloud CLI atau REST. Untuk mengetahui informasi mendetail dan praktik terbaik dalam membuat image OS kustom, lihat Membuat image OS kustom.

gcloud

Saat membuat image kustom, baik dari image yang disediakan Google Cloud 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 image OS terbaru dalam kelompok image, ganti flag --source-image dengan flag --source-image-family dan tetapkan nilainya ke kelompok image yang mendukung IDPF, misalnya: --source-image-family=sles-15-sp4-sap.

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

    Contoh

    Untuk membuat image OS SUSE Linux Enterprise Server (SLES) menggunakan image OS 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 image OS atau kelompok image yang dipilih di langkah sebelumnya, buat image OS dan beri tag pada image OS ini dengan IDPF. Untuk membuat image OS, 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 image OS tertentu atau kelompok image 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 image OS terbaru yang masih digunakan 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 image OS 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 OS image 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 disk booting, 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: image OS kustom yang dibuat sebelumnya.
    • YOUR_IMAGE_PROJECT: nama project yang berisi image OS 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 image OS 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-megamem-1440-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: Menentukan 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 image disk booting, tentukan image OS 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",
      "subnet":"SUBNET_NAME"
    }
  ],
  "disks":[
    {
      "initializeParams":{
        "sourceImage":"projects/YOUR_IMAGE_PROJECT/global/images/IMAGE_NAME"
      },
      "boot":true
    }
  ]
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat instance 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 image OS.
  • IMAGE_NAME: nama image OS kustom yang dibuat di langkah sebelumnya.

Memverifikasi bahwa 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 selanjutnya