Runner

Runner 是运行极狐GitLab Runner 应用程序的代理，用于在流水线中执行极狐GitLab CI/CD 作业。 它们负责运行您在 .gitlab-ci.yml 文件中定义的构建、测试、部署及其他 CI/CD 任务。

Runner 执行流程#

以下是 Runner 工作原理的基本流程：

1. Runner 必须先向极狐GitLab 注册， 这会在 Runner 与极狐GitLab 之间建立持久连接。
2. 当触发流水线时，极狐GitLab 会将这些作业提供给已注册的 Runner。
3. 匹配的 Runner 会领取作业，每个 Runner 一次领取一个作业，并执行该作业。
4. 结果会实时报告回极狐GitLab。

更多信息，请参见 Runner 执行流程。

Runner 作业调度与执行#

当需要执行 CI/CD 作业时，极狐GitLab 会根据 .gitlab-ci.yml 文件中定义的任务创建作业。这些作业会被放入队列。极狐GitLab 会检查符合以下条件的可用 Runner：

• Runner 标签。
• Runner 类型（如共享或群组）
• Runner 状态和容量
• 所需能力

被分配的 Runner 会收到作业详情。Runner 会准备环境，并按照 .gitlab-ci.yml 文件中的指定运行作业命令。

Runner 类别#

在决定使用哪些 Runner 执行 CI/CD 作业时，您可以选择：

• 极狐GitLab 托管的 Runner，适用于 JihuLab.com 用户。
• 私有化部署的 Runner，适用于所有极狐GitLab 安装实例。

Runner 可以是群组 Runner、项目 Runner 或实例 Runner。极狐GitLab 托管的 Runner 属于实例 Runner。

极狐GitLab 托管的 Runner#

极狐GitLab 托管的 Runner：

• 由极狐GitLab 全权管理。
• 无需设置即可立即使用。
• 每个作业都在全新的虚拟机上运行。
• 提供 Linux、Windows 和 macOS 选项。
• 根据需求自动扩缩。

在以下情况下，请选择极狐GitLab 托管的 Runner：

• 您希望实现零维护的 CI/CD。
• 您需要快速设置，无需管理基础设施。
• 您的作业需要在多次运行之间保持隔离。
• 您使用的是标准构建环境。
• 您使用的是 JihuLab.com。

私有化部署的 Runner#

私有化部署的 Runner：

• 由您安装和管理。
• 在您自己的基础设施上运行。
• 可根据您的需求进行自定义。
• 支持多种执行器（包括 Shell、Docker 和 Kubernetes）。
• 可以共享，也可以指定给特定项目或群组。

在以下情况下，请选择私有化部署的 Runner：

• 您需要自定义配置。
• 您希望在私有网络中运行作业。
• 您需要特定的安全控制。
• 您需要项目 Runner 或群组 Runner。
• 您需要通过复用 Runner 来优化速度。
• 您希望管理自己的基础设施。

Runner 类型#

Runner 根据访问需求提供以下类型：

• 实例 Runner：在整个极狐GitLab 实例范围内广泛可用。JihuLab.com 上的极狐GitLab 托管 Runner 属于实例 Runner，无需维护任何 Runner 基础设施。
• 群组 Runner：当同一群组中的多个项目共享一致的 Runner 池时使用。
• 项目 Runner：当项目需要专用配置、安全控制、凭证、专用硬件或隔离的 Runner 容量时使用。