Help us learn about your current experience with the documentation. Take the survey.

如何在开发环境中运行 Jenkins（在 macOS 上）

这是一份分步指南，介绍如何在你的本地机器上设置 Jenkins 并从你的 GitLab 实例连接到它。GitLab 会触发 Jenkins 的 webhooks，而 Jenkins 则使用 API 连接到 GitLab。通过在同一台机器上运行这两个应用程序，我们可以确保它们能够相互访问。

有关配置现有 Jenkins 集成的信息，请阅读 Jenkins CI 服务。

安装 Jenkins

使用 Homebrew 安装 Jenkins 并启动服务。

brew install jenkins
brew services start jenkins

配置 GitLab

默认情况下，GitLab 不允许向 localhost 或本地网络发送请求。当在你的本地机器上运行 Jenkins 时，你需要启用本地访问。

  1. 以管理员身份登录你的 GitLab 实例。

  2. 在左侧边栏底部，选择 管理员。

  3. 选择 设置 > 网络。

  4. 展开 出站请求，并勾选以下复选框：

    • 允许来自 webhooks 和集成的本地网络请求
    • 允许来自 system hooks 的本地网络请求

有关 GitLab webhooks 的更多详细信息，请参阅 Webhooks 和不安全的内部 Web 服务。

Jenkins 使用 GitLab API，需要一个访问令牌。

  1. 登录你的 GitLab 实例。
  2. 选择你的个人资料图片，然后选择 设置。
  3. 选择 访问令牌。
  4. 创建一个新的访问令牌，启用 API 范围。请记下该令牌的值。

配置 Jenkins

要在 Jenkins 中配置你的 GitLab API 连接，请阅读 配置 Jenkins 服务器。

配置 Jenkins 项目

要设置你打算运行构建的 Jenkins 项目，请阅读 配置 Jenkins 项目。

配置你的 GitLab 项目

你可以配置 Jenkins 和 GitLab 之间的集成：

测试你的设置

在你的仓库中做一个更改并打开一个合并请求（MR）。在你的 Jenkins 项目中，应该已经触发了一次新的构建，而在你的 MR 上，应该有一个显示 流水线 #NUMBER 已通过 的小组件。 它还应包含指向你的 Jenkins 构建的链接。