使用 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 文件，以避免构建失败。多阶段构建可以显著提高构建效率。