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

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

准备工作

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

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

修改 Dockerfile

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

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

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 上创建项目

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

常见问题及解决方案

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

总结

通过本文档，您应该能够成功地使用 Docker 将 Quarkus 应用部署到 Render.com。关键在于正确配置 Dockerfile，确保在容器内部编译源代码，并注意 .dockerignore 文件的设置。希望本教程能帮助您顺利完成部署。