当前位置:

首页 > 编程开发 > Quarkus 应用 Docker 部署指南(Render.com)

Quarkus 应用 Docker 部署指南(Render.com)

本文旨在解决将QuarkusJava应用通过Docker部署到Render.com时遇到的构建失败问题。核心内容是采用多阶段Dockerfile策略,确保在容器内部完成应用编译,并仅将运行时所需的产物打包到最终镜像中,同时强调.dockerignore文件配置的重要性,以实现高效、可靠的云平台部署。

本文目录

    Quarkus 应用在 Render.com 上的 Docker 部署指南

    本文旨在解决将 Quarkus Java 应用通过 Docker 部署到 Render.com 时遇到的构建失败问题。核心内容是采用多阶段 Dockerfile 策略,确保在容器内部完成应用编译,并仅将运行时所需的产物打包到最终镜像中,同时强调 .dockerignore 文件配置的重要性,以实现高效、可靠的云平台部署。

    1. 背景与挑战

    随着 Heroku 等平台免费层的取消,开发者们正积极寻找替代方案来部署 Java 应用。Render.com 作为一种流行的云服务,虽然不直接支持 Java 原生构建,但其对 Docker 的良好支持使其成为一个有吸引力的选择。然而,对于初次尝试将 Quarkus 应用通过 Docker 部署到 Render 的开发者来说,可能会遇到构建失败的问题,尤其是在处理 Quarkus 默认提供的 Dockerfile 时。

    典型的 Quarkus 应用在本地开发时,通常会在运行 mvnw package 后生成编译好的产物。而默认的 Quarkus Dockerfile 往往假定这些产物(位于 target/quarkus-app 目录)已经存在于构建上下文中。当直接将包含源代码的 Git 仓库连接到 Render 并尝试构建时,由于 target 目录尚未生成,Docker 构建过程将因找不到文件而失败,报错信息通常为 no such file or directory。

    2. 问题分析:默认 Dockerfile 的局限性

    Quarkus 提供的默认 Dockerfile.jvm 示例通常如下所示:

    FROM registry.access.redhat.com/ubi8/openjdk-17:1.14
    ENV LANGUAGE='en_US:en'
    COPY --chown=185 target/quarkus-app/lib/ /deployments/lib/
    COPY --chown=185 target/quarkus-app/*.jar /deployments/
    COPY --chown=185 target/quarkus-app/app/ /deployments/app/
    COPY --chown=185 target/quarkus-app/quarkus/ /deployments/quarkus/
    EXPOSE 8080
    USER 185
    ENV JAVA_OPTS="-Dquarkus.http.host=0.0.0.0 -Djava.util.logging.manager=org.jboss.logmanager.LogManager"
    ENV JAVA_APP_JAR="/deployments/quarkus-run.jar"

    这个 Dockerfile 的核心问题在于,它直接尝试从本地文件系统的 target/quarkus-app 目录复制文件。在 Docker 构建环境中,如果这个目录在构建开始前不存在(即没有在本地运行 mvnw package),或者在 Dockerfile 中没有明确的编译步骤,那么 COPY 指令就会失败。即使尝试在 COPY 之前添加 RUN ./mvnw package,如果构建上下文没有包含完整的项目源代码,同样会导致问题。

    3. 解决方案:采用多阶段 Dockerfile 构建

    解决此问题的最佳实践是采用多阶段 Dockerfile 构建。多阶段构建允许在一个 Dockerfile 中定义多个阶段,每个阶段可以基于不同的基础镜像,并且可以将前一个阶段的产物传递给下一个阶段。这使得我们可以在一个阶段中完成应用的编译,然后在另一个更轻量级的阶段中只包含运行时所需的产物,从而生成更小、更安全的最终镜像。

    以下是一个适用于 Quarkus 应用的多阶段 Dockerfile 示例:

    # --- 构建阶段 ---
    # 使用包含 JDK 和 Maven 的基础镜像进行编译
    FROM registry.access.redhat.com/ubi8/openjdk-17:1.14 as builder
    
    # 设置工作目录
    WORKDIR /project
    
    # 复制 Maven 依赖文件,利用 Docker 缓存加速构建
    COPY pom.xml .
    COPY .mvn .mvn
    COPY mvnw .
    RUN ./mvnw dependency:go-offline -B
    
    # 复制项目源代码
    COPY src src
    
    # 编译 Quarkus 应用
    RUN ./mvnw package -Dquarkus.package.type=mutable-jar -DskipTests
    
    # --- 运行时阶段 ---
    # 使用更轻量级的 JDK 运行时镜像
    FROM registry.access.redhat.com/ubi8/openjdk-17:1.14 as runner
    
    # 设置语言环境
    ENV LANGUAGE='en_US:en'
    
    # 从构建阶段复制编译好的应用产物
    COPY --from=builder /project/target/quarkus-app/lib/ /deployments/lib/
    COPY --from=builder /project/target/quarkus-app/*.jar /deployments/
    COPY --from=builder /project/target/quarkus-app/app/ /deployments/app/
    COPY --from=builder /project/target/quarkus-app/quarkus/ /deployments/quarkus/
    
    # 暴露应用端口
    EXPOSE 8080
    
    # 以非 root 用户运行
    USER 185
    
    # 设置 Java 运行时参数
    ENV JAVA_OPTS="-Dquarkus.http.host=0.0.0.0 -Djava.util.logging.manager=org.jboss.logmanager.LogManager"
    ENV JAVA_APP_JAR="/deployments/quarkus-run.jar"
    
    # 定义容器启动命令
    ENTRYPOINT [ "java", "-jar", "/deployments/quarkus-run.jar" ]

    多阶段 Dockerfile 详解:

    1. 构建阶段 (builder):

      • FROM registry.access.redhat.com/ubi8/openjdk-17:1.14 as builder: 选择一个包含 JDK 和构建工具(如 Maven)的基础镜像。as builder 为此阶段命名。
      • WORKDIR /project: 设置容器内的工作目录。
      • COPY pom.xml . 和 COPY .mvn .mvn 等:首先复制 Maven 相关的配置文件和 Wrapper 脚本。
      • RUN ./mvnw dependency:go-offline -B: 这一步会下载所有项目依赖。由于依赖通常不常变动,Docker 会缓存这一层,显著加速后续构建。
      • COPY src src: 复制项目源代码。
      • RUN ./mvnw package -Dquarkus.package.type=mutable-jar -DskipTests: 在容器内部执行 Maven 打包命令,生成可运行的 Quarkus JAR 包。-DskipTests 可以跳过测试以节省构建时间。
    2. 运行时阶段 (runner):

      • FROM registry.access.redhat.com/ubi8/openjdk-17:1.14 as runner: 选择一个用于运行应用的基础镜像。这里仍然使用了相同的 JDK 镜像,但如果需要更小的镜像,可以选择 JRE only 的镜像。
      • COPY --from=builder /project/target/quarkus-app/...: 这是多阶段构建的关键。它从名为 builder 的阶段中复制编译好的 quarkus-app 目录下的所有运行时文件到当前阶段的 /deployments 目录。这意味着最终的镜像只包含运行应用所需的最小文件集,不包含构建工具和源代码。
      • 其余指令与原始 Dockerfile 类似,用于配置运行时环境和启动命令。

    4. .dockerignore 文件配置

    在使用多阶段 Dockerfile 时,.dockerignore 文件的配置至关重要。它决定了哪些文件和目录不会被复制到 Docker 构建上下文中。如果 .dockerignore 文件中包含 * 或 src/ 等规则,可能会阻止源代码被复制到构建阶段,从而导致编译失败。

    重要提示: 确保 .dockerignore 文件中不包含会阻止源代码(如 src 目录)被复制到构建上下文的规则。如果存在 * 这样的通配符,请务必移除或修改,以允许必要的源代码被复制。

    一个合理的 .dockerignore 文件示例:

    target/
    .mvn/wrapper/maven-wrapper.jar
    .git/
    .gitignore
    .idea/
    *.iml
    *.log
    tmp/

    这个配置会忽略 target 目录(因为我们会在容器内生成它)、Git 相关文件、IDE 文件等,但会确保 src 目录和 pom.xml 等关键文件被包含在构建上下文中。

    5. Render.com 部署步骤

    完成上述 Dockerfile 和 .dockerignore 的配置后,在 Render.com 上部署 Quarkus 应用的步骤如下:

    1. 连接 GitHub 仓库: 在 Render 控制台中创建一个新的 Web Service,并将其连接到包含你的 Quarkus 项目的 GitHub 仓库。
    2. 配置构建环境:
      • Build Command (构建命令): 通常不需要显式设置,因为 Dockerfile 会处理所有构建逻辑。
      • Dockerfile Path (Dockerfile 路径): 指定你的 Dockerfile 在仓库中的相对路径,例如 ./src/main/docker/Dockerfile.jvm (如果你的 Dockerfile 位于此路径)。
      • Root Directory (根目录): 如果你的项目不是仓库的根目录,请指定包含 pom.xml 和 src 目录的子目录路径。
    3. 配置运行时环境:
      • Port (端口): 确保与 Dockerfile 中 EXPOSE 的端口一致,通常是 8080。
      • Health Check Path (健康检查路径): 根据你的 Quarkus 应用配置设置,例如 /q/health。
    4. 部署: 保存配置并触发部署。Render 将会拉取你的代码,根据 Dockerfile 构建镜像,并运行你的 Quarkus 应用。

    6. 总结与注意事项

    • 多阶段构建的优势: 通过多阶段 Dockerfile,我们实现了在容器内部完成应用编译,确保了构建环境的隔离性和一致性。最终生成的镜像更小,因为它只包含运行时所需的产物,不含构建工具和源代码,从而提高了部署效率和安全性。
    • 构建上下文的重要性: 理解 Docker 构建上下文对于避免 no such file or directory 错误至关重要。确保所有在 Dockerfile 中 COPY 或 ADD 的文件在构建开始时都存在于构建上下文中。
    • .dockerignore 的精确配置: 正确配置 .dockerignore 文件可以优化构建性能,避免不必要的文件被复制到构建上下文中,同时确保必要的源代码和依赖文件被包含。
    • 资源考量: Quarkus 应用在启动时可能需要一定的内存。在 Render 上部署时,请根据应用实际需求选择合适的实例类型和内存配置。

    通过遵循这些步骤和最佳实践,开发者可以成功地将 Quarkus Java 应用部署到 Render.com,享受云原生部署的便利性。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    QQ影音怎么加速播放视频课程
    QQ影音怎么加速播放视频课程

    播放时右键选播放速度,或点控制条倍速,1.25 到 1.5 倍看课最舒服;公式代码类内容别超过 1.25 倍。

    企业微信创建企业提示失败怎么办 实名与填写检查
    企业微信创建企业提示失败怎么办 实名与填写检查

    先看提示属于哪类:名称占用就加后缀,实名不一致就重填本人信息,证件不清晰就重拍。统一社会信用代码逐位核对,连续三次失败别改材料重投,直接联系客服人工核。

    Modern Web Guidance 的 legacy-scan 反转建议应该怎样判断?
    Modern Web Guidance 的 legacy-scan 反转建议应该怎样判断?

    说明源码提交对字符串、生成器和数组的识别边界,以及扫描命令与发行包核验限制。

    Codex 0.170.0 正式版的语音与连接更新,适用范围有哪些限制?
    Codex 0.170.0 正式版的语音与连接更新,适用范围有哪些限制?

    0.170.0 的语音更新限于终端通话协商能力的明确新增,同名工具服务器跨环境支持仍标注实验性质;连接部分则修复大请求回退、认证竞态和云端重连等具体问题。这份正式版公告不足以证明所有账户、所有客户端都已具备完整语音功能。

    Hy4 flash 三种权重怎么选,安装和授权要注意哪些条件?
    Hy4 flash 三种权重怎么选,安装和授权要注意哪些条件?

    了解Hy4 flash、FP8与base的适用任务,阅读官方安装及图文代码,并核对资源和MaaS许可条件。

    OpenAI Python SDK 3.55.0 升级看点:Live MCP 服务配置与预算接口变化
    OpenAI Python SDK 3.55.0 升级看点:Live MCP 服务配置与预算接口变化

    OpenAI Python SDK 3.55.0 升级看点:Live MCP 服务配置与预算接口变化。说明已核实的更新范围、类型兼容性和本地版本确认方法。

    OpenAI Java SDK 4.108.0 的两项新增能力适合哪些项目?
    OpenAI Java SDK 4.108.0 的两项新增能力适合哪些项目?

    OpenAI Java SDK 4.108.0 面向 Live MCP 工具接入与 Managed Agents 预算状态处理,说明新增模型、事件含义、正式发布范围和适用限制。

    Free Claude Code 6.19.37 如何兼顾网页搜索与普通工具调用?
    Free Claude Code 6.19.37 如何兼顾网页搜索与普通工具调用?

    Free Claude Code 6.19.37 在自动搜索时保留客户端工具及选择条件,代理执行搜索后仍返回普通调用。说明适用场景、历史信息保留、请求约束与第三方项目的版本边界。

    Google GenAI Go SDK 1.78.0 的 v1beta 配置优先级怎样判断?
    Google GenAI Go SDK 1.78.0 的 v1beta 配置优先级怎样判断?

    Google GenAI Go SDK 1.78.0 将 Gemini Developer API 默认改为 v1,可用 HTTPOptions.APIVersion 或环境变量保留 v1beta,Vertex AI 默认值不变。

    Google GenAI SDK 3.5.0实时交互值得哪些项目升级评估?
    Google GenAI SDK 3.5.0实时交互值得哪些项目升级评估?

    解释实验性实时支持、环境检查与生产评估中需要验证的条件。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。