使用 Docker 部署 Quarkus 应用到 Render.com

碧海醫心

发布时间：2025-09-02 19:03:00

990人浏览过

来源于php中文网

原创

使用 docker 部署 quarkus 应用到 render.com

本文档旨在指导开发者如何使用 Docker 将 Quarkus 应用部署到 Render.com。由于 Render.com 并非原生支持 Java 应用，我们需要借助 Docker 容器化技术。本文将详细介绍如何配置 Dockerfile，解决构建过程中可能遇到的问题，并最终成功部署 Quarkus 应用。

准备工作

在开始之前，请确保您已经完成以下准备工作：

Quarkus 项目: 确保您已经创建了一个 Quarkus 项目，并且该项目已推送到 GitHub 仓库。
Render.com 账号: 注册一个 Render.com 账号。
Docker 基础知识: 了解 Dockerfile 的基本语法和 Docker 镜像构建过程。

修改 Dockerfile

Quarkus 提供的默认 Dockerfile 假定您已经预先编译了源代码。为了在 Docker 容器内部编译源代码，我们需要对 Dockerfile 进行修改。

以下是一个修改后的 Dockerfile 示例：

Websphere教程中文WORD版

本文档是Websphere教程；WebSphere 是因特网的基础架构软件，也就是我们所说的中间件。它使企业能够开发、部署和集成新一代电子商务应用（如 B2B 的电子交易），并且支持从简单的 Web 发布到企业级事务处理的商务应用。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看

下载

FROM registry.access.redhat.com/ubi8/openjdk-17:1.14
ENV LANGUAGE='en_US:en'

# 构建阶段
WORKDIR /app
COPY . .
RUN ./mvnw package -DskipTests

# 部署阶段
FROM registry.access.redhat.com/ubi8/openjdk-17:1.14
ENV LANGUAGE='en_US:en'
COPY --from=0 /app/target/quarkus-app/lib/ /deployments/lib/
COPY --from=0 /app/target/quarkus-app/*.jar /deployments/
COPY --from=0 /app/target/quarkus-app/app/ /deployments/app/
COPY --from=0 /app/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"

修改说明：

多阶段构建: 我们使用了 Docker 的多阶段构建特性。第一个 FROM 指令定义了构建阶段，负责编译 Quarkus 应用。第二个 FROM 指令定义了部署阶段，负责将编译好的文件复制到最终镜像中。
WORKDIR: 设置工作目录为 /app，方便后续操作。
复制源代码: COPY . . 将当前目录下的所有文件复制到容器的 /app 目录下。
编译应用: RUN ./mvnw package -DskipTests 命令在容器内部执行 Maven 命令，编译 Quarkus 应用。-DskipTests 参数用于跳过测试，加快构建速度。
复制编译结果: COPY --from=0 指令从第一个构建阶段复制文件到当前阶段。

修改 .dockerignore 文件

确保 .dockerignore 文件中没有排除 target 目录。如果存在类似于 * 的通配符，请将其删除或修改，以确保 target 目录及其内容能够被包含在 Docker 镜像中。

在 Render.com 上创建项目

登录 Render.com。
点击 "New Web Service"。
选择您的 GitHub 仓库。
在 "Build and Deploy" 页面，选择 "Docker" 环境。
指定 Dockerfile 的路径 (例如: ./src/main/docker/Dockerfile.jvm)。
配置其他必要的参数，例如实例类型和区域。
点击 "Create Web Service" 开始部署。

常见问题及解决方案

构建失败，提示找不到 target/quarkus-app 目录: 确保 Dockerfile 中包含编译步骤，并且 .dockerignore 文件没有排除 target 目录。
应用启动失败: 检查 JAVA_OPTS 环境变量是否正确设置，确保 Quarkus 应用能够监听正确的端口。
端口冲突: 确保 Quarkus 应用监听的端口与 Render.com 配置的端口一致 (默认为 8080)。