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

本文将指导你如何使用 docker 将 quarkus 应用部署到 Render.com。由于 Render.com 不像 Heroku 那样原生支持 Java，我们将利用 Docker 容器化 Quarkus 应用，并解决构建过程中可能出现的常见问题，确保应用成功部署。

前提条件

• 一个 Quarkus 应用，并且代码已经推送到 gitHub 仓库。
• 一个 Render.com 账户。

步骤

1. 修改 Dockerfile

Quarkus 提供的默认 Dockerfile 假设你已经编译了源代码。为了在 Docker 容器内部编译源代码，你需要修改 Dockerfile。参考 Quarkus 官方文档提供的多阶段 Docker 构建示例。一个可行的 Dockerfile 示例如下：

FROM registry.access.redhat.com/ubi8/openjdk-17:1.14 as builder WORKDIR /app COPY . . RUN ./mvnw package -DskipTests  FROM registry.access.redhat.com/ubi8/openjdk-17:1.14 ENV LANGUAGE='en_US:en' COPY --from=builder /app/target/quarkus-app/lib/ /deployments/lib/ COPY --from=builder /app/target/quarkus-app/*.jar /deployments/ COPY --from=builder /app/target/quarkus-app/app/ /deployments/app/ COPY --from=builder /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"

这个 Dockerfile 使用了多阶段构建。

• 第一阶段 (builder): 使用 maven 镜像，将源代码复制到容器中，并使用 ./mvnw package -DskipTests 命令编译 Quarkus 应用。skipTests 参数可以跳过测试，加快构建速度。
• 第二阶段: 从第一阶段复制编译好的文件到最终的镜像中，并设置环境变量和用户权限。

将这个 Dockerfile 放在你的项目目录中，例如 src/main/docker/Dockerfile.jvm。

2. .dockerignore 文件

确保你的 .dockerignore 文件正确配置。 尤其注意，需要移除 *， 否则会导致 target 目录也被忽略，导致 Docker 构建失败。一个典型的 .dockerignore 文件可能包含以下内容：

.mvn src/main/docker/*.sh target/

3. 在 Render.com 上创建项目

• 登录到你的 Render.com 账户。
• 创建一个新的 Web Service 项目。
• 连接你的 github 仓库。
• 在 “Build and Deploy” 设置中，指定 Dockerfile 的路径 (例如，./src/main/docker/Dockerfile.jvm)。

4. 部署应用

保存设置后，Render.com 将自动开始构建和部署你的 Quarkus 应用。

常见问题及解决方案

• 构建失败，提示找不到 target/quarkus-app 目录: 这是因为默认的 Dockerfile 假设你已经本地编译了代码。解决方法是在 Dockerfile 中添加编译步骤，如上文所示。
• 构建速度慢: 可以使用多阶段构建，并跳过测试来加快构建速度。

总结

通过 Docker 容器化 Quarkus 应用，你可以轻松地将其部署到 Render.com。记住要正确配置 Dockerfile 和 .dockerignore 文件，以避免构建失败。多阶段构建可以显著提高构建效率。