spyroot/dpdk_native_tester

DPDK 23.11 Photon OS 5.0镜像（Intel第4/5代CPU优化版）

镜像概述

本镜像基于Photon OS 5.0构建，包含DPDK 23.11（含所有PMD及XDR等关联库）、pktgen-dpdk、DPDK testpmd、iperf3工具及完整开发工具链。与通用版本（spyroot/dpdk_generic_tester）相比，本镜像针对Intel第4/5代CPU进行优化，支持AVX指令集，适用于高性能网络场景。

核心功能

1. DPDK网络加速：提供高性能用户态网络编程框架，支持多种PMD驱动（如i40e、iavf等）。
2. 流量生成：通过pktgen-dpdk生成高吞吐量网络流量，用于测试网络设备性能。
3. PMD测试：使用testpmd验证网络驱动的正确性与性能。
4. 带宽测试：通过iperf3测量网络带宽。
5. 开发支持：包含完整工具链，支持DPDK应用开发与编译。

使用场景

• 网络设备性能基准测试
• DPDK应用开发与调试
• PMD驱动兼容性验证
• SR-IOV虚拟功能（VF）性能测试
• Kubernetes环境下的高性能网络应用部署

配置说明

1. 基础使用示例

查看网络设备绑定状态

bash
docker run -it --privileged --rm docker.xuanyuan.run/spyroot/dpdk_native_tester dpdk-devbind.py -s

运行pktgen流量生成

bash
docker run -it --privileged --rm docker.xuanyuan.run/spyroot/dpdk_native_tester pktgen --help

运行testpmd

bash
docker run -it --privileged --rm docker.xuanyuan.run/spyroot/dpdk_native_tester dpdk-testpmd

2. HugePages配置

bash
hpagesize=1024
mkdir -p /dev/hugepages
mountpoint -q /dev/hugepages || mount -t hugetlbfs nodev /dev/hugepages
echo $hpagesize > /sys/devices/system/node/node0/hugepages/hugepages-2048kB/nr_hugepages

3. SR-IOV VF配置与绑定

bash
# 创建8个VF
export default_adapter="eno1"
modprobe iavf && for vf_id in {0..7}; do ip link set $default_adapter vf $vf_id trust on && ip link set $default_adapter vf $vf_id spoof off; done

# 绑定VF到vfio-pci驱动
export vf_target_device="0000:03:02.0"
docker run --privileged --name dpdk_tester --device="/sys/bus/pci/devices/*" \
  -v /dev/hugepages:/dev/hugepages -v /dev:/dev \
  --cap-add=SYS_RAWIO --cap-add=IPC_LOCK --cap-add=NET_ADMIN \
  --rm -it docker.xuanyuan.run/spyroot/dpdk_native_tester dpdk-devbind.py -b vfio-pci $vf_target_device

4. Kubernetes部署示例

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: dpdkpod
  labels:
    environment: dpdk_tester
    app: dpdkpod
spec:
  replicas: 2
  selector:
    matchLabels:
      environment: dpdk_tester
      app: dpdkpod
  template:
    metadata:
      labels:
        environment: dpdk_tester
        app: dpdkpod
    spec:
      containers:
      - name: dpdkpod
        command: ["/bin/bash", "-c", "sleep infinity"]
        image: docker.xuanyuan.run/spyroot/dpdk_native_tester
        imagePullPolicy: Always
        securityContext:
          capabilities:
            add: ["IPC_LOCK", "NET_ADMIN", "SYS_TIME", "CAP_NET_RAW", "CAP_BPF", "SYS_ADMIN"]
          privileged: true
        volumeMounts:
        - name: sys
          mountPath: /sys
          readOnly: true
        - name: modules
          mountPath: /lib/modules
          readOnly: true
        resources:
          requests:
            memory: 2Gi
            cpu: "2"
            intel.com/sriovdpdk: '1'
          limits:
            hugepages-1Gi: 2Gi
            cpu: "2"
            intel.com/sriovdpdk: '1'
      volumes:
      - name: sys
        hostPath:
          path: /sys
      - name: modules
        hostPath:
          path: /lib/modules
      nodeSelector:
        kubernetes.io/os: linux

5. 开发指南

使用pkg-config编译DPDK应用

bash
PKGCONF = pkg-config
CFLAGS += -O3 $(shell $(PKGCONF) --cflags libdpdk)
LDFLAGS += $(shell $(PKGCONF) --libs libdpdk)

$(APP): $(SRCS-y) Makefile
  $(CC) $(CFLAGS) $(SRCS-y) -o $@ $(LDFLAGS)

运行示例程序

bash
docker run -it --privileged --rm docker.xuanyuan.run/spyroot/dpdk_native_tester /bin/bash
cd /usr/local/share/dpdk/examples/l2fwd
make
./l2fwd

支持的PMD驱动

包含多种网络驱动（如i40e、iavf、ice、mlx5等）、加密驱动（如ipsec_mb、openssl等）及事件驱动（如cnxk、dlb2等），完整列表可通过镜像内dpdk-devbind.py -s查看。