n8n 中文文档

GitLab

GitLab 提供商将环境连接到 GitLab.com 或自管理 GitLab 实例上的仓库。它会列出你的仓库和分支,并支持基于合并请求的推广审查,你可以在 n8n 中以可视化方式审查这些合并请求。

提示

Preview status 预览状态

环境功能处于 Preview 阶段,未来版本中可能会发生变化。在为生产实例设置之前,请先在测试实例上试用。

GitLab 支持的功能

功能 是否支持
身份验证 访问令牌
从列表中选择仓库和分支 是
将每次推广推送到功能分支 是,并附带合并请求
推广审查 是:GitLab 合并请求同步到 n8n,并在 Reviews 审查 中提供更改的可视化差异

创建访问令牌

n8n 需要一个 GitLab 令牌。你可以创建经典访问令牌或细粒度个人访问令牌。无论选择哪种,令牌所属用户在仓库上至少需要 Developer 角色,因为 n8n 只会列出该用户拥有此角色的仓库。要将推广审查合并到受保护分支,该用户还需要拥有分支保护规则允许合并的角色,默认是 Maintainer。

经典访问令牌

创建一个具有 api 和 write_repository 范围的个人、群组或项目访问令牌。n8n 建议使用群组访问令牌,因为它不与可能离职的个人绑定。

细粒度个人访问令牌

如果你的 GitLab 版本支持细粒度个人访问令牌,可以使用它。

  1. 在 GitLab 中,开始创建一个新的细粒度个人访问令牌。请参阅 GitLab 文档中的细粒度个人访问令牌。
  2. 在 Group and project access 下,选择 Only specific groups or projects that I'm a member of,并添加仓库所在的项目或群组。
  3. 在 Add resource permissions 下,添加下表中的每个资源并选择其权限。令牌需要全部这些权限。在资源选择器中,每个资源都位于某个 Resource access 选项卡下的某个类别中。
  4. 选择 Generate token 并复制令牌。
Resource access 选项卡 类别 资源 权限 n8n 的用途
User System Access User Read 检查令牌
User Projects Project Read 列出仓库
Group and project Repository Branch Create, Read, Delete 列出分支、推送功能分支,并在合并后删除它们
Group and project Repository Code Download, Push 从仓库读取和向仓库推送
Group and project Repository Merge Request Create, Read, Approve, Merge 创建、批准和合并推广审查
Group and project Project Planning Work Item Create, Read 向合并请求添加批准备注,并读取其评论

设置 GitLab 提供商

  1. 在 Connect GitLab 连接 GitLab 对话框中,输入 Name 名称、GitLab base URL GitLab 基础 URL(例如 https://gitlab.com 或 https://gitlab.example.com)以及 Access token 访问令牌。
  2. 选择 Continue 继续。
  3. 在环境设置中,从列表中选择 Repository 仓库 和 Branch 分支。

对于位于内部网络中或使用私有证书颁发机构的自管理 GitLab 实例,请参阅基于 Git 的推广。

使用合并请求进行推广审查

要以合并请求的形式审查推广,请在你要推广到的环境上开启 Open a merge request in GitLab 在 GitLab 中创建合并请求。有关如何审查和批准,请参阅在 GitLab 中使用推广审查。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。