使用集群管理项目安装 GitLab Runner

假设您已经通过 管理项目模板 创建了项目，要安装 GitLab Runner，您应该 从 helmfile.yaml 文件中取消注释这一行：

  - path: applications/gitlab-runner/helmfile.yaml

GitLab Runner 默认安装到您集群的 gitlab-managed-apps 命名空间中。

必需变量

要让 GitLab Runner 正常工作，您必须在 applications/gitlab-runner/values.yaml.gotmpl 文件中指定以下内容：

• gitlabUrl: GitLab 服务器的完整 URL（例如 https://gitlab.example.com）， 用于注册 Runner。

• Runner 令牌：这必须从您的 GitLab 实例中获取。您可以使用 以下任一令牌：

  • runnerToken: 在 GitLab UI 中创建的 Runner 配置的 Runner 认证令牌。
  • runnerRegistrationToken（在 GitLab 15.6 中已弃用，并计划在 GitLab 20.0 中移除）：用于向 GitLab 添加新 Runner 的注册令牌。

这些值可以使用 CI/CD 变量 指定：

• CI_SERVER_URL 用于 gitlabUrl。如果您使用的是 GitLab.com，则无需设置此变量。
• GITLAB_RUNNER_TOKEN 用于 runnerToken。
• GITLAB_RUNNER_REGISTRATION_TOKEN 用于 runnerRegistrationToken（已弃用）。

指定这些值的方法是互斥的。您可以选择：

• 将变量 GITLAB_RUNNER_TOKEN 和 CI_SERVER_URL 指定为 CI 变量（推荐）。
• 在 applications/gitlab-runner/values.yaml.gotmpl 中为 runnerToken: 和 gitlabUrl: 提供值。

Runner 注册令牌允许 Runner 连接到项目，因此应将其视为秘密，以防止恶意使用和通过 Runner 进行代码泄露。因此，我们建议您将 Runner 注册令牌指定为受保护变量和屏蔽变量，并且不要将它们提交到 values.yaml.gotmpl 文件中的 Git 仓库。

您可以通过在集群管理项目中定义 applications/gitlab-runner/values.yaml.gotmpl 文件来自定义 GitLab Runner 的安装。 有关可用配置选项，请参阅 chart。