如何构建可在32位ARMv7架构树莓派4B上运行Jar包的Docker容器？

背景 #

我正在开发一款小型应用，计划部署在**树莓派4B（32位、4GB内存）**的Docker容器里。我刚入门Docker，之前只在Mac开发机上完成过镜像构建和容器运行，而且那个容器配置和Jar包在Mac上能正常工作。

当前尝试的Dockerfile #

我最初使用的基础Dockerfile如下：

FROM java:8
WORKDIR /
ADD my_jar.jar my_jar.jar
EXPOSE 8080
CMD java -jar my_jar.jar

遇到的问题 #

我直接在树莓派上执行docker build . -t myDockerImage构建镜像，构建成功后运行容器时出现了如下错误：

WARNING: The requested image's platform (linux/amd64) does not match the detected host platform (linux/arm/v7) and no specific platform was requested
standard_init_linux.go:219: exec user process caused: exec format error

之后我查阅资料尝试改用OpenJDK镜像，但构建时又收到这样的提示：

no matching manifest for linux/arm/v7 in the manifest list entries

我在Docker Hub上没找到适配这个ARMv7架构的Java镜像，现在想知道有没有简便的方法（如果没有的话复杂方案也可以接受），能在树莓派的Docker容器里配置好Java环境，从而运行我的Jar包。

补充硬件信息 #

树莓派的lshw输出参数：

raspberrypi
description: ARMv7 Processor rev 3 (v7l)
product: Raspberry Pi 4 Model B Rev 1.1
serial: 10000000b3320840
width: 32 bits
capabilities: smp

解决方案 #

方法1：使用官方适配ARMv7的OpenJDK镜像（最简便） #

官方OpenJDK镜像其实有专门针对ARM32v7架构的变体，你只需要指定正确的标签即可。修改你的Dockerfile如下：

FROM openjdk:8-jdk-arm32v7
WORKDIR /
ADD my_jar.jar my_jar.jar
EXPOSE 8080
CMD java -jar my_jar.jar

这个镜像完全适配你的树莓派架构，直接构建运行就能解决之前的格式错误问题。

方法2：基于树莓派系统镜像构建自定义Java环境 #

如果找不到合适的预构建镜像，可以用树莓派官方的Raspbian镜像作为基础，手动安装Java环境：

FROM raspbian/bullseye
WORKDIR /
# 安装OpenJDK 8并清理缓存以减小镜像体积
RUN apt-get update && apt-get install -y openjdk-8-jdk && \
    rm -rf /var/lib/apt/lists/*
ADD my_jar.jar my_jar.jar
EXPOSE 8080
CMD java -jar my_jar.jar

这个方法的兼容性拉满，因为完全基于树莓派的原生系统，缺点是构建镜像时需要在线安装依赖，耗时会久一些。

方法3：在Mac上跨架构构建镜像（适合批量部署） #

如果你需要频繁构建并部署到树莓派，可以在Mac上利用Docker的buildx功能，直接构建适配ARMv7的镜像：

1. 先启用buildx工具：

docker buildx create --use

2. 跨架构构建镜像（--load参数会把镜像加载到本地Docker）：

docker buildx build --platform linux/arm/v7 -t myDockerImage . --load

3. 将构建好的镜像导出并传输到树莓派：

# 导出镜像为tar包
docker save myDockerImage > myDockerImage.tar
# 通过scp传到树莓派（替换成你的树莓派IP）
scp myDockerImage.tar pi@192.168.x.x:/home/pi/
# 在树莓派上加载镜像
docker load < myDockerImage.tar

这个方法适合需要在开发机统一管理多架构镜像的场景，不用在树莓派上耗时构建。

内容的提问来源于stack exchange，提问作者michpohl