GitLab Runner: 构建 Docker 镜像
使用 Stackhero runner 和 Docker-in-Docker，从您的 GitLab CI/CD 流水线高效构建并推送 Docker 镜像
👋 欢迎查阅 Stackhero 文档！
Stackhero 为您提供易于使用的 GitLab Runner 云端 解决方案，专为高效处理您的 GitLab CI/CD 任务而设计。您将获得以下优势：
- 无限制 CI/CD 构建时长：不按分钟计费，您的流水线可随时运行。
- 多任务并发执行：可同时运行多个任务，加快整体流水线速度。
- 支持 Docker executor 及 Docker-in-Docker：简化容器镜像的构建与推送流程。
- 兼容 GitLab.com 及任何 自建 GitLab 实例。
- 专属私有虚拟机，采用高速 NVMe/SSD 磁盘，确保构建过程稳定可靠。
- 服务覆盖 🇪🇺 欧洲 和 🇺🇸 美国 区域。
节省时间：您只需几分钟即可连接第一个 GitLab Runner，立即开始运行流水线！
介绍
通过 Stackhero GitLab Runner，每个作业都在一个全新的容器中运行，使用的是 Docker executor。只需启用 Docker-in-Docker（DinD），您就可以在流水线中直接构建自己的 Docker 镜像。该配置会在您的作业旁边启动一个 Docker 守护进程，因此您可以在 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 守护进程。设置 DOCKER_TLS_CERTDIR: "/certs" 可在作业与 Docker 守护进程之间启用安全的 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 构建文档。