Consenti un'elaborazione più rapida dei pacchetti di rete con DPDK

Questo documento spiega come attivare il Data Plane Development Kit (DPDK) su un'istanza di una macchina virtuale (VM) per un'elaborazione più rapida dei pacchetti di rete.

DPDK è un framework per applicazioni con esigenze di prestazioni elevate che richiedono un'elaborazione rapida dei pacchetti, bassa latenza e prestazioni costanti. DPDK fornisce un insieme di librerie del piano dati e un controller dell'interfaccia di rete (NIC) che ignora la rete del kernel e viene eseguito direttamente nello spazio utente. Ad esempio, l'attivazione di DPDK sulla VM è utile quando esegui:

Deployment con virtualizzazione delle funzioni di rete (NFV)
Applicazioni di networking software-defined (SDN)
Applicazioni di streaming video o VoIP

Puoi eseguire DPDK su una VM utilizzando uno dei seguenti tipi di NIC virtuali (vNIC):

Consigliato: gVNIC

Un'interfaccia di rete virtuale ad alte prestazioni, sicura e scalabile progettata specificamente per Compute Engine che sostituisce virtIO come vNIC di nuova generazione.
VirtIO-Net

Un driver ethernet open source che consente alle VM di accedere in modo efficiente ad hardware fisici, come l'archiviazione a blocchi e gli adattatori di rete.

Un problema con l'esecuzione di DPDK in un ambiente virtuale, anziché su hardware fisico, è che gli ambienti virtuali non supportano SR-IOV e IOMMU (I/O Memory Management Unit) per le applicazioni ad alte prestazioni. Per superare questa limitazione, devi eseguire DPDK sugli indirizzi fisici guest anziché sugli indirizzi virtuali dell'host utilizzando uno dei seguenti driver:

Userspace I/O (UIO)
Virtual Function I/O (VFIO) senza IOMMU

Prima di iniziare

Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso a servizi e API di Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

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. Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command:
  gcloud init
  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
  
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.
REST

Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.
Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Requisiti

Quando crei una VM su cui eseguire DPDK, assicurati di quanto segue:

Per evitare una mancanza di connettività di rete durante l'esecuzione delle applicazioni, utilizza due reti Virtual Private Cloud:
- Una rete VPC per il control plane
- Una rete VPC per il piano dati
Entrambe le reti VPC devono specificare quanto segue:
- Una subnet con un intervallo di indirizzi IP univoco
- La stessa regione per le relative subnet
- Lo stesso tipo di VNIC: gVNIC o VirtIO-Net
Quando crei la VM:
- Devi specificare la stessa regione delle subnet delle due reti VPC.
- Devi specificare il tipo di vNIC che prevedi di utilizzare con DPDK.
- Devi specificare una serie di macchine supportata per gVNIC o VirtIO-Net.

Limitazioni

L'esecuzione di DPDK su una VM presenta le seguenti limitazioni:

Puoi utilizzare solo subnet a stack singolo per le due reti VPC utilizzate nella VM.
Se utilizzi gVNIC come tipo di vNIC per le due reti VPC, verifica quanto segue:
- Devi utilizzare DPDK versione 22.11 o successive.
- Puoi utilizzare solo immagini disco supportate.
Se vuoi attivare le prestazioni di rete Tier_1 per VM per migliorare le prestazioni di rete durante la creazione della VM, devi specificare quanto segue:
- gVNIC come tipo di vNIC
- Un tipo di macchina supportato con almeno 30 vCPU

Configura una VM per l'esecuzione di DPDK

Questa sezione spiega come creare una VM su cui eseguire DPDK.

Crea le reti VPC

Crea due reti VPC, per il piano dati e il control plane, utilizzando la console Google Cloud , Google Cloud CLI o l'API Compute Engine. Puoi specificare queste reti in un secondo momento durante la creazione della VM.

Console

Crea una rete VPC per il piano dati:
1. Nella console Google Cloud , vai a Reti VPC.
  
  Vai a Reti VPC
  
  Viene visualizzata la pagina Reti VPC.
2. Fai clic su Crea rete VPC.
  
  Viene visualizzata la pagina Crea una rete VPC.
3. Nel campo Nome, inserisci un nome per la rete.
4. Nella sezione Nuova subnet, segui questi passaggi:
  1. Nel campo Nome, inserisci un nome per la subnet.
  2. Nel menu Regione, seleziona una regione per la subnet.
  3. Seleziona IPv4 (stack singolo) (valore predefinito).
  4. In Intervallo IPv4, inserisci un indirizzo in un intervallo IPv4 valido in notazione CIDR.
  5. Fai clic su Fine.
5. Fai clic su Crea.
  
  Viene visualizzata la pagina Reti VPC. Potrebbe essere necessario fino a un minuto per il completamento della creazione della rete VPC.
Crea una rete VPC per il control plane con una regola firewall per consentire le connessioni SSH alla VM:
1. Fai di nuovo clic su Crea rete VPC.
  
  Viene visualizzata la pagina Crea una rete VPC.
2. Nel campo Nome, inserisci un nome per la rete.
3. Nella sezione Nuova subnet, segui questi passaggi:
  1. Nel campo Nome, inserisci un nome per la subnet.
  2. Nel menu Regione, seleziona la stessa regione specificata per la subnet della rete del piano dati.
  3. Seleziona IPv4 (stack singolo) (valore predefinito).
  4. In Intervallo IPv4, inserisci un indirizzo in un intervallo IPv4 valido in notazione CIDR.
    
    Importante: specifica un intervallo IPv4 diverso da quello specificato nella subnet per la rete del piano dati. In caso contrario, la creazione della rete non va a buon fine.
  5. Fai clic su Fine.
4. Nella scheda Regole firewall IPv4, seleziona la casella di controllo NETWORK_NAME-allow-ssh.
  
  Dove NETWORK_NAME è il nome della rete specificato nei passaggi precedenti.
5. Fai clic su Crea.
  
  Viene visualizzata la pagina Reti VPC. Potrebbe essere necessario fino a un minuto per il completamento della creazione della rete VPC.

gcloud

Per creare una rete VPC per il piano dati, segui questi passaggi:
1. Crea una rete VPC con una subnet creata manualmente utilizzando il comando gcloud compute networks create con il flag --subnet-mode impostato su custom.
```
gcloud compute networks create DATA_PLANE_NETWORK_NAME \
    --bgp-routing-mode=regional \
    --mtu=MTU \
    --subnet-mode=custom
```
  Sostituisci quanto segue:
  - DATA_PLANE_NETWORK_NAME: il nome della rete VPC per il piano dati.
  - MTU: l'unità massima di trasmissione (MTU), che rappresenta la dimensione massima di un pacchetto della rete. Il valore deve essere compreso tra 1300 e 8896. Il valore predefinito è 1460. Prima di impostare l'MTU su un valore superiore a 1460, consulta Unità massima di trasmissione.
2. Crea una subnet per la rete del piano dati VPC che hai appena creato utilizzando il comando gcloud compute networks subnets create.
```
gcloud compute networks subnets create DATA_PLANE_SUBNET_NAME \
    --network=DATA_PLANE_NETWORK_NAME \
    --range=DATA_PRIMARY_RANGE \
    --region=REGION
```
  Sostituisci quanto segue:
  - DATA_PLANE_SUBNET_NAME: il nome della subnet per la rete del piano dati.
  - DATA_PLANE_NETWORK_NAME: il nome della rete del piano dati specificato nei passaggi precedenti.
  - DATA_PRIMARY_RANGE: un intervallo IPv4 valido per la subnet in notazione CIDR.
  - REGION: la regione in cui creare la subnet.
Per creare una rete VPC per il control plane con una regola firewall per consentire le connessioni SSH alla VM, segui questi passaggi:
1. Crea una rete VPC con una subnet creata manualmente utilizzando il comando gcloud compute networks create con il flag --subnet-mode impostato su custom.
```
gcloud compute networks create CONTROL_PLANE_NETWORK_NAME \
    --bgp-routing-mode=regional \
    --mtu=MTU \
    --subnet-mode=custom
```
  Sostituisci quanto segue:
  - CONTROL_PLANE_NETWORK_NAME: il nome della rete VPC per il control plane.
  - MTU: l'MTU, ovvero la dimensione massima di un pacchetto della rete. Il valore deve essere compreso tra 1300 e 8896. Il valore predefinito è 1460. Prima di impostare l'MTU su un valore superiore a 1460, consulta Unità massima di trasmissione.
2. Crea una subnet per la rete del control plane VPC che hai appena creato utilizzando il comando gcloud compute networks subnets create.
```
gcloud compute networks subnets create CONTROL_PLANE_SUBNET_NAME \
    --network=CONTROL_PLANE_NETWORK_NAME \
    --range=CONTROL_PRIMARY_RANGE \
    --region=REGION
```
  Sostituisci quanto segue:
  - CONTROL_PLANE_SUBNET_NAME: il nome della subnet per la rete del control plane.
  - CONTROL_PLANE_NETWORK_NAME: il nome della rete del control plane specificato nei passaggi precedenti.
  - CONTROL_PRIMARY_RANGE: un intervallo IPv4 valido per la subnet in notazione CIDR.
    
    Importante: specifica un intervallo IPv4 diverso da quello specificato nella subnet della rete del piano dati. In caso contrario, la creazione della subnet non andrà a buon fine.
  - REGION: la regione in cui creare la subnet, che deve corrispondere alla regione specificata nella subnet della rete del piano dati.
3. Crea una regola firewall VPC che consenta l'accesso SSH alla rete del control plane utilizzando il comando gcloud compute firewall-rules create con il flag --allow impostato su tcp:22.
```
gcloud compute firewall-rules create FIREWALL_RULE_NAME \
    --action=allow \
    --network=CONTROL_PLANE_NETWORK_NAME \
    --rules=tcp:22
```
  Sostituisci quanto segue:
  - FIREWALL_RULE_NAME: il nome della regola firewall.
  - CONTROL_PLANE_NETWORK_NAME: il nome della rete del control plane creata nei passaggi precedenti.

API

Per creare una rete VPC per il piano dati, segui questi passaggi:
1. Crea una rete VPC con una subnet creata manualmente inviando una richiesta POST al metodo networks.insert con il campo autoCreateSubnetworks impostato su false.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks

{
  "autoCreateSubnetworks": false,
  "name": "DATA_PLANE_NETWORK_NAME",
  "mtu": MTU
}
```
  Sostituisci quanto segue:
  - PROJECT_ID: l'ID del progetto corrente.
  - DATA_PLANE_NETWORK_NAME: il nome della rete per il piano dati.
  - MTU: l'unità massima di trasmissione (MTU), che rappresenta la dimensione massima di un pacchetto della rete. Il valore deve essere compreso tra 1300 e 8896. Il valore predefinito è 1460. Prima di impostare l'MTU su un valore superiore a 1460, consulta Unità massima di trasmissione.
2. Crea una subnet per la rete del piano dati VPC inviando una richiesta POST al metodo subnetworks.insert.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks

{
  "ipCidrRange": "DATA_PRIMARY_RANGE",
  "name": "DATA_PLANE_SUBNET_NAME",
  "network": "projects/PROJECT_ID/global/networks/DATA_PLANE_NETWORK_NAME"
}
```
  Sostituisci quanto segue:
  - PROJECT_ID: l'ID progetto in cui si trova la rete del piano dati.
  - REGION: la regione in cui vuoi creare la subnet.
  - DATA_PRIMARY_RANGE: l'intervallo IPv4 primario per la nuova subnet in notazione CIDR.
  - DATA_PLANE_SUBNET_NAME: il nome della subnet per la rete del piano dati che hai creato nel passaggio precedente.
  - DATA_PLANE_NETWORK_NAME: il nome della rete del piano dati creata nel passaggio precedente.
Per creare una rete VPC per il control plane con una regola firewall per consentire l'accesso SSH alla VM, segui questi passaggi:
1. Crea una rete VPC con una subnet creata manualmente inviando una richiesta POST al metodo networks.insert con il campo autoCreateSubnetworks impostato su false.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks

{
  "autoCreateSubnetworks": false,
  "name": "CONTROL_PLANE_NETWORK_NAME",
  "mtu": MTU
}
```
  Sostituisci quanto segue:
  - PROJECT_ID: l'ID del progetto corrente.
  - CONTROL_PLANE_NETWORK_NAME: il nome della rete per il control plane.
  - MTU: l'MTU, ovvero la dimensione massima di un pacchetto della rete. Il valore deve essere compreso tra 1300 e 8896. Il valore predefinito è 1460. Prima di impostare l'MTU su un valore superiore a 1460, consulta Unità massima di trasmissione.
2. Crea una subnet per la rete di controllo dati VPC inviando una richiesta POST al metodo subnetworks.insert.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks

{
  "ipCidrRange": "CONTROL_PRIMARY_RANGE",
  "name": "CONTROL_PLANE_SUBNET_NAME",
  "network": "projects/PROJECT_ID/global/networks/CONTROL_PLANE_NETWORK_NAME"
}
```
  Sostituisci quanto segue:
  - PROJECT_ID: l'ID progetto in cui si trova la rete del control plane.
  - REGION: la regione in cui vuoi creare la subnet.
  - CONTROL_PRIMARY_RANGE: l'intervallo IPv4 primario per la nuova subnet in notazione CIDR.
    
    Importante: specifica un intervallo IPv4 diverso da quello specificato nella subnet della rete del piano dati. In caso contrario, la creazione della subnet non andrà a buon fine.
  - CONTROL_PLANE_SUBNET_NAME: il nome della subnet per la rete del control plane che hai creato nel passaggio precedente.
  - CONTROL_PLANE_NETWORK_NAME: il nome della rete del control plane creata nel passaggio precedente.
3. Crea una regola firewall VPC che consenta l'accesso SSH alla rete del control plane inviando una richiesta POST al metodo firewalls.insert. Nella richiesta, imposta il campo IPProtocol su tcp e il campo ports su 22.
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/firewalls

{
  "allowed": [
    {
      "IPProtocol": "tcp",
      "ports": [ "22" ]
    }
  ],
  "network": "projects/PROJECT_ID/global/networks/CONTROL_PLANE_NETWORK_NAME"
}
```
  Sostituisci quanto segue:
  - PROJECT_ID: l'ID progetto in cui si trova la rete del control plane.
  - CONTROL_PLANE_NETWORK_NAME: il nome della rete del control plane creata nei passaggi precedenti.

Per altre opzioni di configurazione durante la creazione di una rete VPC, consulta Crea e gestisci le reti VPC.

Crea una VM che utilizza le reti VPC per DPDK

Crea una VM che attivi gVNIC o virtIO-Net sulle due reti VPC che hai creato in precedenza utilizzando la console Google Cloud , gcloud CLI e l'API Compute Engine.

Consigliato: specifica Ubuntu LTS o Ubuntu Pro come immagine del sistema operativo perché i relativi gestori di pacchetti supportano i driver UIO e VFIO senza IOMMU. Se non vuoi specificare nessuno di questi sistemi operativi, ti consigliamo di specificare Debian 11 o versioni successive per un'elaborazione più rapida dei pacchetti.

Console

Crea una VM che utilizzi le due subnet della rete VPC create nei passaggi precedenti seguendo questi passaggi:

Nella console Google Cloud , vai a Istanze VM.

Vai a Istanze VM

Viene visualizzata la pagina Istanze VM.
Fai clic su Crea istanza.

Viene visualizzata la pagina Crea un'istanza.
Nel campo Nome, inserisci un nome per la VM.
Nel menu Regione, seleziona la stessa regione in cui hai creato le reti nei passaggi precedenti.

Importante: il tentativo di creare una VM in una regione diversa da quella in cui si trovano le reti del control plane e del piano dati causa errori.
Nel menu Zona, seleziona una zona per la VM.
Nella sezione Configurazione macchina, segui questi passaggi:
1. Seleziona una delle seguenti opzioni:
  - Per i workload comuni, seleziona la scheda Per uso generico (predefinita).
  - Per i workload ad alte prestazioni, seleziona la scheda Ottimizzata per il calcolo.
  - Per i workload con rapporti memoria/vCPU elevati, seleziona la scheda Ottimizzata per la memoria.
  - Per i workload che utilizzano unità di elaborazione grafica (GPU), seleziona la scheda GPU.
2. Facoltativo. Se hai specificato GPU nel passaggio precedente e vuoi cambiare la GPU da collegare alla VM, esegui una o più delle seguenti operazioni:
  1. Nel menu Tipo di GPU, seleziona un tipo di GPU.
  2. Nel menu Numero di GPU, seleziona il numero di GPU.
3. Nel menu Serie, seleziona una serie di macchine.
  
  Importante: gVNIC è supportato con tutte le serie di macchine, ma VirtIO-Net non è supportato con le serie di macchine più recenti (terza generazione e T2A). Se scegli una serie di macchine che non supporta il tuo tipo di vNIC, la creazione della VM non va a buon fine.
4. Nel menu Tipo di macchina, seleziona un tipo di macchina.
5. (Facoltativo) Espandi Configurazioni avanzate e segui le istruzioni per personalizzare ulteriormente la macchina per questa VM.
(Facoltativo) Nella sezione Disco di avvio, fai clic su Cambia e segui le istruzioni per modificare l'immagine disco.

Importante: se specifichi gVNIC come tipo di vNIC per questa VM, assicurati di specificare un'immagine disco supportata. In caso contrario, la creazione della VM non andrà a buon fine.
Espandi la sezione Opzioni avanzate.
Espandi la sezione Networking.
Nella sezione Configurazione delle prestazioni di rete, segui questi passaggi:
1. Nel menu Scheda di interfaccia di rete, seleziona una delle seguenti opzioni:
  - Per utilizzare gVNIC, seleziona gVNIC.
  - Per utilizzare VirtIO-Net, seleziona VirtIO.
  Nota: il valore - nel menu Scheda di interfaccia di rete indica che il tipo di vNIC può essere gVNIC o VirtIO-Net, a seconda del tipo di famiglia di macchine. Se sia gVNIC sia VirtIO-Net sono disponibili per una VM, il valore predefinito è VirtIO-Net.
2. (Facoltativo) Per prestazioni di rete più elevate e latenza ridotta, seleziona la casella di controllo Abilita networking Tier_1.
  
  Importante: puoi attivare il networking Tier_1 solo se utilizzi gVNIC e specifichi un tipo di macchina supportato con almeno 30 vCPU. In caso contrario, la creazione della VM non andrà a buon fine.
Nella sezione Interfacce di rete, segui questi passaggi:
1. Nella riga predefinita, fai clic su Elimina elemento "predefinito".
2. Fai clic su Aggiungi interfaccia di rete.
  
  Viene visualizzata la sezione Nuova interfaccia di rete.
3. Nel menu Rete, seleziona la rete del control plane creata nei passaggi precedenti.
4. Fai clic su Fine.
5. Fai di nuovo clic su Aggiungi interfaccia di rete.
  
  Viene visualizzata la sezione Nuova interfaccia di rete.
6. Nel menu Rete, seleziona la rete del piano dati creata nei passaggi precedenti.
7. Fai clic su Fine.
Fai clic su Crea.

Viene visualizzata la pagina Istanze VM. Potrebbe essere necessario attendere fino a un minuto per la creazione della VM.

gcloud

Crea una VM che utilizzi le due subnet della rete VPC che hai creato nei passaggi precedenti utilizzando il comando gcloud compute instances create con i seguenti flag:

gcloud compute instances create VM_NAME \
    --image-family=IMAGE_FAMILY \
    --image-project=IMAGE_PROJECT \
    --machine-type=MACHINE_TYPE  \
    --network-interface=network=CONTROL_PLANE_NETWORK_NAME,subnet=CONTROL_PLANE_SUBNET_NAME,nic-type=VNIC_TYPE \
    --network-interface=network=DATA_PLANE_NETWORK_NAME,subnet=DATA_PLANE_SUBNET_NAME,nic-type=VNIC_TYPE \
    --zone=ZONE

Sostituisci quanto segue:

VM_NAME: il nome della VM.
IMAGE_FAMILY: la famiglia di immagini per il sistema operativo con cui verrà inizializzato il disco di avvio. In alternativa, puoi specificare il flag --image=IMAGE e sostituire IMAGE con una versione specifica di un'immagine. Scopri come visualizzare un elenco di immagini disponibili nel progetto di immagini Compute Engine.
IMAGE_PROJECT: il nome del progetto di immagini che contiene l'immagine disco.

Importante: se specifichi gVNIC come tipo di vNIC per questa VM, assicurati di specificare una famiglia e un progetto di immagini disco supportati. In caso contrario, la creazione della VM non andrà a buon fine.
MACHINE_TYPE: un tipo di macchina, predefinito o personalizzato, per la VM.

Importante: gVNIC è supportato con tutte le serie di macchine, ma VirtIO-Net non è supportato con le serie di macchine più recenti (terza generazione e T2A). Se scegli una serie di macchine che non supporta il tuo tipo di vNIC, la creazione della VM non va a buon fine.
VNIC_TYPE: il tipo di vNIC da utilizzare per le reti del control plane e del piano dati. Il valore deve essere uno dei seguenti:
- Per utilizzare gVNIC, specifica GVNIC.
- Per utilizzare VirtIO-Net, specifica VIRTIO_NET.
CONTROL_PLANE_NETWORK_NAME: il nome della rete del control plane creata nei passaggi precedenti.
CONTROL_PLANE_SUBNET_NAME: il nome della subnet per la rete del control plane che hai creato nei passaggi precedenti.
DATA_PLANE_NETWORK_NAME: il nome della rete del piano di dati creata nei passaggi precedenti.
DATA_PLANE_SUBNET_NAME: il nome della subnet per la rete del control plane creata automaticamente nei passaggi precedenti.
ZONE: la zona in cui creare la VM. Specifica una zona all'interno della stessa regione della subnet creata nei passaggi precedenti.

Ad esempio, per creare una VM denominata dpdk-vm nella zona us-central1-a che specifica un disco permanente SSD da 512 GB, un tipo di macchina C2 predefinito con 60 vCPU, il networking Tier_1 e una rete del piano dati e una del control plane che utilizzano entrambe gVNIC, esegui questo comando:

gcloud compute instances create dpdk-vm \
    --boot-disk-size=512GB \
    --boot-disk-type=pd-ssd \
    --image-project=ubuntu-os-cloud \
    --image-family=ubuntu-2004-lts \
    --machine-type=c2-standard-60 \
    --network-performance-configs=total-egress-bandwidth-tier=TIER_1 \
    --network-interface=network=control,subnet=control,nic-type=GVNIC \
    --network-interface=network=data,subnet=data,nic-type=GVNIC \
    --zone=us-central1-a

API

Crea una VM che utilizzi le due subnet della rete VPC create nei passaggi precedenti inviando una richiesta POST al metodo instances.insert con i seguenti campi:

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

{
  "name": "VM_NAME",
  "machineType": "MACHINE_TYPE",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE_FAMILY"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/CONTROL_PLANE_NETWORK_NAME",
      "subnetwork": "regions/REGION/subnetworks/CONTROL_PLANE_SUBNET_NAME",
      "nicType": "VNIC_TYPE"
    },
    {
      "network": "global/networks/DATAPLANE_NETWORK_NAME",
      "subnetwork": "regions/REGION/subnetworks/DATA_PLANE_SUBNET_NAME",
      "nicType": "VNIC_TYPE"
    }
  ]
}

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto in cui si trovano la rete VPC del control plane e la rete VPC del piano dati.
ZONE: la zona in cui creare la VM.
Importante: assicurati di specificare una zona che soddisfi i seguenti requisiti:
- La zona si trova nella stessa regione in cui si trovano le subnet delle reti del control plane e del piano dati.
- La zona della VM e la zona contenente il tipo di macchina da utilizzare per la VM corrispondono.
Il tentativo di creare una VM al di fuori della regione in cui si trovano le subnet specificate o in una zona che non corrisponde alla zona del tipo di macchina specificato causa errori.
VM_NAME: il nome della VM.
MACHINE_TYPE: un tipo di macchina, predefinito o personalizzato, per la VM.

Importante: gVNIC è supportato con tutte le serie di macchine, ma VirtIO-Net non è supportato con le serie di macchine più recenti (terza generazione e T2A). Se scegli una serie di macchine che non supporta il tuo tipo di vNIC, la creazione della VM non va a buon fine.
IMAGE_PROJECT: il nome del progetto di immagini che contiene l'immagine disco.
IMAGE_FAMILY: la famiglia di immagini per il sistema operativo con cui verrà inizializzato il disco di avvio. In alternativa, puoi specificare una versione specifica di un'immagine. Scopri come visualizzare un elenco di immagini nel progetto di immagini Compute Engine.

Importante: se specifichi gVNIC come tipo di vNIC per questa VM, assicurati di specificare un'immagine disco supportata. In caso contrario, la creazione della VM non andrà a buon fine.
CONTROL_PLANE_NETWORK_NAME: il nome della rete del control plane creata nei passaggi precedenti.
REGION: la regione in cui si trovano le subnet delle reti del control plane e del piano di dati.
CONTROL_PLANE_SUBNET_NAME: il nome della subnet per la rete del control plane che hai creato nei passaggi precedenti.
VNIC_TYPE: il tipo di vNIC da utilizzare per le reti del control plane e del piano dati. Il valore deve essere uno dei seguenti:
- Per utilizzare gVNIC, specifica GVNIC.
- Per utilizzare VirtIO-Net, specifica VIRTIO_NET.
DATA_PLANE_NETWORK_NAME: il nome della rete del piano di dati creata nei passaggi precedenti.
DATA_PLANE_SUBNET_NAME: il nome della subnet per la rete del control plane che hai creato nei passaggi precedenti.

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances

{
  "name": "dpdk-vm",
  "machineType": "c2-standard-60",
  "disks": [
    {
      "initializeParams": {
        "diskSizeGb": "512GB",
        "diskType": "pd-ssd",
        "sourceImage": "projects/ubuntu-os-cloud/global/images/ubuntu-2004-lts"
      },
      "boot": true
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/control",
      "subnetwork": "regions/us-central1/subnetworks/control",
      "nicType": "GVNIC"
    },
    {
      "network": "global/networks/data",
      "subnetwork": "regions/us-central1/subnetworks/data",
      "nicType": "GVNIC"
    }
  ],
  "networkPerformanceConfig": {
    "totalEgressBandwidthTier": "TIER_1"
  }
}

Per altre opzioni di configurazione durante la creazione di una VM, consulta Crea e avvia un'istanza VM.

Installa DPDK sulla VM

Per installare DPDK sulla VM, segui questi passaggi:

Connettiti alla VM creata nella sezione precedente utilizzando SSH.

Configura le dipendenze per l'installazione di DPDK:

sudo apt-get update && sudo apt-get upgrade -yq
sudo apt-get install -yq build-essential ninja-build python3-pip \
    linux-headers-$(uname -r) pkg-config libnuma-dev
sudo pip install pyelftools meson

Installa DPDK:
```
wget https://fast.dpdk.org/rel/dpdk-23.07.tar.xz
tar xvf dpdk-23.07.tar.xz
cd dpdk-23.07
```
Importante: se hai specificato gVNIC come tipo di vNIC nei passaggi precedenti, devi installare DPDK versione 22.11 o successive. L'utilizzo di una versione precedente di DPDK causa errori quando provi a testare o utilizzare DPDK sulla VM.

Per compilare DPDK con gli esempi:

meson setup -Dexamples=all build
sudo ninja -C build install; sudo ldconfig

Installa il driver

Per preparare DPDK per l'esecuzione su un driver, installa il driver selezionando uno dei seguenti metodi:

Installa un VFIO senza IOMMU.
Installa UIO.

Installa un VFIO senza IOMMU

Per installare il driver VFIO senza IOMMU, segui questi passaggi:

Controlla se VFIO è attivo:
```
cat /boot/config-$(uname -r) | grep NOIOMMU
```
Se VFIO non è attivo, segui i passaggi descritti in Installa UIO.

Attiva la modalità No-IOMMU in VFIO:

sudo bash -c 'echo 1 > /sys/module/vfio/parameters/enable_unsafe_noiommu_mode'

Installa UIO

Per installare il driver UIO su DPDK, seleziona uno dei seguenti metodi:

Installa UIO utilizzando git.
Installa UIO utilizzando i pacchetti Linux.

Installa UIO utilizzando git

Per installare il driver UIO su DPDK utilizzando git, segui questi passaggi:

Clona il igb_uio repository git su un disco nella VM:
```
git clone https://dpdk.org/git/dpdk-kmods
```
Dalla directory parent del repository git clonato, compila il modulo e installa il driver UIO su DPDK:
```
pushd dpdk-kmods/linux/igb_uio
sudo make
sudo depmod && sudo insmod igb_uio.ko
popd
```

Installa UIO utilizzando i pacchetti Linux

Per installare il driver UIO su DPDK utilizzando i pacchetti Linux, segui questi passaggi:

Installa il pacchetto dpdk-igb-uio-dkms.

sudo apt-get install -y dpdk-igb-uio-dkms

Installa il driver UIO su DPDK:
```
sudo modprobe igb_uio
```

Associa DPDK a un driver e testalo

Per associare DPDK al driver installato nella sezione precedente, segui questi passaggi:

Recupera il numero di slot PCI (Peripheral Component Interconnect) per l'interfaccia di rete corrente:
```
sudo lspci | grep -e "gVNIC" -e "Virtio network device"
```
Ad esempio, se la VM utilizza ens4 come interfaccia di rete, il numero di slot PCI è 00:04.0.
Arresta l'interfaccia di rete collegata all'adattatore di rete:
```
sudo ip link set NETWORK_INTERFACE_NAME down
```
Sostituisci NETWORK_INTERFACE_NAME con il nome dell'interfaccia di rete specificata nelle reti VPC. Per vedere quale interfaccia di rete utilizza la VM, visualizza la configurazione dell'interfaccia di rete:
```
sudo ifconfig
```
Associa DPDK al driver:
```
sudo dpdk-devbind.py --bind=DRIVER PCI_SLOT_NUMBER
```
Sostituisci quanto segue:
- DRIVER: il driver a cui associare DPDK. Specifica uno dei seguenti valori:
  - Driver UIO: igb_uio
  - Driver VFIO senza IOMMU: vfio-pci
- PCI_SLOT_NUMBER: il numero di slot PCI dell'interfaccia di rete corrente formattato come 00:0NUMBER.0.

Crea la directory /mnt/huge, quindi crea alcune hugepage che DPDK potrà utilizzare come buffer:

sudo mkdir /mnt/huge
sudo mount -t hugetlbfs -o pagesize=1G none /mnt/huge
sudo bash -c 'echo 4 > /sys/kernel/mm/hugepages/hugepages-1048576kB/nr_hugepages'
sudo bash -c 'echo 1024 > /sys/kernel/mm/hugepages/hugepages-2048kB/nr_hugepages'

Verifica che DPDK possa utilizzare l'interfaccia di rete creata nei passaggi precedenti eseguendo l'applicazione di esempio testpmd inclusa nelle librerie DPDK:
```
sudo ./build/app/dpdk-testpmd
```
Per ulteriori informazioni sul test di DPDK, consulta Testpmd Command-line Options.

Annulla l'associazione di DPDK

Dopo aver utilizzato DPDK, puoi annullarne l'associazione con il driver installato nella sezione precedente. Per annullare l'associazione DPDK:

Annulla l'assocazione di DPDK con il driver:
```
sudo dpdk-devbind.py -u PCI_SLOT_NUMBER
```
Sostituisci PCI_SLOT_NUMBER con il numero di slot PCI specificato nei passaggi precedenti. Se vuoi verificare il numero di slot PCI per l'interfaccia di rete attuale:
```
sudo lspci | grep -e "gVNIC" -e "Virtio network device"
```
Ad esempio, se la VM utilizza ens4 come interfaccia di rete, il numero di slot PCI è 00:04.0.
Ricarica il driver di rete Compute Engine:
```
sudo bash -c 'echo PCI_SLOT_NUMBER > /sys/bus/pci/drivers/VNIC_DIRECTORY/bind'
sudo ip link set NETWORK_INTERFACE_NAME up
```
Sostituisci quanto segue:
- PCI_SLOT_NUMBER: il numero di slot PCI specificato nei passaggi precedenti.
- VNIC_DIRECTORY: la directory della vNIC. A seconda del tipo di vNIC in uso, specifica uno dei seguenti valori:
  - gVNIC: gvnic
  - VirtIO-Net: virtio-pci
- NETWORK_INTERFACE_NAME: il nome dell'interfaccia di rete specificato nella sezione precedente.

Passaggi successivi

Esamina le larghezze di banda della rete per il tuo tipo di macchina.
Scopri di più sulla creazione e sulla gestione delle reti VPC.
Scopri di più sulle impostazioni MTU più elevate con i frame jumbo.
Scopri di più sull'ottimizzazione TCP per le prestazioni della rete.

Consenti un'elaborazione più rapida dei pacchetti di rete con DPDK Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Console

gcloud

REST

Requisiti

Limitazioni

Configura una VM per l'esecuzione di DPDK

Crea le reti VPC

Console

gcloud

API

Crea una VM che utilizza le reti VPC per DPDK

Console

gcloud

API

Installa DPDK sulla VM

Installa il driver

Installa un VFIO senza IOMMU

Installa UIO

Installa UIO utilizzando git

Installa UIO utilizzando i pacchetti Linux

Associa DPDK a un driver e testalo

Annulla l'associazione di DPDK

Passaggi successivi

Consenti un'elaborazione più rapida dei pacchetti di rete con DPDK