JLink 不生成可再发行映像

Question

一段时间以来，我一直在使用模块化项目，但由于文件名和自动模块的限制，我从来没有机会使用 jlink 工具来生成可再发行的应用程序映像。今天，我选择启动一个独立的项目，该项目不导入任何外部依赖项以防止使用兼容模式。该项目由 3 个模块组成，位于 maven 中，所以我只会发布我正在使用的 jlink 命令片段。

供参考的项目：https://gitlab.com/Dragas/edu-day-demo，签出modules-full标签。项目是package目标而构建的，以防止污染本地 .m2 存储库。项目已配置为拉取依赖项，因此打包和部署会更容易。

我用来生成jlink图像的命令如下：

jlink 
--module-path edu-day-runtime/target/dependency/:edu-day-runtime/target/ 
--add-modules ALL-MODULE-PATH 
--output edu-day-jlinked 
--launcher edurun=edu.day.runtime

调用该命令确实会生成一个 jlink 映像，其中包含运行项目所需的最低模块、Java 库和 JVM 二进制文件。调用生成映像的计算机

edu-day-jlinked/bin/edurun 1 1

运行项目并输出以下内容

Result of sum is 2

同时，尝试在容器化环境中运行相同的环境(这里我使用bash:5，一个非 java 映像来模拟未安装 java 的环境)不会产生类似的结果。相反，shell 似乎没有找到名为java的二进制文件

docker run -it -v "$(pwd)/edu-day-jlinked:/app" bash:5
...(in container)
bash-5.0# /app/bin/edurun 1 1
/app/bin/edurun: line 4: /app/bin/java: not found

经过检查，该文件夹确实包含名为java的二进制文件

bash-5.0# ls -la
total 52
drwxr-xr-x    2 1000     1000          4096 Aug 23 07:53 .
drwxr-xr-x    7 1000     1000          4096 Aug 23 07:53 ..
-rwxr-xr-x    1 1000     1000           116 Aug 23 07:53 edurun
-rwxr-xr-x    1 1000     1000         16688 Aug 23 07:53 java
-rwxr-xr-x    1 1000     1000         16712 Aug 23 07:53 keytool

但即使直接调用它(显示帮助消息)也不会产生任何结果，除了找不到二进制文件的相同消息

(in /app/bin/ folder)
bash-5.0# ./java 
bash: ./java: No such file or directory

更有趣的是，即使是键工具二进制文件也返回相同的错误

(in /app/bin/ folder)
bash-5.0# ./keytool
bash: ./keytool: No such file or directory

这就提出了一个问题：出了什么问题？我还没有深入研究 jlink 是如何工作的，但我的猜测是它从我自己的 java 安装(来自 arch 存储库的 openjdk 11.0.8+10)复制二进制文件，并认为它是可再分发的。还是我只是错过了一些命令行选项？

Answer 1

您的问题是测试容器 (bash：5) 未使用与 Java 环境相同版本的运行时链接器。

jlink 生成的二进制文件仅在系统上存在兼容的 Linux 运行时链接器时运行。

运行时链接器的用途是配置二进制文件以在系统上执行 - 在生成可执行文件时，默认运行时链接器将硬编码到二进制文件中。您可以使用readelf -l或ldd等工具检查运行时链接器(ldd 仅在可以找到运行时链接器时才有效)

amd64 linux(例如ubuntu)的默认运行时链接器是：/lib64/ld-linux-x86-64.so.2

i386 Linux 的默认运行时链接器为：/lib/ld-linux.so.2

在bash:5容器上，默认运行时链接器为：/lib/ld-musl-x86_64.so.1

这与 jdk 的运行时链接器不兼容

错误：/app/bin/java: not found是由于找不到二进制文件的运行时链接器。对bash:5容器中链接的 VM 进行脏测试时会给出相同的错误。

当我获得我使用的 Java 的运行时链接器时：

$ docker run --rm -it -v (pwd)/edu-day-jlinked64:/app -w /here bash:5 bash
bash-5.0# /app/bin/java
bash: /app/bin/java: No such file or directory
bash-5.0# strings -a /app/bin/java | grep '^/lib'
/lib64/ld-linux-x86-64.so.2
bash-5.0# ls -l /lib64/ld-linux-x86-64.so.2
ls: /lib64/ld-linux-x86-64.so.2: No such file or directory

使用板载的运行时链接器进行测试：

bash-5.0# /lib/ld-musl-x86_64.so.1 --list /app/bin/java
/lib64/ld-linux-x86-64.so.2 (0x7fe2852a3000)
libjli.so => /app/bin/../lib/libjli.so (0x7fe28528c000)
libc.so.6 => /lib64/ld-linux-x86-64.so.2 (0x7fe2852a3000)
libz.so.1 => /lib/libz.so.1 (0x7fe285272000)
libdl.so.2 => /lib64/ld-linux-x86-64.so.2 (0x7fe2852a3000)
libpthread.so.0 => /lib64/ld-linux-x86-64.so.2 (0x7fe2852a3000)
Error relocating /app/bin/../lib/libjli.so: __snprintf_chk: symbol not found
Error relocating /app/bin/../lib/libjli.so: __vfprintf_chk: symbol not found
Error relocating /app/bin/../lib/libjli.so: __read_chk: symbol not found
Error relocating /app/bin/../lib/libjli.so: __memmove_chk: symbol not found
Error relocating /app/bin/../lib/libjli.so: __printf_chk: symbol not found
Error relocating /app/bin/../lib/libjli.so: __fprintf_chk: symbol not found
Error relocating /app/bin/../lib/libjli.so: __sprintf_chk: symbol not found

所以它在这里绝对行不通。

让我们使用一些"标准"的东西。由于我在ubuntu：focus容器中构建了jlink应用程序，使用已安装的java版本，让我们使用一个没有内置java的版本：

$ docker run --rm -it -v $(pwd)/edu-day-jlinked64:/app -w /here ubuntu:focal bash
root@865c9c12c029:/here# /app/bin/java
Usage: java [options] <mainclass> [args...]
(to execute a class)
or  java [options] -jar <jarfile> [args...]
(to execute a jar file)
or  java [options] -m <module>[/<mainclass>] [args...]
java [options] --module <module>[/<mainclass>] [args...]
(to execute the main class in a module)
or  java [options] <sourcefile> [args]
(to execute a single source-file program)

所以它在这种情况下会起作用。

再现性：

构建使用：

$ docker run --rm -it -v $(pwd):/here -w /here ubuntu:focal bash
# apt-get update
# DEBIAN_FRONTEND=noninteractive apt-get install -y git openjdk-14-jdk maven
# git clone https://gitlab.com/Dragas/edu-day-demo .
# git checkout modules-full
# ./mvnw package
# rm -rf edu-day-runtime/target/classes
# jlink --module-path edu-day-runtime/target/dependency/:edu-day-runtime/target/ --add-modules ALL-MODULE-PATH --output edu-day-jlinked    --launcher edurun=edu.day.runtime
# ./edu-day-jlinked/bin/edurun 1 1
Result of sum is 2

在相邻目录中：

$ docker run --rm -it -v $(pwd)/edu-day-jlinked:/app -w /here bash:5 bash
bash-5.0# /app/bin/edurun 1 1
/app/bin/edurun: line 4: /app/bin/java: not found

在另一个目录中：

$ docker run --rm -it -v $(pwd)/edu-day-jlinked:/app -w /here ubuntu:focal bash
root@200b4a98f9ee:/here# /app/bin/edurun 1 1
Result of sum is 2

Answer 2

TL;DR —bash:5映像使用的 C 库与与edu-day-jlinked/bin/java可执行文件链接的C库二进制不兼容。

<小时 />

长版

">...这就提出了一个问题：出了什么问题?...">

出错的是，您的app/bin/java二进制文件无法找到您在本地构建edu-day-jlinked可执行文件时最初链接到的C库。

出现此问题的原因是jlink生成的java二进制文件链接到本地安装的 JDK 使用的GNUglibc库...

$ ldd edu-day-demo-modules-full/edu-day-jlinked/bin/java
…
libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007fa61a95b000)
…

而bash:5映像在BusyboxLinux 发行版中运行。而且忙盒不使用glibc...

bash-5.0# ldd app/bin/java
…
libjli.so => app/bin/../lib/jli/libjli.so (0x7f572a16d000)
…
libc.so.6 => /lib64/ld-linux-x86-64.so.2 (0x7f572a19f000)
Error relocating app/bin/../lib/jli/libjli.so: __snprintf_chk: symbol not found
Error relocating app/bin/../lib/jli/libjli.so: __vfprintf_chk: symbol not found
Error relocating app/bin/../lib/jli/libjli.so: __read_chk: symbol not found
Error relocating app/bin/../lib/jli/libjli.so: __memmove_chk: symbol not found
Error relocating app/bin/../lib/jli/libjli.so: __printf_chk: symbol not found
Error relocating app/bin/../lib/jli/libjli.so: __fprintf_chk: symbol not found
Error relocating app/bin/../lib/jli/libjli.so: __sprintf_chk: symbol not found

它使用不同的C库：musl...

bash-5.0# find / -name '*musl*'
/lib/libc.musl-x86_64.so.1
/lib/ld-musl-x86_64.so.1

它有助于理解链接过程。记住JLink 会为特定环境构建自定义可执行文件，这也有助于记住。

在本地计算机上的试运行有效，因为jlink专门为本地环境构建了可执行文件。

建议的解决方案

">...这里的Docker旨在模拟一个没有安装Java的环境......">

这是一个成功构建应用程序并且生成的映像">未安装java"的Dockerfile...

FROM maven:3.6.1-jdk-13-alpine as build
WORKDIR /app
COPY pom.xml .
COPY edu-day-sum edu-day-sum
COPY edu-day-runtime edu-day-runtime
COPY edu-day-api edu-day-api
RUN mvn package && 
--module-path ${JAVA_HOME}/jmods:edu-day-runtime/target/dependency/:edu-day-runtime/target/edu-day-runtime-1.0-SNAPSHOT.jar 
--add-modules ALL-MODULE-PATH 
--output edu-day-jlinked 
--launcher edurun=edu.day.runtime
FROM alpine:latest
COPY --from=build /app/edu-day-jlinked /app
ENTRYPOINT ["/app/bin/edurun"]
CMD ["1", "1"]

Docker最佳实践建议：">使用多阶段构建"(如上Dockerfile)，当你的目标是构建">一个没有安装Java的环境"时。

多阶段构建的FROM maven:3.6.1-jdk-13-alpine阶段使用alpine Linux映像，该映像具有Maven和专门构建的JDK，以与alpine发行版兼容。

FROM alpine:latest是一个非常小的Linux发行版，上面没有Java。maven:3.6.1-jdk-13-alpine层被丢弃，如Docker 最佳实践文档所述。生成的图像中唯一的java是app/bin中的那个。