GitLab Runner: 推送到 GitLab 容器镜像仓库

本文件是构建 Docker 镜像指南的一部分。您可以在这里查看完整指南:使用 Stackhero runner 和 Docker-in-Docker,从您的 GitLab CI/CD 流水线高效构建并推送 Docker 镜像

👋 欢迎来到 Stackhero 文档!

Stackhero 提供简单易用的 GitLab Runner cloud 解决方案,让您高效、无忧地运行 GitLab CI/CD 任务。您可以获得:

  • 无限制 CI/CD 构建时长:随时运行您的流水线,无需按分钟计费,也没有额外费用。
  • 多任务并发执行:支持同时运行多个任务,加快开发进度。
  • 支持 Docker executorDocker-in-Docker:轻松在 CI/CD 流程中构建和推送容器镜像。
  • GitLab.com自建 GitLab 实例无缝兼容。
  • 专属私有基础设施,配备高速 NVMe/SSD 存储,确保构建性能稳定可预期。
  • 服务覆盖 🇪🇺 欧洲🇺🇸 美国 区域,满足您团队的需求。

节省时间:您只需几分钟即可连接第一个 GitLab Runner,立即开始运行流水线!

GitLab 提供了预定义变量(CI_REGISTRYCI_REGISTRY_USERCI_REGISTRY_PASSWORDCI_REGISTRY_IMAGE),让您的流水线可以安全地认证并推送镜像到项目的容器仓库,无需额外密钥。

以下是一个构建并推送镜像的作业示例:

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

如需推送到其他镜像仓库(如 Docker Hub 或私有仓库),可将凭证存储为 CI/CD 变量,并同样通过 docker login 使用。