GitLab: CI/CD

如何使用 GitLab CI/CD

👋 欢迎查阅 Stackhero 文档！

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

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

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

简介

GitLab CI/CD 是 GitLab 的一项强大且集成的功能。GitLab 是一个广泛使用的开源平台，专注于版本控制与协作。借助该工具，您可以自动化并优化软件构建、测试和部署的关键阶段，从而更快速、更可靠地交付高质量应用。

例如，使用 GitLab CI/CD，您可以配置自动化单元测试，每当有新的提交推送到 GitLab 仓库时自动触发。测试通过后，代码会被构建并部署到预发布（staging）环境以便进一步验证。所有预发布测试通过后，系统会将代码推广到生产环境，最终面向终端用户上线。

GitLab CI/CD 的一大亮点是其与 GitLab 平台的深度集成。您可以直接在项目仓库中定义和管理 CI/CD 流水线，极大简化了整个工作流的编排与追踪。

GitLab CI/CD 支持多种编程语言、框架和工具，能够灵活适配各种类型的项目。其可自定义的流水线系统允许您根据实际需求调整 CI/CD 流程的每个阶段，无论是构建、测试还是多环境部署。

总之，GitLab CI/CD 是一套全面的解决方案，旨在自动化并提升软件交付流程。它让开发者能够专注于代码编写与优化，而平台则高效地处理各类运维任务。

如何在 GitLab CI 中构建 Docker 镜像

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

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

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

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

步骤 2：配置 GitLab CI 流水线

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

image: docker:29

build:
  stage: build
  services:
    - name: docker:29-dind
      alias: docker
  variables:
    # 指定 docker CLI 通过非加密（非 TLS）端口连接 Docker-in-Docker 服务。
    # 详见下方关于 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 官方文档。

使用 Testcontainers 运行测试

如果您的测试套件使用了 Testcontainers，即在测试运行期间以临时 Docker 容器方式启动真实服务（如数据库、消息中间件等）的库，上述配置已完全适用。请保留 docker:29-dind 服务及两个变量：Testcontainers 依赖 DOCKER_HOST 访问 Docker 守护进程并连接其启动的容器，无需额外配置。

在 CI 环境中，未设置 DOCKER_HOST 是导致 Testcontainers 失败的最常见原因。此时库会回退到 runner 挂载的 Docker socket，无法访问自身启动的测试容器，通常表现为 Ryuk 辅助容器超时。