Docker-dpdk for Ubuntu and RockyLinux/RHEL

Note: Current RHEL images use RockyLinux. Please edit the Dockerfile to build RHEL yourself. You might require to fill RHEL subscription details in Dockerfile for RHEL.

These scripts will create a docker image to build and run dpdk-dev on docker in ubuntu or rockylinux/rhel host machines. The containers contains a prebuild dpdk source. You have to configure host machine for huge pages and mount drivers to docker. In adiitionally, this script will mount your home directory to container. Please comment this out in production as it will mount your secrets such as .ssh to container.

Getting Started

Prerequisites

RockyLinux/RHEL or Ubuntu installation with amd64 architecture. DPDK supported NIC (optional) Docker-deamon

Current Prebuild docker images

shanakaprageeth/ubuntu24-dpdk

shanakaprageeth/rhel8-dpdk

docker pull shanakaprageeth/ubuntu24-dpdk
docker pull shanakaprageeth/rhel8-dpdk

Executing prebuild images or Building images as a container

For Ubuntu

execute following script with administrative privillages to create the docker container. Use build optional argument to build the container yourself

cd docker-ubuntu-dpdk
./run_docker_dpdk.sh
# to build yourself and execute
#./run_docker_dpdk.sh build

For RockyLinux/RHEL

Please edit rhel subscription manager USERNAME and PASSWORD or else set up yum in DOCKERFILE. execute following script with administrative privillages to create the docker container.

cd docker-rhel-dpdk
# to build yourself and execute
#./run_docker_dpdk.sh build

Container options

Following docker container options and mounts are required for dpdk

# Ubuntu
docker run --privileged  --cap-add=ALL \
        -v /sys/bus/pci/devices:/sys/bus/pci/devices \
        -v /sys/kernel/mm/hugepages:/sys/kernel/mm/hugepages \
        -v /sys/devices/system/node:/sys/devices/system/node \
        -v /dev:/dev \
        -v /home/$USER:/home/$USER \
        --name ubuntu-dpdk -it  shanakaprageeth/ubuntu24-dpdk bash

#RockyLinux
docker run --privileged  --cap-add=ALL \
        -v /sys/bus/pci/devices:/sys/bus/pci/devices \
        -v /sys/kernel/mm/hugepages:/sys/kernel/mm/hugepages \
        -v /sys/devices/system/node:/sys/devices/system/node \
        -v /dev:/dev \
        -v /home/$USER:/home/$USER \
        --name rhel-dpdk -it  shanakaprageeth/rhel8-dpdk bash

Additional Features

Currently these containers can support Fstack DPDK based network stack (https://github.com/F-Stack/f-stack/blob/dev/.github/workflows/ci.yml)

Old version

[depreciated] Please refer to branch/tag 1.0 for old Docker images with 16.X dpdk with dpdk-setup.sh 1.0

# Not managed
docker pull shanakaprageeth/ubuntu-dpdk:2018

Acknowledgments

• I pay my gratitude dpdk-dev library. dpdk_setup.sh contain shell functions used in dpdk-dev library.
• Can you run Intel's Data-plane Development Kit (DPDK) in a container? Yep. http://developerblog.redhat.com/2015/06/02/can-you-run-intels-data-plane-development-kit-dpdk-in-a-docker-container-yep/
• I pay my gratitude to https://github.com/jeremyeder/docker-dpdk that provide me information for rhel dpdk support.