bellsoft/liberica-native-image-kit-container 镜像文档

镜像概述和主要用途

本镜像基于Alpaquita Linux Stream系统，集成了Liberica Native Image Kit (NIK)工具，用于将JVM应用程序转换为原生可执行文件。原生可执行文件具有近乎即时的启动时间，适用于云原生环境下的高效部署。镜像提供musl和glibc两种C库实现版本，满足不同系统兼容性需求，支持构建轻量级、高性能的原生应用，并可配合Alpaquita Linux基础镜像（如bellsoft/alpaquita-linux-base）运行最终产物。

核心功能和特性

Alpaquita Linux基础特性

• 轻量级设计：基础镜像大小仅3.22MB，资源占用低，适合容器化部署
• 优化的C库：提供musl perf（兼容标准musl，兼顾体积与性能）和glibc（部分场景性能优于主流glibc系统）
• 安全增强：支持用户空间二进制保护
• 灵活内存管理：内置4种malloc实现，适配不同工作负载
• 广泛兼容性：支持Docker和QEMU，可无缝集成现有容器生态

Liberica Native Image Kit (NIK)功能

• 原生可执行文件转换：将JVM字节码编译为原生机器码，消除JVM启动开销
• 快速启动：原生应用启动时间接近静态编译程序
• 多版本支持：兼容Java 17、21、24、25，对应NIK 23、24、25版本

镜像特性

• 双libc支持：提供musl（兼容Alpine等musl系统）和glibc（兼容主流Linux系统）版本
• 调试增强：提供含Apache Maven和GNU GDB的debug标签镜像，支持原生应用调试

使用场景和适用范围

• 云原生应用部署：需快速启动、低资源占用的微服务或无状态应用
• Alpine迁移场景：基于musl的Alpine用户可无缝迁移（musl perf与标准musl 100%兼容）
• glibc性能优化：需保留glibc依赖但追求更高性能的应用（Alpaquita glibc版本在部分场景性能优于主流系统）
• 原生应用构建流程：作为构建阶段工具，生成原生可执行文件后，可剥离至最小基础镜像运行

标签说明

镜像标签格式与含义如下，支持NIK 23（Java 17/21）、NIK 24（Java 24）、NIK 25（Java 25），并区分libc类型（musl/glibc）及是否包含调试工具：

基础标签（含NIK与运行时）

示例：jdk-17-nik-23-musl表示基于Alpaquita Linux musl、集成NIK 23和Java 17的镜像。

Debug标签（含调试工具）

调试版本镜像额外包含Apache Maven和GNU GDB，标签格式为：

• jdk-17-nik-23-debug-[libc]
• jdk-21-nik-23-debug-[libc]
• jdk-24-nik-24-debug-[libc]
• jdk-25-nik-25-debug-[libc]

使用方法和配置说明

前提条件

• 本地安装Docker环境
• 待转换的JVM应用（如JAR包）

构建原生镜像步骤

1. 选择镜像标签

根据应用的Java版本、依赖的C库类型选择标签。例如：

• Java 17应用，需musl兼容性：jdk-17-nik-23-musl
• Java 24应用，需glibc：jdk-24-nik-24-glibc

2. 执行原生构建（docker run示例）

通过挂载本地应用目录至容器，运行native-image命令生成原生可执行文件：

bash
# 示例：将当前目录下的myapp.jar转换为原生可执行文件
docker run --rm -v $(pwd):/app \
  bellsoft/liberica-native-image-kit-container:jdk-17-nik-23-musl \
  native-image -jar /app/myapp.jar -o /app/myapp-native

参数说明：

• --rm：构建完成后自动删除容器
• -v $(pwd):/app：挂载本地当前目录至容器内/app路径，便于读取JAR包和输出产物
• native-image：NIK提供的原生构建命令，支持标准参数（如-jar指定JAR包，-o指定输出文件名）

3. 运行原生镜像

构建生成的原生可执行文件（如myapp-native）可放入Alpaquita Linux基础镜像运行，进一步减小部署体积：

dockerfile
# Dockerfile示例：基于Alpaquita Linux基础镜像运行原生应用
FROM bellsoft/alpaquita-linux-base:musl
COPY myapp-native /app/
ENTRYPOINT ["/app/myapp-native"]

4. 调试场景（使用debug标签）

如需调试原生应用，使用含GDB的debug标签镜像：

bash
# 示例：使用debug镜像调试原生应用
docker run --rm -v $(pwd):/app \
  bellsoft/liberica-native-image-kit-container:jdk-17-nik-23-debug-musl \
  gdb /app/myapp-native

许可证信息

本镜像包含第三方软件组件，可能涉及不同许可证条款。用户需自行确保对镜像的使用符合所有包含软件的许可证要求。

可通过以下命令查看镜像中已安装组件及其许可证信息：

bash
docker run --rm bellsoft/liberica-native-image-kit-container:musl apk list -I

Alpaquita Linux和Liberica NIK的***许可信息可参考：

• Alpaquita Linux***文档
• Liberica NIK许可说明