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:简化容器镜像的构建与推送流程。
  • 兼容 GitLab.com 及任何 自建 GitLab 实例。
  • 专属私有虚拟机,采用高速 NVMe/SSD 磁盘,确保构建过程稳定可靠。
  • 服务覆盖 🇪🇺 欧洲🇺🇸 美国 区域。

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

GitLab 提供了多个预定义变量(CI_REGISTRYCI_REGISTRY_USERCI_REGISTRY_PASSWORDCI_REGISTRY_IMAGE),使您的流水线无需额外密钥即可登录并将镜像推送到项目的容器镜像仓库。

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

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

如果您希望将镜像推送到其他镜像仓库(如 Docker Hub 或私有仓库),可以将相关凭据作为 CI/CD 变量 存储,并以类似方式通过 docker login 使用。