使用 Go test 运行测试

前提条件

完成本指南的构建你的 Go 镜像部分。

概述

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

对于本节,请使用你在构建你的 Go 镜像中克隆的 docker-gs-ping 项目。

在构建时运行测试

要在构建时运行测试,你需要将测试阶段添加到 Dockerfile.multistage 中。示例应用程序仓库中的 Dockerfile.multistage 已经包含以下内容

# syntax=docker/dockerfile:1

# Build the application from source
FROM golang:1.19 AS build-stage

WORKDIR /app

COPY go.mod go.sum ./
RUN go mod download

COPY *.go ./

RUN CGO_ENABLED=0 GOOS=linux go build -o /docker-gs-ping

# Run the tests in the container
FROM build-stage AS run-test-stage
RUN go test -v ./...

# Deploy the application binary into a lean image
FROM gcr.io/distroless/base-debian11 AS build-release-stage

WORKDIR /

COPY --from=build-stage /docker-gs-ping /docker-gs-ping

EXPOSE 8080

USER nonroot:nonroot

ENTRYPOINT ["/docker-gs-ping"]

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

$ docker build -f Dockerfile.multistage -t docker-gs-ping-test --progress plain --no-cache --target run-test-stage .

你应该会看到包含以下内容的输出。

#13 [run-test-stage 1/1] RUN go test -v ./...
#13 4.915 === RUN   TestIntMinBasic
#13 4.915 --- PASS: TestIntMinBasic (0.00s)
#13 4.915 === RUN   TestIntMinTableDriven
#13 4.915 === RUN   TestIntMinTableDriven/0,1
#13 4.915 === RUN   TestIntMinTableDriven/1,0
#13 4.915 === RUN   TestIntMinTableDriven/2,-2
#13 4.915 === RUN   TestIntMinTableDriven/0,-1
#13 4.915 === RUN   TestIntMinTableDriven/-1,0
#13 4.915 --- PASS: TestIntMinTableDriven (0.00s)
#13 4.915     --- PASS: TestIntMinTableDriven/0,1 (0.00s)
#13 4.915     --- PASS: TestIntMinTableDriven/1,0 (0.00s)
#13 4.915     --- PASS: TestIntMinTableDriven/2,-2 (0.00s)
#13 4.915     --- PASS: TestIntMinTableDriven/0,-1 (0.00s)
#13 4.915     --- PASS: TestIntMinTableDriven/-1,0 (0.00s)
#13 4.915 PASS

下一步

在本节中,你学习了如何在构建镜像时运行测试。接下来,你将学习如何使用 GitHub Actions 设置 CI/CD 流水线。

页面选项