GitLab Runner: 入门指南

将您的 Stackhero GitLab Runner 连接到 GitLab.com 或自建 GitLab，并运行您的第一个流水线

👋 欢迎来到 Stackhero 文档！

Stackhero 为您提供易于使用的 GitLab Runner cloud 解决方案，专为高效处理您的 GitLab CI/CD 任务而设计。您可以享受以下优势：

• 无限制 CI/CD 构建时长：没有按分钟计费，您的流水线可以随时运行。
• 多任务并发执行：可同时运行多个任务，加快整体流水线速度。
• 支持 Docker executor 及 Docker-in-Docker：简化容器镜像的构建与推送流程。
• 兼容 GitLab.com 以及任何 自建 GitLab 实例。
• 专属私有虚拟机（VM），采用高速 NVMe/SSD 磁盘，确保构建过程稳定可靠。
• 服务覆盖 🇪🇺 欧洲 和 🇺🇸 美国 区域。

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

简介

GitLab Runner 是负责执行您 GitLab CI/CD 任务的代理。每当流水线被触发时，Runner 会接收每个任务，在全新的 Docker 容器中执行，然后将结果反馈给 GitLab。

在 Stackhero 上，您的 Runner 运行在专属的私有虚拟机（VM）上。没有按分钟计费或使用配额，您的 CI/CD 分钟数无限制。根据您的套餐，Runner 可同时处理数十个并发任务。

本指南将带您在几分钟内完成 Stackhero Runner 与 GitLab 的连接。

步骤 1：在 Stackhero 上创建 GitLab Runner

在您的 Stackhero 控制台，您可以创建新的 GitLab Runner 服务，并选择适合您需求的套餐。套餐决定了可用的 CPU、RAM 以及并发任务数（对应 GitLab Runner 的 concurrent 设置，即可同时运行的任务数量）。

您的 Runner 大约 2 分钟即可启动并运行。

步骤 2：在 GitLab 中创建 Runner

您的 Runner 通过Runner 认证令牌连接到 GitLab。您将在 GitLab 中生成此令牌，并决定 Runner 的作用范围：

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

创建 Runner 时，您可以：

• 添加标签（如 docker 或 stackhero），方便在任务中指定此 Runner。
• 如果希望 Runner 执行所有任务，可以允许其运行无标签任务。

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

旧的 registration token 注册流程已废弃。请使用如上所述与 Runner 一同创建的Runner 认证令牌（glrt-...）。

步骤 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，并在您创建 Runner 的 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 镜像。