GitLab Runner: 入门指南

将您的 Stackhero GitLab Runner 连接到 GitLab.com、Stackhero for GitLab 或您自己的 GitLab 服务器，并在几分钟内运行您的第一个流水线

👋 欢迎来到 Stackhero 文档！

Stackhero 提供简单易用的 GitLab Runner cloud 解决方案，让您高效、无忧地运行 GitLab CI/CD 任务。您可以获得：

• 无限制 CI/CD 构建时长：随时运行您的流水线，无需按分钟计费，也没有额外费用。
• 多任务并发执行：支持同时运行多个任务，加快开发进度。
• 支持 Docker executor 及 Docker-in-Docker：轻松在 CI/CD 流程中构建和推送容器镜像。
• 与 GitLab.com 及 自建 GitLab 实例无缝兼容。
• 专属私有基础设施，配备高速 NVMe/SSD 存储，确保构建性能稳定可预期。
• 服务覆盖 🇪🇺 欧洲 和 🇺🇸 美国 区域，满足您团队的需求。

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

简介

GitLab Runner 是执行您 GitLab CI/CD 任务的代理。每当流水线运行时，Runner 会获取每个任务，在隔离的 Docker 容器中执行，并将结果反馈给 GitLab。

通过 Stackhero，您的 Runner 始终运行在专属的私有基础设施上。没有按分钟计费或使用配额限制：您的 CI/CD 分钟数无限制。根据您的套餐，Runner 可以同时处理多个并发任务，让构建吞吐量的扩展变得简单直接。

本指南将帮助您将 Stackhero Runner 连接到 GitLab，并快速运行您的第一个流水线。

步骤 1：在 Stackhero 上创建 GitLab Runner

在您的 Stackhero 控制台，您可以创建一个新的 GitLab Runner 服务，并选择适合您工作流的套餐。套餐决定了可用的 CPU、RAM 资源以及并发任务数（对应 GitLab Runner 的 concurrent 设置：Runner 可并行处理的任务数量）。

您的 Runner 大约 2 分钟即可准备就绪。

步骤 2：在 GitLab 中创建 Runner

您的 Runner 通过Runner 认证令牌连接到 GitLab。您需要在 GitLab 中生成该令牌，并选择 Runner 的作用范围：

• 项目级 Runner：打开您的项目，然后进入 Settings > CI/CD > Runners > New project runner。
• 组级 Runner：打开您的组，然后进入 Settings > CI/CD > Runners > New group runner。
• 实例级 Runner（仅适用于自建 GitLab）：进入 Admin area > CI/CD > Runners > New instance runner。

创建 Runner 时，您可以：

• 添加标签（如 docker 或 stackhero），以便在任务中指定使用该 Runner。
• 允许其运行无标签任务，如果您希望它处理所有任务（包括没有标签的任务）。

GitLab 会提供一个以 glrt- 开头的Runner 认证令牌。请妥善保管此令牌，因为 Runner 需要用它与 GitLab 进行身份验证。

之前的 registration token 注册方式已被弃用。请使用上述添加 Runner 时生成的Runner 认证令牌（glrt-...）。

更多详情请参阅 官方 GitLab Runner 注册文档。

步骤 3：连接您的 Runner

返回您的 Stackhero 控制台，打开 GitLab Runner 服务配置，并填写以下信息：

• GitLab URL：对于 GitLab.com，请使用 https://gitlab.com，或填写您的自建 GitLab 实例的 URL。（如果您在 Stackhero 上运行 GitLab，可能是 https://git.your-company.com。）
• 在步骤 2 获得的Runner 认证令牌（glrt-...）。
• 您希望允许的并发任务数。

保存配置后，您的 Runner 会连接到 GitLab，并在您设置的 Runners 页面显示为在线。

步骤 4：运行您的第一个流水线

在您的代码仓库根目录下添加 .gitlab-ci.yml 文件，定义流水线内容：

stages:
  - build
  - test

build:
  stage: build
  image: node:22
  script:
    - npm ci
    - npm run build

test:
  stage: test
  image: node:22
  script:
    - npm test

提交并推送您的更改。GitLab 会触发流水线，您的 Stackhero Runner 会执行这些任务。如果您在创建 Runner 时添加了标签，可以在任务中这样指定：

build:
  stage: build
  tags:
    - stackhero
  image: node:22
  script:
    - npm ci
    - npm run build

您的流水线现在将在专属 Runner 上运行，构建分钟数无限制，无需担心使用配额。

下一步

如果您希望在流水线中构建并推送 Docker 镜像，请继续阅读 构建 Docker 镜像。