GitLab Runner: 使用 Testcontainers 執行測試

本文件是建立 Docker 映像檔指南的一部分。請在此處查看完整指南：使用 Stackhero runner 與 Docker-in-Docker，從您的 GitLab CI/CD pipeline 高效建置與推送 Docker 映像檔。

👋 歡迎來到 Stackhero 文件中心！

Stackhero 提供簡單易用的 GitLab Runner 雲端 解決方案，讓您高效且無煩惱地執行 GitLab CI/CD 任務。您可以期待以下功能：

• 無限 CI/CD 時數：隨時運行您的 pipeline，無需擔心按分鐘計費或額外費用。
• 多個任務同時執行：可同時平行運行多個任務，加速您的開發流程。
• 支援 Docker executor 及 Docker-in-Docker：輕鬆在 CI/CD 流程中建置並推送容器映像檔。
• 完美支援 GitLab.com 及 自建 GitLab 實例。
• 專屬私有基礎架構，搭配高速 NVMe/SSD 儲存，確保建置效能穩定且可預期。
• 提供 🇪🇺 歐洲 與 🇺🇸 美國 區域，滿足您團隊的需求。

節省時間：您只需幾分鐘即可連接第一個 GitLab Runner，立即開始運行 pipeline！

Testcontainers 是一個測試函式庫，支援 Java、Go、Node.js、Python、.NET 等語言，可在測試期間以臨時 Docker 容器啟動真實服務。與其模擬資料庫或訊息代理，您的整合測試將直接連接到真正的 PostgreSQL、MySQL、Redis 或 Kafka 實例，測試前建立，測試後自動移除。這在 Java 與 Spring 專案中特別受歡迎。

Testcontainers 需要 Docker daemon，因此與上述 Docker-in-Docker 設定完全相同，無需額外變數：

test:
  stage: test
  # 請使用測試所需的映像檔（此處為 JDK），不一定要用 docker image：
  image: gradle:jdk21
  services:
    - name: docker:29-dind
      alias: docker
  variables:
    DOCKER_HOST: "tcp://docker:2375"
    DOCKER_TLS_CERTDIR: ""
  script:
    - gradle test

Testcontainers 會讀取 DOCKER_HOST 以尋找 daemon，並重複利用同一個 docker 主機名稱來存取其啟動容器所開放的 port。兩者都能正常運作，因為 docker 別名會在作業網路中解析。

請在 Testcontainers 作業中保留 DOCKER_HOST。若未設定，Testcontainers 會退回 runner 掛載的 Docker socket，接著嘗試連線到主機 IP 上的測試容器，但作業無法連線。常見症狀為 Ryuk 輔助容器出現 Wait strategy failed. Container is removed 或 Timed out waiting for log output matching '.*Started.*'。