latexml/latexml-test-runtime

LaTeXML测试运行时镜像说明

镜像概述

本镜像为LaTeXML项目在Travis CI上的自动化测试提供运行时环境，旨在验证LaTeXML在不同Perl版本和TexLive版本组合下的兼容性与稳定性。镜像基于Ubuntu Xenial系统，预安装对应版本的Perl（通过perlbrew）和LaTeXML依赖，避免测试过程中重复安装配置，大幅提升测试效率。

核心功能

1. 多环境适配：覆盖含TexLive和不含TexLive两种测试场景，支持多种Perl版本（如5.22.4）和TexLive版本（如texlive-2015）的组合。
2. 预安装依赖：镜像内已预装所需的Perl、LaTeXML及相关工具，减少测试准备时间。
3. 本地调试支持：可本地拉取镜像并挂载LaTeXML仓库，模拟Travis测试环境进行问题排查。
4. 自动化构建：通过脚本批量生成Dockerfile并构建镜像，支持上传至DockerHub供公共使用。

使用场景

• Travis CI自动化测试：在持续集成流程中快速运行LaTeXML测试，验证代码变更的兼容性。
• 本地问题复现：在本地环境复现Travis测试中的失败场景，调试特定版本组合下的bug。
• 版本兼容性验证：测试LaTeXML在不同Perl/TexLive版本下的运行情况，确保跨环境稳定性。

配置说明与部署示例

构建镜像

使用build-test-image.sh脚本生成特定版本组合的镜像：

bash
src/build-test-image.sh 5.22.4 texlive-2015

该命令会生成并构建镜像latexml/latexml-test-runtime:5.22.4_texlive-2015。

批量构建所有所需镜像：

bash
src/build-all.sh

（注：需先登录DockerHub以上传镜像）

本地运行测试

1. 拉取镜像：

bash
docker pull latexml/latexml-test-runtime:5.22.4_texlive-2015

2. 自动执行测试：

bash
docker run --rm -t -i -v /path/to/your/latexml/repo:/root/latexml latexml/latexml-test-runtime:5.22.4_texlive-2015

该命令会自动安装依赖并执行make test。

3. 手动调试：

bash
docker run --rm -t -i -v /path/to/your/latexml/repo:/root/latexml latexml/latexml-test-runtime:5.22.4_texlive-2015 /bin/bash
# 加载perlbrew环境
source /usr/local/perlbrew/etc/bashrc
# 手动执行测试命令
cpanm -v --installdeps --notest .
perl Makefile.PL && make test