n8n 中文文档

基于 Git 的推广

使用基于 Git 的推广时,更改通过 Git 仓库在 n8n 实例之间传递。每个环境就是一个仓库和分支。

提示

Preview status 预览状态

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

n8n 向仓库写入什么

n8n 将推广的内容存储在仓库根目录的 n8n/ 文件夹中。该文件夹包含一个 n8n 包。n8n 在你推广时导出它,在你应用时导入它。n8n 不会更改该文件夹之外的任何内容,因此仓库中可以存放其他文件,例如 CI 配置。

直接提交和功能分支

根据其设置,实例推广更改到的环境会采用以下方式之一:

  • 直接提交到其分支。
  • 将每次推广推送到一个基于其分支、名为 n8n-promotion/<timestamp> 的功能分支。n8n 绝不会强制推送。使用功能分支时,环境的分支必须已存在于 Git 托管平台上。

从该环境应用的实例会读取其分支,因此只有在有人合并功能分支之后,它们才能看到其中的更改。

提供商

提供商保存 n8n 连接 Git 托管平台并完成身份验证所需的详细信息。一个实例上的多个环境可以使用同一个提供商。提供商类型决定了你能获得哪些功能:

功能 通用 Git GitLab
身份验证 SSH 密钥,或用户名和访问令牌 访问令牌
从列表中选择仓库和分支 否 是
推广审查 否 是:GitLab 合并请求同步到 n8n,并在 Reviews 审查 中提供更改的可视化差异

GitHub、Bitbucket 和其他 Git 托管平台可通过通用 Git 使用,但没有仓库列表和推广审查。

自托管 n8n

  • 如果你的 GitLab 实例位于内部网络中,请在 SSRF 防护中使用 N8N_SSRF_ALLOWED_HOSTNAMES 或 N8N_SSRF_ALLOWED_IP_RANGES 允许 GitLab API 调用访问它。
  • 如果你的 Git 托管平台使用私有证书颁发机构签发的证书,请为 Git 设置 GIT_SSL_CAINFO 或 GIT_SSL_CAPATH,并为 API 调用配置自定义证书颁发机构。
  • 要获取详细日志,请设置 N8N_LOG_SCOPES=promotions。

故障排除

Could not complete the Git operation(无法完成 Git 操作)

请检查:

  • 提供商中的身份验证信息正确且未过期。
  • 使用 SSH 时,部署密钥具有写入权限。
  • 分支已存在于 Git 托管平台上。
  • 仓库 URL 的格式与身份验证类型相符。请参阅通用 Git。

本节内容

  • 通用 Git:通过 SSH 或 HTTPS 连接任意 Git 仓库。
  • GitLab:使用访问令牌连接 GitLab,并以合并请求的形式审查推广。

相关资源

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