GitLab Runner: 推送映像檔到 GitLab container registry

此文件屬於建立 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_REGISTRY、CI_REGISTRY_USER、CI_REGISTRY_PASSWORD、CI_REGISTRY_IMAGE），讓您的 pipeline 可以安全地驗證並推送映像檔到專案的 container registry，無需額外設定機密。

以下是一個建構並推送映像檔的 job 範例：

build-and-push:
  stage: build
  image: docker:29
  services:
    - name: docker:29-dind
      alias: docker
  variables:
    DOCKER_HOST: "tcp://docker:2375"
    DOCKER_TLS_CERTDIR: ""
  before_script:
    - docker login -u "$CI_REGISTRY_USER" -p "$CI_REGISTRY_PASSWORD" "$CI_REGISTRY"
  script:
    - docker build -t "$CI_REGISTRY_IMAGE:$CI_COMMIT_SHORT_SHA" .
    - docker push "$CI_REGISTRY_IMAGE:$CI_COMMIT_SHORT_SHA"
    # 如果您在預設分支，也可以標記並推送 "latest"：
    - |
      if [ "$CI_COMMIT_BRANCH" = "$CI_DEFAULT_BRANCH" ]; then
        docker tag "$CI_REGISTRY_IMAGE:$CI_COMMIT_SHORT_SHA" "$CI_REGISTRY_IMAGE:latest"
        docker push "$CI_REGISTRY_IMAGE:latest"
      fi

如需推送映像檔到其他 registry（如 Docker Hub 或私有 registry），您可以將認證資訊儲存為 CI/CD 變數，並用相同方式搭配 docker login 使用。