Using Google Virtual NIC


Google Virtual NIC (gVNIC) is a virtual network interface designed specifically for Compute Engine. gVNIC is an alternative to the virtIO-based ethernet driver.

As the next generation network interface which succeeds VirtIO, gVNIC replaces VirtIO-Net as the only supported network interface in Compute Engine for all new machine types (Generation 3 and onwards). Newer machine series and networking features require gVNIC instead of VirtIO. Consuming gVNIC as the modern I/O interface with Compute Engine VMs allows us to:

  • Provide better performance.
  • Improve consistency by reducing noisy neighbor problems.
  • Introduce new network functionality beyond what VirtIO is capable of.

gVNIC is supported and recommended on all machine families, machine types, and generations.

gVNIC is required to support:

Before you begin

  • If you use gVNIC with Windows Server 2022 or Windows 11 VMs, update the gVNIC driver to GooGet package version 1.0.0@45 or later to improve networking throughput. For more information, see known issues.
  • If you haven't already, set up authentication. Authentication is the process by which your identity is verified for access to Google Cloud services and APIs. To run code or samples from a local development environment, you can authenticate to Compute Engine as follows.

    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.

    REST

    To use the REST API samples on this page in a local development environment, you use the credentials you provide to the gcloud CLI.

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

      gcloud init

Pricing

To see the latest prices for Tier_1 networking, refer to the VM instance pricing page.

For a list of additional methods that can be used to find pricing information, see Compute Engine pricing.

Operating system support

On Compute Engine, you can choose to use gVNIC on any supported public operating system (OS) images. You can manually install the gVNIC driver on:

  • Non-supported operating systems
  • Operating systems that don't have the latest gVNIC driver version

For the supported operating systems, see the Supported interfaces tab for an operating system. Also check the Networking features tab for networking feature support.

Use on non-supported operating systems

For OS images that support gVNIC but don't include the latest version of the gVNIC driver, you can download the latest driver version from GitHub.

You can manually configure and install the latest version of the gVNIC driver on either Linux or Windows VMs.

After you update the operating system in your VM to use gVNIC, create a custom OS image based on that OS image. You can then use the custom OS image to create additional VMs that use gVNIC on that operating system. For more information about creating VMs using a custom OS image, see Create a custom OS image that supports gVNIC on this page.

Use the following procedures to manually configure and install the latest version of the gVNIC driver:

Limitations

Overview of using gVNIC with Compute Engine VMs

To create a VM that uses gVNIC, complete the following steps:

  1. Choose a public OS image that supports gVNIC, or create a custom OS image that is tagged to use gVNIC.
  2. Create a VM using the public or custom OS image. During the VM creation, configure the network interface to use gVNIC.
  3. Verify that gVNIC is enabled.

If you encounter any issues, see Troubleshooting Google Virtual NIC.

Create a custom OS image that supports gVNIC

You can create the OS image using either the Google Cloud CLI or REST. For detailed information and best practices for creating custom OS images, see Create custom OS images.

gcloud

  1. Select an OS image or image family that supports gVNIC. For more information, see Operating system details.

  2. Using the OS image or image family selected in the previous step, create a custom OS image and tag this OS image with GVNIC. To create the custom OS image, use the gcloud compute images create command. For example, the following command creates a custom OS image that supports gVNIC and that's based on a specific OS image.

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

    Replace the following:

    • IMAGE_NAME: the name of the image that you want to create.
    • SOURCE_IMAGE: a specific OS image that supports gVNIC—for example: rocky-linux-8-optimized-gcp-v20220719.

      If you want to use the latest OS image in an image family, replace the --source-image flag with the --source-image-family flag and set its value to an image family that supports gVNIC. For example: --source-image-family=rocky-linux-8-optimized-gcp.

    • SOURCE_IMAGE_PROJECT: the name of the project that contains the source OS image or image family.

    Example

    To create a Rocky Linux 8 Optimized for Google Cloud OS image using the latest OS image from the Compute Engine rocky-linux-8-optimized-gcp image family, run the following command:

    gcloud compute images create IMAGE_NAME \
        --source-image-family=rocky-linux-8-optimized-gcp \
        --source-image-project=rocky-linux-cloud \
        --guest-os-features=GVNIC
    

    For more information about when to use image families, see Image family best practices.

REST

  1. Select an OS image or image family that supports gVNIC For more information, see Operating system details.

  2. Using the OS image or image family selected in the previous step, create an OS image and tag this OS image with GVNIC. To create the OS image, use the images.insert method.

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

    Replace the following:

    • IMAGE_NAME: the name of the OS image that you want to create.
    • SOURCE_IMAGE_URI: the URI for the specific OS image or image family that you want to use.

      For example:

      • Specific OS image: "sourceImage": "projects/rocky-linux-cloud/global/images/rocky-linux-8-optimized-gcp-v20220719"
      • Image family: "sourceImage": "projects/rocky-linux-cloud/global/images/family/rocky-linux-8-optimized-gcp".

      When you specify an image family, Compute Engine creates a VM from the most recent, non-deprecated OS image in that family. For more information about when to use image families, see Image family best practices.

Create a VM with gVNIC support

You can create a VM using one of the supported public OS images or using a custom OS image you created using the steps in Create a custom OS image that supports gVNIC.

Optionally, you can enable DPDK on the VM for faster network packet processing, low latency, and consistent performance.

Create a VM using a public OS image

To create a VM using a public OS image that supports gVNIC, follow the instructions at Creating VMs and containers with high-bandwidth configuration.

Create a VM using a custom OS image

If you aren't using a public OS image that supports gVNIC, you must first create a custom OS image that supports gVNIC. You then use that custom OS image to create a VM by using the Google Cloud CLI or REST.

gcloud

  1. Create the VM by using the gcloud compute instances create command. For the boot disk, specify the custom OS image that you created earlier. For the network interface, set the value of the nic-type flag to GVNIC.

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

    Replace the following:

    • VM_NAME: the name of the new VM.
    • ZONE: the zone to create the VM in.
    • IMAGE_NAME: the OS image that was created in the previous step.
    • YOUR_IMAGE_PROJECT: the name of your project that contains the OS image.
  2. Optional: Verify that Compute Engine created the VM and that the nicType is set to GVNIC.

    gcloud compute instances describe VM_NAME \
       --zone=ZONE
    

    Replace the following:

    • VM_NAME: the name of the VM.
    • ZONE: the zone that you created the VM in.

    Example

    To create a Rocky Linux 8 VM in zone us-west1-b using an OS image named my-gvnic-rocky8 that's in project my-project-12345, run the following command:

    gcloud compute instances create my-rocky-linux-vm \
        --zone=us-west1-b \
        --image=my-gvnic-rocky8 \
        --image-project=my-project-12345 \
        --network-interface=nic-type=GVNIC
    

    Things to consider

    The --network-interface flag has sub-level flags such as the following:

    • --address: Assign an IP address to the VM
    • --network: The network the interface will be a part of
    • --network-tier: The network tier of the interface
    • --subnet: The subnet that the interface will be part of. If --network is also specified, the subnet must be a part of the specified network.
    • --private-network-ip: Specify the RFC 1918 IP to assign to the VM.

    For a full list see, the --network-interface flag.

REST

Create the VM by using the instances.insert method.

  • For the boot disk, specify the custom OS image that you created earlier.
  • For the network interface, set the value of the nicType field to GVNIC.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "name":"VM_NAME",
  "networkInterfaces":[
    {
      "network":"NETWORK",
      "nicType":"GVNIC",
      "subnet":"SUBNET_NAME"
    }
  ],
  "disks":[
    {
      "initializeParams":{
        "sourceImage":"projects/YOUR_IMAGE_PROJECT/global/images/IMAGE_NAME"
      },
      "boot":true
    }
  ]
}

Replace the following:

  • PROJECT_ID: the ID of the project to create the VM in.
  • ZONE: the zone to create the VM in.
  • VM_NAME: the name of the new VM.
  • NETWORK: the URL of the network resource for this VM. If neither the network nor the subnetwork is specified, the default network global/networks/default is used.
  • SUBNET_NAME: name of the subnet. The network is inferred from the specified subnet. This is an optional field.
  • YOUR_IMAGE_PROJECT: the name of your project that contains the OS image.
  • IMAGE_NAME: the OS image that was created in the previous step.

Verify that gVNIC is enabled

Linux

You can use the lshw tool to extract detailed information about the hardware configuration of the virtual machine.

To install the lshw tool on your Linux VM instance, open a SSH connection to the VM, and then run the following command:

sudo apt-get install lshw -y

To determine if the VM is using the gVNIC network interface, run the following command:

sudo lshw -class network

The output resembles the following:

*-network
   description: Ethernet interface
   product: Compute Engine Virtual Ethernet [gVNIC]
   vendor: Google, Inc.
   physical id: 3
   bus info: pci@0000:00:03.0
   logical name: ens3
   version: 00
   serial: 42:01:0a:80:00:6f
   width: 32 bits
   clock: 33MHz
   capabilities: msix bus_master cap_list ethernet physical
   configuration: autonegotiation=off broadcast=yes driver=gve driverversion=1.0.0
    duplex=full ip=10.128.0.111 latency=0 link=yes multicast=yes port=twisted pair
   resources: irq:11 memory:c0203000-c0203fff memory:c0200000-c02000ff memory:c0100000-c01fffff

Windows

  1. On your Windows VM Instance, open the Device Manager.
  2. Under Network Adapters, you should see: "Google Ethernet Adapter"

Troubleshooting

To troubleshoot gVNIC, see Troubleshooting Google Virtual NIC.

What's next