rdma/sriov-plugin

sriov-plugin

概述

该网络插件允许Docker容器直接访问原生以太网等网络设备，提供两种操作模式：

1. SRIOV模式（默认）：使用PCIe物理功能（PF）定义网络，容器启动时自动分配PCIe虚拟功能（VF）设备，无虚拟设备开销，每个容器拥有独立的NIC队列，减少资源竞争。
2. Passthrough模式：将指定网络设备直接映射到容器，适用于无需额外MAC地址的场景（如绑定设备直通）。

两种模式均类似KVM的直通技术，容器网络设备与主机或其他容器的IP子网无限制。

核心功能

• 支持SRIOV和Passthrough两种直通模式
• 自动管理SRIOV的启用/禁用及VF分配，降低管理 overhead
• 支持VLAN隔离实现多租户
• 提供特权网络选项（允许修改L2地址、流量嗅探）
• 支持指定MAC地址选择特定VF

使用场景

• 高性能网络应用（如NFV），需低延迟、硬件隔离
• 嵌套虚拟化场景（如macvlan/ipvlan容器在VF接口上运行）
• InfiniBand（非RoCE）环境下IPoIB VF设备直通
• RDMA vHCA与Docker容器集成

快速部署示例

前提条件

确保Docker版本≥1.9

步骤

1. 拉取镜像

bash
docker pull rdma/sriov-plugin

2. 启动插件

bash
docker run -v /run/docker/plugins:/run/docker/plugins -v /etc/docker:/etc/docker -v /var/run:/var/run --net=host --privileged rdma/sriov-plugin

3. 创建SRIOV模式网络

bash
docker network create -d sriov --subnet=194.168.1.0/24 -o netdevice=ens2f0 mynet

4. 运行容器使用该网络

bash
docker run --net=mynet -itd --name=web nginx

5. 创建多租户VLAN网络

bash
docker network create -d sriov --subnet=194.168.1.0/24 -o netdevice=ens2f0 -o vlan=100 customer1
docker network create -d sriov --subnet=194.168.1.0/24 -o netdevice=ens2f0 -o vlan=200 customer2

6. 创建Passthrough模式网络

bash
docker network create -d sriov --subnet=194.168.1.0/24 -o netdevice=ens2f0 -o mode=passthrough mynet

配置选项

• netdevice：用于创建接口的PF/父网络设备
• mode：操作模式（passthrough/sriov）
• vlan：子设备的VLAN卸载标识
• privileged：是否为特权网络（允许修改L2地址、嗅探流量）
• prefix：容器内接口名称前缀（默认：eth）

限制

仅支持Linux环境下的x86_64和ppc64le平台。