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 可隨時執行。
• 多任務並行執行：可同時運行多個任務，加速整體 pipeline 流程。
• 支援 Docker executor 及 Docker-in-Docker：簡化容器映像檔的建置與推送流程。
• 相容於 GitLab.com 及任何 自建 GitLab 實例。
• 專屬私人虛擬機（VM），採用高速 NVMe/SSD 磁碟，確保建置過程穩定可靠。
• 提供 🇪🇺 歐洲 與 🇺🇸 美國 區域選擇。

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

GitLab 提供多個預設變數（CI_REGISTRY、CI_REGISTRY_USER、CI_REGISTRY_PASSWORD、CI_REGISTRY_IMAGE），讓您的 pipeline 可以登入並將映像檔推送到專案的 container registry，無需額外設定機密。

以下是一個建置並推送映像檔的範例作業：

build-and-push:
  stage: build
  image: docker:27
  services:
    - docker:27-dind
  variables:
    DOCKER_TLS_CERTDIR: "/certs"
  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 使用。