JLink不会产生可重新分发的图像

问题描述

一段时间以来,我一直在处理模块化项目,但是由于受文件名和自动模块的限制,我从来没有机会使用jlink工具来生成可重新分发的应用程序映像。今天,我选择开始一个独立的项目,该项目不会导入任何外部依赖项以防止使用兼容模式。该项目由3个模块组成,并且位于maven中,因此我只会发布我正在使用的jlink命令代码段。

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

我用来生成链接图像的命令如下:

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

更有趣的是,即使keytool二进制文件也返回相同的错误

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

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

解决方法

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

仅当系统上存在兼容的Linux运行时链接程序时,jlink生成的二进制文件才会运行。

运行时链接程序的目的是配置二进制文件以便在系统上执行-在构建可执行文件时,默认的运行时链接程序被硬编码到二进制文件中。您可以使用readelf -lldd之类的工具检查运行时链接程序(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容器中的链接虚拟机进行的肮脏测试会产生相同的错误。

当我获得所用的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:focal容器中构建了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
,

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


长版本

…这引发了一个问题:出了什么问题?…

哪里出了问题,您的 app/bin/java 二进制文件找不到您在构建 {{ 1}} 可执行文件在本地构建的任何计算机上。

发生此问题是因为 edu-day-jlinked 生成的 java 二进制文件已链接到本地​​安装的GNU glibc库JDK使用...

jlink

$ ldd edu-day-demo-modules-full/edu-day-jlinked/bin/java … libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007fa61a95b000) … 映像在Busybox Linux发行版中运行。而且Busybox不使用 bash:5

glibc

它使用不同的 C 库:musl

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

这有助于了解Linking流程。而且,请记住JLink builds a custom executable for a specific environment

您的本地计算机上的试用版运行正常,因为 bash-5.0# find / -name '*musl*' /lib/libc.musl-x86_64.so.1 /lib/ld-musl-x86_64.so.1 为您的本地环境构建了可执行文件 专门

建议的解决方案

…此处的docker旨在模拟未安装Java的环境…

这是 jlink ,它可以成功构建您的应用程序,结果图像“ 未安装Dockerfile ”…………

java

Docker best practice建议:“ 使用多阶段构建”(类似于上面的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"] )(),而您的目标是构建“ 没有安装Java的环境“。

多阶段构建的 Dockerfile 阶段使用的是Alpine Linux映像,该映像同时具有Maven和专门与Alpine发行版兼容的JDK。

FROM maven:3.6.1-jdk-13-alpine 是一个非常小的linux发行版, 上没有Java 。 {em> FROM alpine:latest 层如the Docker best practice文档所说被丢弃。结果图像中唯一的 maven:3.6.1-jdk-13-alpine java 中的图像。

相关问答

错误1:Request method ‘DELETE‘ not supported 错误还原:...
错误1:启动docker镜像时报错:Error response from daemon:...
错误1:private field ‘xxx‘ is never assigned 按Alt...
报错如下,通过源不能下载,最后警告pip需升级版本 Requirem...