jjhursey/pmix-xver-tester

PMIx跨版本测试环境

本项目定义的Docker容器环境用于测试PMIx的跨版本兼容性。它支持测试当前发布分支之间的兼容性，也可将用户自己的分支添加到测试机制中。

该Docker镜像包含每个发布分支的预构建安装。/home/pmixer/bin/run-xversion.sh脚本会自动检测这些预构建安装是否过时，必要时进行更新。如果它们已反映开发的当前HEAD，则不会触发重建（从而加快测试周期）。

构建完成后，脚本将运行xversion.py脚本来检查PMIx客户端/服务器的跨版本兼容性。若任何组合失败，脚本将返回非零值表示测试失败。

如果需要进行大量需要检查跨版本兼容性的交互式开发，建议创建持久容器并在同一容器内重新运行脚本。这可避免旧Docker镜像每次运行时都重建发布版本安装。

运行基线跨版本兼容性测试

要比较当前发布分支（和master分支）之间的兼容性，只需运行：

bash
docker pull jjhursey/pmix-xver-tester
docker run --rm jjhursey/pmix-xver-tester

使用特定主题分支运行

要将基线与主题分支进行比较（确保使用https仓库地址）：

bash
docker run --rm jjhursey/pmix-xver-tester /home/pmixer/bin/run-xversion.sh \
       --repo https://github.com/USERNAME/pmix.git --branch my-topic-branch

使用卷挂载路径运行

要将基线与本地构建目录进行比较，只需将其卷挂载到容器中，并使用--path选项指向容器内的位置：

bash
docker run --rm -v $PWD/my-local-branch:/home/pmixer/my-branch jjhursey/pmix-xver-tester \
       /home/pmixer/bin/run-xversion.sh --path /home/pmixer/my-branch

PMIx CI

所有CI测试在运行前都会执行构建检查，以确保内部参考分支是最新的。

PMIx "Cross-version" CI测试

此CI测试运行以下命令：

bash
docker run --rm -v $PWD/my-local-branch:/home/pmixer/my-branch jjhursey/pmix-xver-tester \
       /home/pmixer/bin/run-xversion.sh --path /home/pmixer/my-branch -- --skip-tool

如果不想使用自己的分支，可运行：

bash
docker run --rm jjhursey/pmix-xver-tester /home/pmixer/bin/run-xversion.sh -- --skip-tool

PMIx "Cross-version: Tool" CI测试

此CI测试运行以下命令：

bash
docker run --rm -v $PWD/my-local-branch:/home/pmixer/my-branch jjhursey/pmix-xver-tester \
       /home/pmixer/bin/run-xversion.sh --path /home/pmixer/my-branch -- --skip-client

如果不想使用自己的分支，可运行：

bash
docker run --rm jjhursey/pmix-xver-tester /home/pmixer/bin/run-xversion.sh -- --skip-client

PMIx "Cross-version: make check" CI测试

此CI测试运行以下命令：

bash
docker run --rm -v $PWD/my-local-branch:/home/pmixer/my-branch jjhursey/pmix-xver-tester \
       /home/pmixer/bin/run-xversion.sh --path /home/pmixer/my-branch -- --skip-client --skip-tool --make-check

如果不想使用自己的分支，可运行：

bash
docker run --rm jjhursey/pmix-xver-tester /home/pmixer/bin/run-xversion.sh -- --skip-client --skip-tool --make-check