patrickkutch/dpdk

DPDK容器镜像文档

镜像概述

本镜像提供容器化的DPDK（Data Plane Development Kit）示例应用，包含标准DPDK工具（如dpdk-testpmd、dpdk-devbind.py等），支持从19.11版本开始的标签化发布。镜像旨在简化DPDK应用的部署与测试，通过容器化方式统一运行环境，降低依赖配置复杂度。

核心功能与特性

• 完整工具集：包含DPDK官方仓库默认提供的所有应用（如testpmd、l2fwd等）及辅助工具（如dpdk-devbind.py）
• 灵活配置：支持自定义命令及参数，可直接运行DPDK应用或进入容器手动操作
• 设备支持：支持PCIe设备绑定至vfio-pci或uio驱动，满足DPDK硬件加速需求
• 版本管理：通过标签（如v22.11、v24.11）区分不同DPDK版本，便于版本测试与切换
• 扩展能力：支持挂载外部资源（如Intel DDP固件），适应特定硬件需求

使用场景

• DPDK应用快速测试与验证
• 多版本DPDK兼容性测试环境搭建
• 开发环境中DPDK工具链的统一部署
• 基于DPDK的网络性能基准测试

使用方法

依赖工具

推荐使用辅助脚本dpdkcon简化环境配置（如hugepages设置、卷映射等），脚本获取地址：https://github.com/PatrickKutch/dpdkcon

基本使用示例

运行dpdk-testpmd

bash
dpdkcon -it --rm patrickkutch/dpdk:v22.11 dpdk-testpmd -l 2-3 -n 4 -a 18:01.0 -- --nb-cores=1 --forward=txonly --eth-peer=0,02:80:86:20:01:00 -i

• 参数说明：
  • -l 2-3：指定CPU核心范围
  • -n 4：设置内存通道数
  • -a 18:01.0：绑定PCIe设备
  • --nb-cores=1：设置转发核心数
  • --forward=txonly：设置转发模式为仅发送
  • --eth-peer=0,02:80:86:20:01:00：设置以太网 peer 地址

使用dpdk-devbind.py绑定设备

bash
dpdkcon -it patrickkutch/dpdk:v24.11 dpdk-devbind.py --bind vfio-pci 0000:18:01.0

手动操作模式

通过bash进入容器进行手动配置：

bash
dpdkcon -it patrickkutch/dpdk:v24.11 bash

在容器内可执行DPDK工具或手动配置设备驱动。

配置说明

必要挂载项

DPDK依赖平台级资源，需挂载以下系统路径（通常由dpdkcon自动处理）：

• Hugepages文件系统
• PCIe设备节点
• 系统设备信息

Intel DDP固件挂载

若使用Intel PF设备并需加载DDP（Dynamic Device Personalization）固件，添加以下卷映射：

bash
-v /lib/firmware/updates/intel/ice/ddp:/lib/firmware/updates/intel/ice/ddp \
-v /lib/firmware/intel/ice/ddp:/lib/firmware/intel/ice/ddp

可指定自定义DDP包路径：

bash
-v /home/user/custom_ddp:/lib/firmware/updates/intel/ice/ddp \
-v /lib/firmware/intel/ice/ddp:/lib/firmware/intel/ice/ddp

构建脚本

镜像构建脚本请参考：https://github.com/PatrickKutch/dpdkcon