GitLab: 如何在 GitLab CI 中构建 Docker 镜像

本文件是CI/CD指南的一部分。您可以在这里查看完整指南：如何使用 GitLab CI/CD。

👋 欢迎来到 Stackhero 文档！

Stackhero 提供即开即用的 GitLab cloud 解决方案，专为需要快速、安全且可扩展环境的团队设计：

• 无限用户、仓库、数据传输和 CI/CD 处理时间，灵活性完全不受限制。
• 一键轻松升级，让您的环境始终保持最新，无需停机。
• 自定义域名，通过HTTPS加密（例如 https://git.your-company.com），提升企业形象与安全性。
• 在您专属的私有、独立基础设施上，始终如一的性能与强大的安全性。无其他租户干扰，完全隔离。
• 可选择托管地点：🇪🇺 欧洲或🇺🇸 USA，满足您的合规或延迟需求。

快速上手，专注于您的代码。Stackhero 的 GitLab cloud hosting 解决方案大约5分钟即可投入使用。

如果您的项目仓库包含 Dockerfile 文件，您可以自动化 Docker 镜像的构建、运行，以及（如有需要）发布到镜像仓库的流程。

步骤 1：启用 Docker in Docker (DinD) 支持

首先，请在 Stackhero 控制台中启用 "Docker in Docker"（DinD）支持。

启用 DinD 支持会带来安全风险，尤其是在您希望隔离用户并防止他们访问彼此项目的场景下。

步骤 2：配置 GitLab CI pipeline

接下来，更新您的 gitlab-ci.yml 文件，添加使用 DinD 构建 Dockerfile 的 pipeline 配置。以下为示例配置：

image: docker:29

build:
  stage: build
  services:
    - name: docker:29-dind
      alias: docker
  variables:
    # 指定 docker CLI 连接到 Docker-in-Docker 服务，使用其明文（非 TLS）端口。
    # 详见下方关于 DOCKER_HOST 重要性的说明。
    DOCKER_HOST: "tcp://docker:2375"
    DOCKER_TLS_CERTDIR: ""
  before_script:
    - docker info
  script:
    # 请将 "my-docker-image" 替换为您期望的镜像名称：
    - docker build -t my-docker-image .
    # 如有需要，可测试该 Docker 镜像：
    # - docker run my-docker-image /script/to/run/tests

docker:29-dind 服务会在您的作业旁边启动一个 Docker 守护进程，而 DOCKER_HOST 则指定 docker CLI 使用该守护进程。声明 docker:dind 服务时务必设置 DOCKER_HOST： 如果省略该变量，CLI 会静默连接到其他守护进程，即使服务配置有误，构建也可能成功，从而掩盖真实问题。DOCKER_TLS_CERTDIR: "" 表示使用内部作业网络上的明文 2375 端口。

作为更简单的替代方案，您可以完全移除 services 块和上述两个变量：Stackhero 的 runner 已通过挂载的 socket 暴露了可用的 Docker 守护进程，因此直接执行 docker build 即可。

如需更多关于在 GitLab CI 中构建 Docker 镜像的指导，请参考 GitLab 官方文档。