mptcp/mptcp-upstream-virtme-docker

MPTCP Upstream Virtme Docker

镜像概述和主要用途

该Docker镜像用于通过virtme构建虚拟环境，以验证https://github.com/multipath-tcp/mptcp_net-next%E4%BB%93%E5%BA%93%EF%BC%88MPTCP%E4%B8%8A%E6%B8%B8%E5%86%85%E6%A0%B8%EF%BC%89%E3%80%82%E5%85%B6%E8%AE%BE%E8%AE%A1%E7%9B%AE%E6%A0%87%E6%98%AF%E6%8F%90%E4%BE%9B%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%E7%9A%84Docker%E9%95%9C%E5%83%8F%EF%BC%8C%E4%BE%9B%E5%BC%80%E5%8F%91%E4%BA%BA%E5%91%98%E5%92%8CCI%EF%BC%88%E6%8C%81%E7%BB%AD%E9%9B%86%E6%88%90%EF%BC%89%E7%8E%AF%E5%A2%83%E4%BD%BF%E7%94%A8%E3%80%82

核心功能和特性

入口点选项

启动Docker镜像时，需指定以下模式之一：

• manual-normal：编译无调试配置的内核，并提供shell提示符
• manual-debug：编译带调试配置的内核，并提供shell提示符
• auto-normal：在无调试配置的内核中运行所有自动测试
• auto-debug：在带调试配置的内核中运行所有自动测试
• auto-all：同时使用无调试和调试配置运行自动测试
• make：运行make命令（可带可选参数）
• make.cross：运行Intel的make.cross命令（可带可选参数）
• cmd：运行指定命令
• src： source指定的脚本文件
• help：显示所有可用命令

所有manual-*和auto-*选项接受内核源代码中scripts/config脚本的可选参数，例如-e DEBUG_LOCKDEP。

使用场景和适用范围

适用于需要验证MPTCP上游内核代码的开发人员，以及CI流程中对内核进行自动化测试的场景。支持手动交互模式（用于开发调试）和自动测试模式（用于验证流程）。

详细使用方法和配置说明

用户模式

无需克隆本仓库，可快速获取即用环境：

bash
cd <内核源代码目录>
docker pull mptcp/mptcp-upstream-virtme-docker:latest
docker run -v "${PWD}:${PWD}:rw" -w "${PWD}" --privileged --rm -it \
  mptcp/mptcp-upstream-virtme-docker:latest \
  <上述入口点选项>

说明：该Docker镜像需要--privileged权限以支持QEmu的KVM加速。

开发人员模式

克隆本仓库后使用：

bash
cd <内核源代码目录>
/PATH/TO/THIS/REPO/run-tests-dev.sh <上述入口点选项>

该命令会构建并启动Docker镜像。

扩展

文件

可在内核源代码根目录创建以下3个文件：

• .virtme-exec-pre：在测试套件运行前执行
• .virtme-exec-run：替代测试套件执行
• .virtme-exec-post：在测试套件运行后执行

这些脚本会被source执行，并可使用virtme脚本中的函数。

环境变量

非阻塞模式

设置INPUT_NO_BLOCK=1环境变量可在上述文件存在时不阻塞流程，适用于git bisect场景。

Packetdrill相关

• INPUT_PACKETDRILL_NO_SYNC=1：不同步Packetdrill与上游，适用于挂载本地Packetdrill仓库
• INPUT_PACKETDRILL_NO_MORE_TOLERANCE=1：不增加Packetdrill的容错性

直接使用Docker命令示例：

bash
docker run \
  -e INPUT_PACKETDRILL_NO_SYNC=1 \
  -e INPUT_PACKETDRILL_NO_MORE_TOLERANCE=1 \
  -v /PATH/TO/packetdrill:/opt/packetdrill:rw \
  -v "${PWD}:${PWD}:rw" -w "${PWD}" \
  --privileged --rm -it \
  mptcp/mptcp-upstream-virtme-docker:latest \
  manual
cd /opt/packetdrill/gtests/net/
./packetdrill/run_all.py -lv mptcp/dss  # 或其他子目录
# 或
cd /opt/packetdrill/gtests/net/mptcp/dss/  # 或其他子目录
../../packetdrill/packetdrill -v dss_fin_server.pkt  # 或其他测试

使用run.sh脚本示例*： 通过设置VIRTME_PACKETDRILL_PATH实现挂载并配置环境变量：

bash
VIRTME_PACKETDRILL_PATH=/PATH/TO/packetdrill \
  /PATH/TO/THIS/REPO/run-tests-dev.sh <上述入口点选项>