Quarkus中如何将本地依赖libsapjco3.so打包到容器文件系统

一、Quarkus原生实现方式 #

不需要额外编写镜像脚本，直接通过Quarkus的配置就能完成文件复制和路径配置：

• 配置资源自动复制
  在项目的application.properties里添加对应配置，让Quarkus构建时自动把本地的libsapjco3.so复制到构建产物的指定目录（该目录默认会被加入java.library.path）：

  # JVM模式构建时生效
  quarkus.jvm.resources.includes=libsapjco3.so
  # Native模式构建时生效
  quarkus.native.resources.includes=libsapjco3.so
  

  这里假设libsapjco3.so放在项目根目录或src/main/resources下，构建后会被复制到target/quarkus-app/lib（JVM模式）或原生镜像的资源目录（Native模式）。

• 自定义java.library.path（可选）
  如果需要指定非默认的路径，可在配置里添加JVM参数：

  # JVM运行时指定
  quarkus.jvm.args=-Djava.library.path=/usr/lib64:/opt/sap/libs
  # Native构建时指定额外参数
  quarkus.native.additional-build-args=-Djava.library.path=/usr/lib64:/opt/sap/libs
  

二、集成自定义容器镜像构建流程 #

如果要基于Quarkus官方镜像手动扩展，按以下步骤集成：

1. 编写自定义Dockerfile
   在项目根目录创建Dockerfile，基于对应版本的Quarkus基础镜像，通过COPY命令把libsapjco3.so放到容器的java.library.path目录（比如/usr/lib64，这是Linux系统默认的库路径之一）：

# JVM模式基础镜像
FROM quay.io/quarkus/quarkus-jvm:3.1.0.Final
# 复制Quarkus构建产物到容器部署目录
COPY target/quarkus-app/ /deployments/
# 复制libsapjco3.so到系统库目录
COPY src/main/resources/libsapjco3.so /usr/lib64/
# 设置JVM参数确保能找到库文件
ENV JAVA_OPTS="-Djava.library.path=/usr/lib64"

2. 让Quarkus使用自定义Dockerfile
   在application.properties里配置镜像构建参数，指定使用你编写的Dockerfile：

quarkus.container-image.builder=docker
quarkus.docker.dockerfile-path=Dockerfile
# 可选：设置镜像名称和标签
quarkus.container-image.name=sap-jco-app
quarkus.container-image.tag=1.0.0

3. 触发构建
   执行Quarkus的构建命令，同时开启镜像构建：

./mvnw clean package -Dquarkus.container-image.build=true

两种方案都能确保libsapjco3.so被正确放置到容器的java.library.path中，满足SAP JCo的运行依赖要求。

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