GitLab Runner: 使用 Docker-in-Docker 建構 Docker 映像檔

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

👋 歡迎瀏覽 Stackhero 文件！

Stackhero 提供簡單易用的 GitLab Runner cloud 方案，讓您高效且輕鬆地執行 GitLab CI/CD 任務。您可以享有以下優勢：

• 無限 CI/CD 分鐘數：隨時隨地運行 pipeline，無需按分鐘計費，亦無額外收費。
• 多個並行任務：可同時運行多個 job，加快開發流程。
• 支援 Docker executor 及 Docker-in-Docker：輕鬆於 CI/CD 流程中建構及推送 container image。
• 完美兼容 GitLab.com 及 自建 GitLab 實例。
• 專屬私人基礎設施，配備高速 NVMe/SSD 儲存，確保建構效能穩定且可預測。
• 服務覆蓋 🇪🇺 歐洲 及 🇺🇸 美國 地區，靈活配合您的團隊需求。

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

您可以將以下範例 .gitlab-ci.yml 加入您的 repository。這個設定會建構專案根目錄下的 Dockerfile：

build-image:
  stage: build
  image: docker:29
  services:
    - name: docker:29-dind
      alias: docker
  variables:
    DOCKER_HOST: "tcp://docker:2375"
    DOCKER_TLS_CERTDIR: ""
  before_script:
    - docker info
  script:
    # 請將 "my-image" 替換為您想要的名稱：
    - docker build -t my-image .
    # 如有需要，可對建構好的映像檔進行快速測試：
    # - docker run --rm my-image /path/to/tests

本範例使用 Docker image 版本 29。您可以根據需要選用更新的版本。最新的 tag 可參考 官方 Docker image 頁面。

在這個設定中，docker:29-dind 服務會在您的 job 旁啟動一個 Docker daemon，而 DOCKER_HOST: "tcp://docker:2375" 則告訴 docker CLI 使用這個 daemon。當您宣告 docker:dind 服務時，務必設定 DOCKER_HOST： 否則 CLI 會默默連接到其他 daemon，導致即使服務設定錯誤，build 也可能通過，這會隱藏真正的問題（並導致像 Testcontainers 這類依賴該服務的工具失效）。DOCKER_TLS_CERTDIR: "" 代表透過內部 job 網絡上的非 TLS 2375 port 連線。

如果想要更簡單的方式，您可以省略 services 區塊及上述兩個變數：Stackhero 的 runner 也會透過掛載的 socket 提供一個可用的 Docker daemon，因此只需執行 docker build，無需額外設定。