feat: the virtualization-dra-usb plugin adds usbip support

[yaroslavborbat]

Description

USBIP in DRA for Kubernetes

The virtualization-dra-usb DRA plugin adds usbip support: USB devices from any node in the cluster can be attached to pods on any other node.

How it works

• Each node runs usbipd — a server that exports local USB devices over the USB/IP protocol.
• USB Gateway (feature gate USBGateway) is enabled: when a pod requests a device from another node, the controller uses usbip to export it on the source node and attach it on the node where the pod runs. The device appears locally via vhci and is passed into the pod as a regular USB device.
• In discovery, devices are split into local ones and those already attached via usbip; both types are available for allocation.

As a result, any USB device from any node in the cluster can be attached to a pod on any node.

Flow (pod requests USB from another node)

sequenceDiagram
    participant Pod as Pod
    participant DRA as DRA (node with pod)
    participant usbipd as usbipd (node with USB)
    participant USB as USB device

    Pod->>DRA: ResourceClaim (device from another node)
    DRA->>usbipd: 1) Export(host, busID)
    usbipd->>USB: device available for export
    DRA->>usbipd: 2) Attach(host, busID) — vhci connects
    usbipd->>DRA: USB/IP link
    DRA->>DRA: device appears locally (vhci)
    DRA->>Pod: CDI / device into pod

Loading

Simplified view by nodes:

[Node A: USB device]               [Node B: pod]
       │                                    │
   usbipd (export)                          │
       │◄───────────────────────────────────┤
       │       USB/IP (export + attach)     │  DRA + USB Gateway
       │───────────────────────────────────►│
       │                                    │  vhci → device into pod

Checklist

• The code is covered by unit tests.
• e2e tests passed.
• Documentation updated according to the changes.
• Changes were tested in the Kubernetes cluster manually.

Changelog entries

section: vm
type: feature
summary: add usb over ip