neomantra/onload

docker-onload

![Travis Status]([***]

https://github.com/neomantra/docker-onload

docker-onload提供了一个Dockerfile，可将Solarflare的https://github.com/Xilinx-CNS/onload%E5%AE%89%E8%A3%85%E5%88%B0%E5%A4%9A%E7%A7%8D%E6%93%8D%E4%BD%9C%E7%B3%BB%E7%BB%9F%E7%89%88%E6%9C%AC%E4%B8%AD%E3%80%82Docker Hub地址：https://hub.docker.com/r/neomantra/onload/

变更记录参见https://github.com/neomantra/docker-onload/blob/master/CHANGELOG.md%E3%80%82

onload镜像构建时设置了ONLOAD_WITHZF，因此不支持TCPDirect（又名ZF）。这是由于许可限制。

镜像neomantra/onload支持的Docker Hub标签及对应的Dockerfile链接

以下未版本化镜像标签当前映射到7.1.3.202：

• https://github.com/neomantra/docker-onload/blob/master/centos7/Dockerfile
• https://github.com/neomantra/docker-onload/blob/master/centos8/Dockerfile
• https://github.com/neomantra/docker-onload/blob/master/stretch/Dockerfile
• https://github.com/neomantra/docker-onload/blob/master/buster/Dockerfile
• https://github.com/neomantra/docker-onload/blob/master/trusty/Dockerfile
• https://github.com/neomantra/docker-onload/blob/master/xenial/Dockerfile
• https://github.com/neomantra/docker-onload/blob/master/bionic/Dockerfile
• https://github.com/neomantra/docker-onload/blob/master/focal/Dockerfile
• https://github.com/neomantra/docker-onload/blob/master/jammy/Dockerfile

以下版本化标签可用：

• 8.1.2.26
• 8.1.1.17
• 8.1.0.15
• 对于7.1.3.202
  • 7.1.3.202-bionic
  • 7.1.3.202-bullseye
  • 7.1.3.202-buster
  • 7.1.3.202-centos7
  • 7.1.3.202-centos8
  • 7.1.3.202-focal
  • 7.1.3.202-jammy
  • 7.1.3.202-stretch
  • 7.1.3.202-trusty
  • 7.1.3.202-xenial

启动Onload-enabled容器

Onload-enabled容器需要暴露主机网络和Onload设备，运行方式如下：

docker run --net=host --device=/dev/onload --device=/dev/onload_epoll -it ONLOAD_ENABLED_IMAGE_ID [COMMAND] [ARG...]

OpenOnload 201606系列还需要--device=/dev/onload_cplane。使用ef_vi或TCPDirect（又名ZF）需要--device=/dev/sfc_char。

以下是提取OpenOnload版本年份的bash单行命令： onload --version | awk 'NR == 1 {print substr($2, 1, 4)}'

注意事项

• 必须使用主机网络：--net=host

• 必须暴露以下设备：--device=/dev/onload --device=/dev/onload_epoll。

• OpenOnload 201606系列还需要--device=/dev/onload_cplane。

• 使用ef_vi或TCPDirect需要--device=/dev/sfc_char。

• 主机的onload --version必须与容器的版本相同。

• 栈共享：如果容器和主机必须共享Onload栈，两者都应设置EF_SHARE_WITH=-1以避免OpenOnload当前的限制。注意这会禁用栈共享安全功能。

• 由于OpenOnload的当前限制，如果共享Onload栈，应设置EF_USE_HUGE_PAGES=0。

• 某些库（如jemalloc）需要在启动时调用系统调用。这可能导致无限循环，因为OpenOnload加速也需要malloc（通过dlsym）；参见jemalloc问题https://github.com/jemalloc/jemalloc/issues/443%E5%92%8Chttps://github.com/jemalloc/jemalloc/issues/1426%E3%80%82%E5%8F%AF%E9%80%9A%E8%BF%87%E8%AE%BE%E7%BD%AE%60ONLOAD_DISABLE_SYSCALL_HOOK=1%60%E7%BC%93%E8%A7%A3%EF%BC%9B%E6%B3%A8%E6%84%8F%E8%BF%98%E9%9C%80%E8%A6%81%E8%AE%BE%E7%BD%AE%60ONLOAD_USERSPACE_ID%60%E4%BB%A5%E5%8C%B9%E9%85%8D%E6%9C%AA%E6%89%93%E8%A1%A5%E4%B8%81%E7%9A%84%E9%A9%B1%E5%8A%A8%E7%89%88%E6%9C%AC%E3%80%82**%E6%B3%A8%E6%84%8F%EF%BC%9A** 此问题可能已在7.0.0.176中修复：“SF-***-KI/bug62297: 避免应用程序使用jemalloc启动时挂起”。

• 这些OpenOnload构建默认基于构建机器的CPU类型使用-march和-mtune。这在运行平台上可能不是最优或不可运行。未来版本将允许通过Docker构建参数指定。

TCPDirect

在OpenOnload 201606-u1中，Solarflare引入了名为TCPDirect的新内核旁路网络API。

要在容器中运行TCPDirect应用程序，必须额外暴露设备： --device=/dev/sfc_char

TCPDirect的许可证与OpenOnload不同；其二进制文件可能不允许分发。因此，https://hub.docker.com/r/neomantra/onload/%E4%B8%8A%E7%9A%84%60onload%60%E5%85%AC%E5%85%B1%E9%95%9C%E5%83%8F%E4%B8%8D%E5%8C%85%E5%90%ABTCPDirect%E6%94%AF%E6%8C%81%E3%80%82

您可以使用常规Dockerfile自行构建和部署支持TCPDirect的镜像。为此，将构建参数ONLOAD_WITHZF设置为非空字符串（Dockerfile检查[ -z ${ONLOAD_WITHZF} ]）。例如：

git clone https://github.com/neomantra/docker-onload.git
cd docker-onload
docker build --build-arg ONLOAD_WITHZF=1 -f xenial/Dockerfile -t neomantra/onload:201606-u1-xenial .

镜像构建助手脚本

Ruby脚本build_onload_image.rb帮助生成构建Onload镜像的命令行。

$ ./build_onload_image.rb --help
build_onload_image.rb [options]

操作
    --versions                显示Onload版本名称列表（配合-v显示所有字段）
    --flavors                 显示镜像版本列表
    --gettag     <prefix>     显示--autotag <prefix>的自动标签名称

    --build                   显示docker build命令
    --execute                 执行docker build命令

选项
    --flavor   -f  <flavor>   指定构建版本（--build或--execute必需）
    --onload   -o  <version>  指定要构建的Onload版本（默认'latest'）

    --url      -u <url>       覆盖"packaged"版本的URL。

    --tag      -t <tag>       将镜像标记为<tag>
    --autotag  -a <prefix>    将镜像标记为<prefix><version>-<flavor>[-nozf]。
                              <prefix>可选，但注意如果没有带冒号的<prefix>，
                              自动标签将是名称而非镜像名:标签

    --zf          <truthy>    构建时包含TCPDirect (zf)（如果可选的<truthy>为'0'或'false'则不包含）

    --arg          <arg>      传递'--build-arg <arg>'给"docker build"

    --quiet    -q             静默构建（传递-q给"docker build"）
    --no-cache                传递--no-cache给"docker build"

    --execute  -x             同时执行构建命令

    --push     -p             推送构建的镜像

    --verbose  -v             详细输出
    --help     -h             显示帮助

使用示例：

./build_onload_image.rb -o 7.1.1.75 --arg foo -f buster --zf --execute

还提供build_all_flavors.sh和build_all_images.sh脚本。

自定义镜像构建

提供了以下基础系统的Dockerfile，使用-f选择Dockerfile路径：

• https://github.com/neomantra/docker-onload/centos7/Dockerfile (centos7/Dockerfile)
• https://github.com/neomantra/docker-onload/centos8/Dockerfile (centos8/Dockerfile)
• https://github.com/neomantra/docker-onload/stretch/Dockerfile (stretch/Dockerfile)
• https://github.com/neomantra/docker-onload/buster/Dockerfile (buster/Dockerfile)
• https://github.com/neomantra/docker-onload/trusty/Dockerfile (trusty/Dockerfile)
• https://github.com/neomantra/docker-onload/xenial/Dockerfile (xenial/Dockerfile)
• https://github.com/neomantra/docker-onload/bionic/Dockerfile (bionic/Dockerfile)
• https://github.com/neomantra/docker-onload/focal/Dockerfile (focal/Dockerfile)
• https://github.com/neomantra/docker-onload/jammy/Dockerfile (jammy/Dockerfile)

每个系统文件夹都包含一个Dockerfile。

以下是可用的构建时选项。可使用--build-argCLI参数设置，例如：

docker build --build-arg ONLOAD_VERSION="201509" --build-arg ONLOAD_MD5SUM="b093ea9f3a534c9c9fe9da6c2b6ccb7a" -f trusty/Dockerfile .

Dockerfile从[openonload