cgal/testsuite-docker

cgal-testsuite-dockerfiles

用于在容器内运行CGAL测试套件的Dockerfile和工具。

获取镜像

建议直接从Docker Hub获取镜像，而非本地构建：

bash
docker pull --all-tags cgal/testsuite-docker  # 获取所有镜像
docker pull docker.xuanyuan.run/cgal/testsuite-docker:TAG  # 获取特定标签的镜像，将TAG替换为具体标签

可用标签列表https://registry.hub.docker.com/u/cgal/testsuite-docker/tags/manage/%E3%80%82

本地构建镜像

要在本地构建镜像，请查看build_images.py的帮助信息。

运行测试套件

使用此镜像运行测试套件的方法如下：

bash
./test_cgal.py --user * --passwd * --images cgal-testsuite/centos6

如果要使用已解压的内部发布版：

bash
./test_cgal.py --use-local --testsuite /路径/到/发布版 --images cgal-testsuite/centos6

也可以仅测试特定包（注意：这会修改发布版）：

bash
./test_cgal.py --use-local --testsuite /路径/到/发布版 --images cgal-testsuite/centos6 \
               --packages Core Mesh_2 Mesh_3

默认参数

默认参数可通过test_cgal_rc文件提供，该文件位于$XDG_CONFIG_HOME（通常为$HOME/.config）或CGAL资源的配置目录中。

定时任务

要将机器配置为通过定时任务提交整个测试套件，可使用以下配置：

--user xxxxxxx
--passwd xxxxxx
--force-rm
--upload-results
--tester-name="My Name"
--tester-address joe@example.com
--testsuite /路径/到/测试套件
--testresults /路径/到/测试结果
--images docker.io/cgal/testsuite-docker:centos5
         docker.io/cgal/testsuite-docker:centos6
         docker.io/cgal/testsuite-docker:archlinux

镜像名称取决于获取方式，上述示例为通过Docker Hub获取镜像时的典型名称。

修改构建环境

要在特定环境（如特定库版本）中运行测试套件，需设置提供该环境的Docker镜像。确保通过设置适当的环境变量，使安装的库被CMake优先于系统库选择。

要控制测试套件的构建方式，可使用环境变量CGAL_CMAKE_FLAGS修改CMake调用，该变量需为数组形式，每个元素包含一个CMake命令行参数，例如：

bash
ENV CGAL_CMAKE_FLAGS="(\"-DCGAL_CXX_FLAGS=-std=c++11 -Wextra\" \"-DCMAKE_CXX_FLAGS=-fno-asm\")"

也可通过经典环境变量（如LD_FLAGS、CXX_FLAGS）修改默认构建变量。

所需非标准Python包

代码需要几个非标准Python 2包，这些包在所有常见发行版中均可用：

• docker-py
• xdg

可使用pip安装：

bash
pip install docker-py xdg

SELinux问题

在使用SELinux的Linux系统（如最新版本的Fedora、RHEL和CentOS的默认设置）上，可能需要重新标记容器用作卷的主机文件和目录：

bash
chcon -Rt svirt_sandbox_file_t ./docker-entrypoint.sh ./testsuite ./testresults

如果使用--testsuite /path/to/testsuite或--testresults /path/to/testresults选项，则指向的目录也需重新标记为svirt_sandbox_file_t：

bash
chcon -Rt svirt_sandbox_file_t /path/to/testresults /path/to/testresults