1000kit/centos-quarkus-maven

Quarkus构建镜像文档

镜像概述

Quarkus构建镜像是Quarkus官方提供的专用Docker镜像，旨在简化Quarkus应用的构建流程。作为多阶段构建中的"构建阶段"镜像，它集成了完整的Quarkus构建工具链（含JDK、Maven/Gradle等依赖），可直接用于编译、打包Quarkus应用，并为后续"运行阶段"生成优化的运行时镜像（如JVM模式或原生模式镜像）提供基础。

核心功能与特性

• 多阶段构建支持：专为Docker多阶段构建设计，构建产物可直接传递给运行时镜像，减少最终镜像体积
• 工具链集成：预安装Quarkus开发所需工具（JDK 11+/17+、Maven 3.8+、Gradle 7.0+），无需额外配置
• 原生镜像构建：支持通过GraalVM生成原生可执行文件，显著提升应用启动速度和内存效率
• 构建缓存优化：内置Maven/Gradle缓存机制，重复构建时可复用依赖文件，缩短构建时间
• 兼容性保障：与Quarkus最新版本同步更新，确保构建流程与框架特性兼容

使用场景与适用范围

• Quarkus应用容器化：作为标准构建流程，用于将Quarkus应用打包为Docker镜像
• CI/CD流水线集成：在Jenkins、GitLab CI等持续集成环境中执行自动化构建
• 原生应用开发：需要生成原生可执行文件的高性能Java应用场景
• 微服务部署：为Kubernetes、OpenShift等容器编排平台提供优化的应用镜像
• 跨环境一致性：确保开发、测试、生产环境使用统一的构建工具链，避免"环境不一致"问题

使用方法与配置说明

基础使用流程

1. 多阶段构建示例（Maven项目）

dockerfile
# 构建阶段：使用Quarkus构建镜像编译应用
FROM quay.io/quarkus/ubi-quarkus-maven:22.3-java17 AS build
WORKDIR /workspace
# 复制依赖文件并缓存
COPY pom.xml .
COPY .mvn .mvn
# 下载依赖（利用缓存层优化）
RUN ./mvnw dependency:go-offline -B
# 复制源代码并构建
COPY src ./src
RUN ./mvnw package -DskipTests -Dquarkus.package.type=uber-jar

# 运行阶段：使用轻量级运行时镜像
FROM quay.io/quarkus/ubi-quarkus-jre17:22.3
WORKDIR /workspace
# 从构建阶段复制构建产物
COPY --from=build /workspace/target/quarkus-app/ /workspace/
EXPOSE 8080
# 启动应用
CMD ["java", "-jar", "quarkus-run.jar"]

2. 原生镜像构建示例

dockerfile
# 构建阶段：生成原生可执行文件
FROM quay.io/quarkus/ubi-quarkus-maven:22.3-java17 AS build
WORKDIR /workspace
COPY pom.xml .
COPY src ./src
# 使用native profile构建原生镜像
RUN ./mvnw package -DskipTests -Pnative -Dquarkus.native.container-build=true

# 运行阶段：使用极简基础镜像
FROM registry.access.redhat.com/ubi8/ubi-minimal:8.7
WORKDIR /workspace
# 复制原生可执行文件
COPY --from=build /workspace/target/*-runner /workspace/application
# 赋予执行权限
RUN chmod +x /workspace/application
EXPOSE 8080
# 启动原生应用
ENTRYPOINT ["./application", "-Dquarkus.http.host=0.0.0.0"]

环境变量配置

构建镜像支持通过环境变量调整构建行为，常用变量如下：

构建缓存优化

为提升重复构建效率，建议在构建命令中添加缓存卷挂载（适用于本地开发）：

bash
docker run -v $(pwd):/workspace -v ~/.m2:/home/quarkus/.m2 quay.io/quarkus/ubi-quarkus-maven:22.3-java17 ./mvnw package

版本选择

Quarkus构建镜像通过标签区分JDK版本和基础镜像类型，常用标签格式：

• ubi-quarkus-maven:<version>-java<jdk-version>：基于UBI的Maven构建镜像
• ubi-quarkus-gradle:<version>-java<jdk-version>：基于UBI的Gradle构建镜像
• centos-quarkus-maven:<version>-java<jdk-version>：基于CentOS的构建镜像（旧版本）

推荐使用UBI（Universal Base Image）系列镜像，具有更小体积和更好的安全性。

常见问题

Q：构建时提示依赖下载失败？

A：检查网络连接，或通过-v ~/.m2:/home/quarkus/.m2挂载本地Maven仓库缓存。

Q：如何指定Quarkus构建profile？

A：通过环境变量传递：docker run -e QUARKUS_BUILD_OPTS="-Dquarkus.profile=prod" ...

Q：原生镜像构建失败怎么办？

A：确保-Pnative参数已添加，且宿主机内存≥4GB（原生构建需较高内存）。