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

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Trusted Cloud by S3NS layanan dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi 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. Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

      gcloud init
    2. Set a default region and zone.

    REST

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

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

      gcloud init

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted 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 image atau versi OS yang berbeda untuk instance bare metal Anda daripada yang disediakan oleh Trusted Cloud by S3NS, 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 Trusted Cloud by S3NS 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 image OS 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 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.s3nsapis.fr/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 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 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 image OS kustom tersebut untuk membuat instance bare metal dengan 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: 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 for SAP yang disesuaikan bernama my-sles15sp5-metal-os yang ada di 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 boot disk, tentukan image OS kustom yang Anda buat sebelumnya.
  • Untuk antarmuka jaringan, tetapkan nilai kolom nicType ke IDPF.
POST https://compute.s3nsapis.fr/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 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 image OS.
  • IMAGE_NAME: nama image OS kustom yang dibuat di langkah sebelumnya.

Pastikan IDPF diaktifkan

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

Untuk menginstal alat lshw di instance Linux Anda, 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