在容器中執行 Node.js 測試

目錄

先決條件

完成本指南的所有先前章節，從 將 Node.js 應用程式容器化 開始。

概觀

測試是現代軟體開發的重要環節。測試對不同的開發團隊來說可能意味著很多事情。有單元測試、整合測試和端到端測試。在本指南中，您將了解在開發和建置時在 Docker 中執行單元測試。

在本地開發時執行測試

範例應用程式已經具有用於執行測試的 Jest 套件，並且在 spec 目錄中包含測試。在本地開發時，您可以使用 Compose 來執行測試。

執行以下命令以從容器內的 package.json 檔案執行測試腳本。

$ docker compose run server npm run test

要深入了解該命令，請參閱 docker compose run。

您應該會看到如下輸出。

> docker-nodejs@1.0.0 test
> jest

 PASS  spec/routes/deleteItem.spec.js
 PASS  spec/routes/getItems.spec.js
 PASS  spec/routes/addItem.spec.js
 PASS  spec/routes/updateItem.spec.js
 PASS  spec/persistence/sqlite.spec.js
  ● Console

    console.log
      Using sqlite database at /tmp/todo.db

      at Database.log (src/persistence/sqlite.js:18:25)

    console.log
      Using sqlite database at /tmp/todo.db

      at Database.log (src/persistence/sqlite.js:18:25)

    console.log
      Using sqlite database at /tmp/todo.db

      at Database.log (src/persistence/sqlite.js:18:25)

    console.log
      Using sqlite database at /tmp/todo.db

      at Database.log (src/persistence/sqlite.js:18:25)

    console.log
      Using sqlite database at /tmp/todo.db

      at Database.log (src/persistence/sqlite.js:18:25)


Test Suites: 5 passed, 5 total
Tests:       9 passed, 9 total
Snapshots:   0 total
Time:        2.008 s
Ran all test suites.

建置時執行測試

要在建置時執行測試，您需要更新 Dockerfile 以新增新的測試階段。

以下是更新後的 Dockerfile。

# syntax=docker/dockerfile:1

ARG NODE_VERSION=18.0.0

FROM node:${NODE_VERSION}-alpine as base
WORKDIR /usr/src/app
EXPOSE 3000

FROM base as dev
RUN --mount=type=bind,source=package.json,target=package.json \
    --mount=type=bind,source=package-lock.json,target=package-lock.json \
    --mount=type=cache,target=/root/.npm \
    npm ci --include=dev
USER node
COPY . .
CMD npm run dev

FROM base as prod
RUN --mount=type=bind,source=package.json,target=package.json \
    --mount=type=bind,source=package-lock.json,target=package-lock.json \
    --mount=type=cache,target=/root/.npm \
    npm ci --omit=dev
USER node
COPY . .
CMD node src/index.js

FROM base as test
ENV NODE_ENV test
RUN --mount=type=bind,source=package.json,target=package.json \
    --mount=type=bind,source=package-lock.json,target=package-lock.json \
    --mount=type=cache,target=/root/.npm \
    npm ci --include=dev
USER node
COPY . .
RUN npm run test

在測試階段中使用 RUN 來執行測試，而不是使用 CMD。原因是 CMD 指令在容器執行時執行，而 RUN 指令在映像建置時執行，如果測試失敗，建置將會失敗。

執行以下命令，使用測試階段作為目標來建置新的映像，並檢視測試結果。包含 --progress=plain 以檢視建置輸出，--no-cache 以確保始終執行測試，以及 --target test 以鎖定測試階段。

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

您應該會看到包含以下內容的輸出。

...

#11 [test 3/3] RUN npm run test
#11 1.058
#11 1.058 > docker-nodejs@1.0.0 test
#11 1.058 > jest
#11 1.058
#11 3.765 PASS spec/routes/getItems.spec.js
#11 3.767 PASS spec/routes/deleteItem.spec.js
#11 3.783 PASS spec/routes/updateItem.spec.js
#11 3.806 PASS spec/routes/addItem.spec.js
#11 4.179 PASS spec/persistence/sqlite.spec.js
#11 4.207
#11 4.208 Test Suites: 5 passed, 5 total
#11 4.208 Tests:       9 passed, 9 total
#11 4.208 Snapshots:   0 total
#11 4.208 Time:        2.168 s
#11 4.208 Ran all test suites.
#11 4.265 npm notice
#11 4.265 npm notice New major version of npm available! 8.6.0 -> 9.8.1
#11 4.265 npm notice Changelog: <https://github.com/npm/cli/releases/tag/v9.8.1>
#11 4.265 npm notice Run `npm install -g npm@9.8.1` to update!
#11 4.266 npm notice
#11 DONE 4.3s

...

摘要

在本節中，您學習了如何在本地開發時使用 Compose 執行測試，以及如何在建置映像時執行測試。

相關資訊

後續步驟

接下來，您將學習如何使用 GitHub Actions 設定 CI/CD 流程。

為您的 Node.js 應用程式設定 CI/CD »