运行您的 Java 测试

先决条件

完成本指南的所有前面章节,从容器化 Java 应用程序开始。

概述

测试是现代软件开发的重要组成部分。对于不同的开发团队,测试可能意味着许多不同的事情。包括单元测试、集成测试和端到端测试。在本指南中,您将了解如何在 Docker 中运行单元测试。

用于测试的多阶段 Dockerfile

在以下示例中,您将把测试命令拉入您的 Dockerfile 中。请将您的 Dockerfile 内容替换为以下内容。

# syntax=docker/dockerfile:1

FROM eclipse-temurin:21-jdk-jammy as base
WORKDIR /build
COPY --chmod=0755 mvnw mvnw
COPY .mvn/ .mvn/

FROM base as test
WORKDIR /build
COPY ./src src/
RUN --mount=type=bind,source=pom.xml,target=pom.xml \
    --mount=type=cache,target=/root/.m2 \
    ./mvnw test

FROM base as deps
WORKDIR /build
RUN --mount=type=bind,source=pom.xml,target=pom.xml \
    --mount=type=cache,target=/root/.m2 \
    ./mvnw dependency:go-offline -DskipTests

FROM deps as package
WORKDIR /build
COPY ./src src/
RUN --mount=type=bind,source=pom.xml,target=pom.xml \
    --mount=type=cache,target=/root/.m2 \
    ./mvnw package -DskipTests && \
    mv target/$(./mvnw help:evaluate -Dexpression=project.artifactId -q -DforceStdout)-$(./mvnw help:evaluate -Dexpression=project.version -q -DforceStdout).jar target/app.jar

FROM package as extract
WORKDIR /build
RUN java -Djarmode=layertools -jar target/app.jar extract --destination target/extracted

FROM extract as development
WORKDIR /build
RUN cp -r /build/target/extracted/dependencies/. ./
RUN cp -r /build/target/extracted/spring-boot-loader/. ./
RUN cp -r /build/target/extracted/snapshot-dependencies/. ./
RUN cp -r /build/target/extracted/application/. ./
ENV JAVA_TOOL_OPTIONS="-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:8000"
CMD [ "java", "-Dspring.profiles.active=postgres", "org.springframework.boot.loader.launch.JarLauncher" ]

FROM eclipse-temurin:21-jre-jammy AS final
ARG UID=10001
RUN adduser \
    --disabled-password \
    --gecos "" \
    --home "/nonexistent" \
    --shell "/sbin/nologin" \
    --no-create-home \
    --uid "${UID}" \
    appuser
USER appuser
COPY --from=extract build/target/extracted/dependencies/ ./
COPY --from=extract build/target/extracted/spring-boot-loader/ ./
COPY --from=extract build/target/extracted/snapshot-dependencies/ ./
COPY --from=extract build/target/extracted/application/ ./
EXPOSE 8080
ENTRYPOINT [ "java", "-Dspring.profiles.active=postgres", "org.springframework.boot.loader.launch.JarLauncher" ]

首先,您添加了一个新的基础阶段(base stage)。在基础阶段中,您添加了测试阶段(test stage)和依赖阶段(deps stage)都需要用到的通用指令。

接下来,您添加了一个新的测试阶段(test stage),它基于基础阶段(base stage)并标记为 test。在此阶段中,您复制了必要的源文件,然后指定 RUN 来运行 ./mvnw test。您使用了 RUN 指令而不是 CMD 来运行测试。原因是 CMD 指令在容器运行时执行,而 RUN 指令在镜像构建时执行。使用 RUN 时,如果测试失败,构建也会失败。

最后,您更新了依赖阶段(deps stage),使其基于基础阶段(base stage),并删除了现在已包含在基础阶段中的指令。

运行以下命令,使用测试阶段(test stage)作为目标来构建新镜像并查看测试结果。包含 --progress=plain 以查看构建输出,--no-cache 以确保测试总是运行,以及 --target test 以指定测试阶段。

现在,构建您的镜像并运行测试。您将运行 docker build 命令并添加 --target test 标志,以便专门运行测试构建阶段。

$ docker build -t java-docker-image-test --progress=plain --no-cache --target=test .

您应该看到包含以下内容的输出

...

#15 101.3 [WARNING] Tests run: 45, Failures: 0, Errors: 0, Skipped: 2
#15 101.3 [INFO]
#15 101.3 [INFO] ------------------------------------------------------------------------
#15 101.3 [INFO] BUILD SUCCESS
#15 101.3 [INFO] ------------------------------------------------------------------------
#15 101.3 [INFO] Total time:  01:39 min
#15 101.3 [INFO] Finished at: 2024-02-01T23:24:48Z
#15 101.3 [INFO] ------------------------------------------------------------------------
#15 DONE 101.4s

下一步

在下一节中,您将了解如何使用 GitHub Actions 设置 CI/CD 流水线。

页面选项