vegardit/graalvm-maven

docker-graalvm-maven 镜像文档

镜像概述和主要用途

docker-graalvm-maven 是一个基于 Debian stable-slim 的 Docker 镜像，专为使用 GraalVM native-image 特性构建 Java Maven 项目的原生 Linux 二进制文件而设计。该镜像每周自动构建，以集成最新的操作系统安全修复，确保构建环境的安全性和时效性。

核心功能和特性

基础环境

• 底层系统：基于 Debian stable-slim，提供轻量级、稳定的构建基础
• 自动更新：每周自动构建，集成最新操作系统安全补丁，保障环境安全性

预装组件

• GraalVM 社区版：支持 Java 11、17 或 20 版本，包含 native-image 扩展，用于将 Java 应用编译为原生二进制文件
• Apache Maven：最新版本，用于构建和管理 Java Maven 项目
• Docker CE 客户端：支持与外部 Docker 守护进程交互，便于构建流程中集成 Docker 操作
• git 客户端：提供版本控制功能，支持从代码仓库拉取项目源码
• upx：可执行文件打包工具，用于压缩生成的原生二进制文件，减小体积
• bash-funk：Bash 工具集，包含自适应 Bash 提示符和常用脚本工具，提升命令行体验

使用场景和适用范围

• Java 原生应用开发：开发人员在本地环境构建 Maven 项目的原生二进制文件，验证 native-image 构建流程
• CI/CD 流水线集成：在持续集成/部署流程中自动化构建原生应用，提升交付效率
• 性能优化场景：需减小 Java 应用启动时间、降低内存占用的场景，通过原生编译实现性能优化
• 二进制文件压缩：使用 upx 对原生二进制文件进行压缩，节省存储和传输资源

详细的使用方法和配置说明

镜像获取

从 Docker Hub 获取镜像（镜像名称：vegardit/graalvm-maven）：

bash
# 获取最新版本（默认指向最新 LTS Java 版本，如 17）
docker pull vegardit/graalvm-maven:latest

# 按 Java 版本选择
docker pull vegardit/graalvm-maven:11  # GraalVM CE Java 11
docker pull vegardit/graalvm-maven:17  # GraalVM CE Java 17
docker pull vegardit/graalvm-maven:20  # GraalVM CE Java 20

基础构建示例

挂载本地 Maven 项目目录，执行原生构建：

bash
docker run --rm \
  -v "$(pwd)":/app \          # 挂载当前项目目录到容器内 /app
  -w /app \                   # 设置工作目录为 /app
  vegardit/graalvm-maven:latest \
  mvn -Pnative package        # 使用 Maven native profile 构建原生二进制文件

说明：构建产物（如 target/ 目录下的二进制文件）将输出到本地项目目录，因容器内 /app 与本地目录挂载关联。

集成 Docker 客户端

如需在构建过程中与外部 Docker 守护进程交互（如构建 Docker 镜像），挂载 Docker 套接字：

bash
docker run --rm \
  -v "$(pwd)":/app \
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载 Docker 套接字
  -w /app \
  vegardit/graalvm-maven:latest \
  mvn -Pnative,docker package  # 假设项目包含 docker profile 用于构建镜像

使用 upx 压缩二进制文件

构建后通过 upx 压缩原生二进制文件：

bash
docker run --rm \
  -v "$(pwd)":/app \
  -w /app \
  vegardit/graalvm-maven:latest \
  sh -c "mvn -Pnative package && upx --best target/*.bin"  # 先构建再压缩

相关资源

• 源码仓库：https://github.com/vegardit/docker-graalvm-maven
• 官方文档：https://github.com/vegardit/docker-graalvm-maven/blob/main/README.md