GitLab Runner: 构建 Docker 镜像
使用 Stackhero runner 和 Docker-in-Docker，从您的 GitLab CI/CD 流水线高效构建并推送 Docker 镜像
👋 欢迎来到 Stackhero 文档！
Stackhero 为您提供易于使用的 GitLab Runner cloud 解决方案，专为高效处理您的 GitLab CI/CD 任务而设计。您可以享受以下优势：
- 无限制 CI/CD 构建时长：没有按分钟计费，您的流水线可以随时运行。
- 多任务并发执行：可同时运行多个任务，加快整体流水线速度。
- 支持 Docker executor 及 Docker-in-Docker：简化容器镜像的构建与推送流程。
- 兼容 GitLab.com 以及任何 自建 GitLab 实例。
- 专属私有虚拟机（VM），采用高速 NVMe/SSD 磁盘，确保构建过程稳定可靠。
- 服务覆盖 🇪🇺 欧洲 和 🇺🇸 美国 区域。
节省时间：您只需几分钟即可连接第一个 GitLab Runner，立即开始运行流水线！
简介
通过 Stackhero GitLab Runner，每个作业都在全新的容器中运行，采用 Docker executor。只需启用 Docker-in-Docker（DinD），您就可以直接在流水线中构建自己的 Docker 镜像。这种配置会在您的作业旁边启动一个 Docker daemon，因此您可以在 CI/CD 流程中运行 docker build 和 docker push 命令。
每次运行都享有无限制的 CI/CD 分钟数：您可以根据需要随时构建，无需担心使用配额。您的构建缓存会存储在 runner 的专用磁盘上，这样重复构建时可以复用之前的镜像层，大幅缩短构建时间，让流水线更快完成。
使用 Docker-in-Docker 构建 Docker 镜像
您可以将以下示例 .gitlab-ci.yml 文件添加到您的代码仓库。此配置会构建项目根目录下的 Dockerfile：
build-image:
stage: build
image: docker:29
services:
- docker:29-dind
variables:
DOCKER_TLS_CERTDIR: "/certs"
before_script:
- docker info
script:
# 请将 "my-image" 替换为您想要的镜像名称：
- docker build -t my-image .
# 如有需要，可对构建好的镜像进行快速测试：
# - docker run --rm my-image /path/to/tests
本示例使用的是 Docker 镜像版本 29。您可以根据需要选择更新的版本。最新的标签可在 官方 Docker 镜像页面 查看。
在此配置中，docker:29-dind 服务会启动 Docker daemon。设置 DOCKER_TLS_CERTDIR: "/certs" 可在作业与 Docker daemon 之间启用安全的 TLS 连接。
推送到 GitLab 容器镜像仓库
GitLab 提供了预定义变量（CI_REGISTRY、CI_REGISTRY_USER、CI_REGISTRY_PASSWORD、CI_REGISTRY_IMAGE），让您的流水线可以安全地认证并将镜像推送到项目的容器镜像仓库，无需额外配置密钥。
以下是一个构建并推送镜像的作业示例：
build-and-push:
stage: build
image: docker:29
services:
- docker:29-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 以相同方式使用。
加速重复构建
您的 runner 磁盘会在流水线之间保留，因此可以复用镜像层作为构建缓存，从而大幅提升重复构建的速度。以下是一个配置示例：
build-cached:
stage: build
image: docker:29
services:
- docker:29-dind
variables:
DOCKER_TLS_CERTDIR: "/certs"
before_script:
- docker login -u "$CI_REGISTRY_USER" -p "$CI_REGISTRY_PASSWORD" "$CI_REGISTRY"
script:
# 拉取最新镜像以初始化缓存（如存在）：
- docker pull "$CI_REGISTRY_IMAGE:latest" || true
- docker build --cache-from "$CI_REGISTRY_IMAGE:latest" -t "$CI_REGISTRY_IMAGE:latest" .
- docker push "$CI_REGISTRY_IMAGE:latest"
这种方式可以让您的构建充分利用 Docker 的镜像层缓存，仅重建新增或变更的层。
并行运行作业
您的套餐决定了可以同时运行多少个作业。同一阶段的作业会一起启动，最多可达您的并发上限。这样，多个独立作业可以并行执行，只需等待最慢的作业完成，无需依次等待。
示例：
stages:
- test
unit:
stage: test
image: node:22
script: npm run test:unit
integration:
stage: test
image: node:22
script: npm run test:integration
e2e:
stage: test
image: node:22
script: npm run test:e2e
如果您的并发设置为 1 或更高，unit、integration 和 e2e 这三个作业会同时运行。
如需了解更多关于在 GitLab CI/CD 流水线中构建 Docker 镜像的信息，请参考 官方 GitLab Docker 构建文档。