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

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

👋 欢迎查阅 Stackhero 文档!

Stackhero 提供了一套简单易用的 GitLab Runner 云端 解决方案,让您高效、无忧地运行 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 以同样方式使用。