Docker-drawio项目在ARMv7架构上的移植实践

背景介绍

drawio是一款流行的开源图表绘制工具，官方提供了Docker镜像以便于部署。然而，官方镜像默认不支持ARMv7架构（如树莓派等设备），这给在嵌入式设备上使用drawio带来了挑战。

ARMv7架构的兼容性问题

ARMv7架构与常见的x86架构存在显著差异，这导致直接构建官方Docker镜像时会遇到以下问题：

1. 基础镜像不兼容：官方使用的openjdk:11-jdk-slim镜像不支持ARMv7
2. 构建过程中的Java运行时错误
3. 依赖包安装问题

解决方案详解

1. 基础镜像替换

首先需要将官方Dockerfile中的基础镜像替换为支持ARMv7的版本。推荐使用adoptopenjdk/openjdk11:armv7l-debianslim-jdk-11.0.23_9-slim作为构建阶段的基础镜像。

2. 构建过程优化

由于直接在Docker容器内构建会遇到Java运行时错误，建议采用以下替代方案：

1. 在宿主机上执行构建：

git clone --depth 1 https://github.com/jgraph/drawio.git
cd drawio/etc/build/
ant war

2. 将生成的draw.war文件复制到Docker构建目录

3. 修改Dockerfile

简化后的Dockerfile主要包含以下关键部分：

• 使用tomcat:9-jre11作为运行时基础镜像
• 安装必要的依赖包（certbot、curl等）
• 直接复制预先构建好的draw.war文件
• 配置Tomcat将drawio应用部署为根路径
• 设置适当的用户权限

构建ARMv7镜像

完成上述修改后，可以使用以下命令构建ARMv7架构的镜像：

docker build --platform linux/arm/v7 -t your-image-name:tag .

技术要点解析

1. 多阶段构建的取舍：由于构建阶段的兼容性问题，放弃了官方使用的多阶段构建方案，改为在宿主机上完成构建。

2. Java版本选择：ARMv7架构对Java版本较为敏感，需要选择专门为ARM优化的JDK发行版。

3. Tomcat配置：通过xmlstarlet工具动态修改Tomcat的server.xml文件，确保drawio应用部署在根路径下。

实际应用效果

经过上述修改后构建的镜像已在树莓派等ARMv7设备上成功运行，性能表现良好，能够满足基本的图表绘制需求。

总结

为drawio创建ARMv7兼容的Docker镜像虽然存在一些挑战，但通过合理的构建策略和镜像优化，完全可以实现。这种方法不仅适用于drawio项目，也可以为其他需要在ARM架构上部署的Java Web应用提供参考。