推拉
如果您的 n8n 实例连接到 Git 仓库,您需要保持您的工作与 Git 同步。
本文档假设您对 Git 概念和术语有一定的了解。有关 n8n 如何与 Git 配合使用的介绍,请参阅 Git 和 n8n。
提示
Recommendation: don't push and pull to the same n8n instance 建议:不要推送和拉取到同一个 n8n 实例
您可以将工作从实例推送到分支,然后拉取到同一实例。 n8n 不推荐这样做。为了降低合并冲突和覆盖工作的风险,请尝试创建一个流程,使工作朝一个方向进行:要么到 Git,要么从 Git,但不能同时进行。
获取别人的作品
提示
n8n roles control which users can pull (fetch) changes n8n 角色控制哪些用户可以拉取(fetch)更改
您必须是实例所有者或实例管理员才能从 git 提取更改。
要从 Git 提取工作,请在主菜单中选择 Pull 拉动
。
查看截图
n8n 可能会显示关于覆盖本地更改的警告。选择拉取并覆盖以用 Git 中的内容覆盖您的本地工作。
当更改包含新的变量或凭据存根时,n8n 会通知您需要在使用这些项目之前填充值。
提示
How deleted resources are handled 如何处理已删除的资源
从存储库中删除工作流、凭据、变量、标签和数据表时,这些资源的本地版本不会自动删除。相反,当您提取存储库更改时,n8n 会通知您任何过时的资源,并询问您是否要删除它们。
工作流程和凭证所有者可能会在拉取时更改
当您从 Git 拉取到 n8n 实例时,n8n 会尝试将工作流和凭据分配给匹配的用户或项目。
如果原始所有者是用户:
如果两个实例上都有相同的所有者(匹配的电子邮件),所有者保持不变。如果原始所有者不在新实例上,n8n 会将执行拉取的用户设置为工作流所有者。
如果原始所有者是项目:
n8n 按 ID 匹配项目。如果新实例上不存在该 ID 的项目,n8n 会创建一个 ID 和名称都相同的项目,并将执行拉取的用户设为该项目的项目管理员。然后,n8n 将工作流和凭据导入到该项目中。
拉取 时自动发布工作流程
拉取时,您可以在拉取弹窗中使用 Auto publish 自动发布 下拉菜单来自动发布工作流。它有三种模式:
- Off 关闭(默认):不尝试发布任何工作流。工作流保持当前本地发布状态。
- If workflow already published 如果工作流已发布:仅尝试发布本实例上已发布的工作流。新工作流不会被发布。
- On 开启:尝试发布所有拉取到的工作流,包括新工作流。
无论自动发布设置为何,n8n 都不会自动发布已归档的工作流。
启用自动发布并完成拉取后,n8n 会显示结果弹窗,列出哪些工作流发布成功、哪些失败。若工作流存在校验错误或缺少凭据,发布可能失败。
还可以通过 API 使用拉取端点上的 autoPublish 参数(其值为 none、published 或 all)来实现自动发布。
拉动可能会导致短暂的服务中断
如果您拉取对已发布工作流的更改,n8n 会在拉取时取消发布该工作流,然后再重新发布。这可能导致工作流出现几秒钟的停机时间。
将您的工作发送到 Git
提示
n8n roles control which users can push changes n8n 角色控制哪些用户可以推送更改
您必须是实例所有者、实例管理员或项目管理员才能将更改推送到 git。
要将工作推送到 Git:
- 在主菜单中选择 Push
。 -
在 Commit and push changes 模态框中,选择要推送的工作流和 data tables。你可以按状态(new、modified、deleted)过滤并搜索项目。n8n 会自动推送 tags,以及变量和凭据 stub。
n8n 推送的是工作流当前保存的版本,而不是已发布版本。之后你需要在远程服务器上单独发布版本。
-
输入 commit message。它应当用一句话描述你正在进行的更改。
- 选择 Commit and Push。n8n 会将工作发送到 Git,并在完成时显示成功消息。
提交的内容
n8n 将以下内容提交到 Git:
- 工作流,包括标签和工作流所有者的电子邮件地址。你可以选择要推送的工作流。
- 凭据存根,包括 ID、名称和类型。只有当其他字段为表达式时,才会包含这些字段。你可以选择要推送的凭据。
- 变量存根(ID 和名称)。
- 数据表模式(表名和列定义,不包括行数据)。你可以选择要推送的数据表。
- 项目。
- 文件夹。
合并行为和冲突
n8n 的源代码控制实现采用特定的处理方式。它会自动解决凭据和变量的合并冲突,但无法检测工作流中的冲突。
工作流程
在推送或拉取时,你必须明确告诉 n8n 如何处理工作流。Git 仓库充当真实来源。
拉取时,你可能会收到警告,提示你的工作流本地副本与 Git 不同,如果你接受,你的本地副本将被覆盖。拉取时要小心不要丢失相关更改。
推送时,你的本地工作流将覆盖 Git 中的内容,因此请确保你拥有最新版本,否则你可能会覆盖最近的更改。
为了防止上述问题,你应该在完成工作流工作后立即推送更改。然后拉取就是安全的。
为了避免丢失数据:
- 设计源代码控制设置时,让工作流只沿一个方向流转。例如,在开发实例上编辑,推送到 Git,再拉取到生产实例。不要在生产实例上编辑后再推送。
- 不要推送所有工作流。只选择你需要的工作流。
- 手动编辑 Git 存储库中的文件时要谨慎。
凭证、变量和工作流程标签
凭据和变量不会有合并问题,因为 n8n 会选择要保留的版本。
拉取时:
- 如果标签、变量或凭据不存在,n8n 会创建它。
- 如果标签、变量或凭据已存在,n8n 不会更新它,除非:
- 你使用 API 或外部设置变量的值。新值会覆盖任何现有值。
- 凭据名称已更改。n8n 使用 Git 中的版本。
- 标签的名称已更改。n8n 更新标签名称。重命名标签时要小心,因为标签名称是唯一的,这可能会在拉取过程中导致数据库唯一性问题。
推送时:
- n8n 会覆盖整个变量文件和标签文件。
- 如果凭据已存在,n8n 会用更改覆盖它,但在拉取时不会将这些更改应用到现有凭据。
数据表
n8n 会在不同环境间同步数据表模式(表结构和列定义)。行数据不会同步。
推送时:
- 您可以选择要包含哪些数据表。
- n8n 会导出表名、列名、列类型和列顺序。
拉取时:
- n8n 会创建本地不存在的数据表。
- n8n 会更新现有数据表,使其与 Git 中的模式一致:添加新列,并删除远程版本中不再存在的列。n8n 会保留其余列中的数据。
- n8n 会按项目内的数据表名称进行匹配。如果你在源环境中删除并用相同名称重新创建数据表,或在两个环境中手动创建同名数据表,n8n 会将其视为同一张表:它会将本地表的 ID 调整为传入表的 ID,像处理其他变更一样更新模式,并保留本地行数据。
- 如果某张数据表存在于本地但不存在于 Git 中,拉取会删除它,包括所有行数据。交互式拉取会先在确认对话框中将该表列为 Deleted 已删除。使用 force 选项的拉取,例如通过 API 或自动化设置触发的拉取,会直接删除该表而不询问。若要保留这样的表,请在拉取前先推送它。
警告
Column removal causes data loss 删除列会导致数据丢失
如果拉取的数据表与本地版本相比删除了列,则 n8n 会删除这些列及其数据。这无法撤消。当发生这种情况时,n8n 在拉模式中显示警告。
提示
Manage credentials with an external secrets vault 使用外部机密库管理凭据
如果您在不同的 n8n 环境中需要不同的凭据,请使用 external Secrets。
相关资源
- 使用源代码控制和环境
- 了解源代码控制
- 使用环境
- 在 n8n 中使用 Git
- 选择分支模式
- 设置源代码控制
- 比较版本
- 在环境之间移动工作
- 通过公共 API 以编程方式使用环境
- 教程:使用源代码管理创建环境