应用更改
应用更改会将你的工作从环境引入你的实例。项目级应用将选定的更改引入一个团队项目。实例级应用让整个实例与环境保持一致。
提示
Preview status 预览状态
环境功能处于 Preview 阶段,未来版本中可能会发生变化。在为生产实例设置之前,请先在测试实例上试用。
开始之前,请添加此实例要从中应用更改的环境。请参阅规划环境。
添加缺失的项目
项目级应用要求该项目已存在于实例上。如果环境的分支中包含此实例上尚不存在的团队项目,请先添加它们:
- 前往 Settings 设置 > Environments 环境。
- 在 Apply changes from 从以下位置应用更改 下的环境上,选择 Apply 应用 旁边的 Add N missing projects 添加 N 个缺失项目。
- 选择要添加的项目。可选:在 Assign a project admin 分配项目管理员 下,为每个项目选择一个用户。
- 确认 Add N missing projects 添加 N 个缺失项目。
n8n 会创建空项目,并沿用源实例中的 ID、名称、图标和描述,但不会应用任何内容。如果某个项目在分支上有工作流,请打开该项目并运行项目级应用。
不要手动创建这些项目。手动创建的项目会获得不同的 ID,因此即使名称相同,应用也不会匹配它,该项目仍会显示为缺失。
项目级应用
项目级应用会将你选择的更改引入一个团队项目。该项目必须以源实例的 ID 存在于实例上。请参阅添加缺失的项目。项目级应用绝不会删除项目。实例上的所有项目共享标签,因此标签重命名会在每个项目中生效。
- 打开一个团队项目。项目名称旁边有一个带向下箭头的徽标,显示传入更改的数量。
- 选择该徽标,打开 Changes to apply 待应用的更改 页面。
- 选择要应用的工作流。n8n 会包含它们的依赖项,例如凭据、变量、数据表和标签。
- 检查更改。每个资源都会显示其变更类型,例如 New 新建、Modified 已修改、Renamed 已重命名、Moved 已移动、Archived 已归档 或 Deleted 已删除。要直观比较工作流,请选择 Show diff 显示差异。差异查看器会显示画布的 Before 之前 和 After 之后,其中 Before 是此实例,After 是环境的分支。
- 查看 Blockers 阻止项 选项卡并解决所有阻止项。请参阅解决阻止项。
- 选择 Apply N changes 应用 N 项更改,然后确认。
解决阻止项
在应用写入任何内容之前,n8n 会根据实例检查这些更改。项目级应用和实例级应用都会进行此检查。阻止项会让应用停止,直到你解决它;只要还有阻止项,应用就不会做任何更改。
| 阻止项 | 处理方法 |
|---|---|
| Missing 缺失 凭据或变量 | 选择 Add credential 添加凭据 或 Add variable 添加变量 并创建它。对于凭据,n8n 会预先填入源实例上使用表达式的字段。对于变量,n8n 会预先填入源实例中的值。由其他项目拥有的凭据会显示为冲突。请参阅跨项目依赖。 |
| No access 无访问权限 | 凭据已存在,但该项目无法使用它。请让管理员将其共享给该项目。 |
| Conflict 冲突 | 该资源在实例上的差异是应用无法修复的。按照提示信息操作,然后刷新。 |
| Moved 已移动 | 该工作流或文件夹在分支上位于另一个项目中。项目级应用无法在项目之间移动条目。请在实例上移动它以与分支保持一致,或运行实例级应用。 |
确认破坏性更改
在执行以下操作之前,应用会要求你确认:
- 删除数据表列或更改其类型。这会删除这些列中的值,行和其他列会保留。
- 在实例级应用中删除项目。
实例级应用
危险
实例级应用会覆盖每个项目,使其与环境的分支一致。它会删除不在分支上的项目和内容,且无法撤销。请仅在源实例完成实例级推广之后,或在备份实例之后,才运行实例级应用。
使用实例级应用可以让实例与其环境完全一致,例如为新的生产实例初始化内容。对于日常更改,n8n 建议使用项目级应用,它能提供更精细的控制。
- 前往 Settings 设置 > Environments 环境。
- 在 Apply changes from 从以下位置应用更改 下的环境上,选择 Apply 应用。
- 阅读警告并选择 Apply 应用。
- 如果 n8n 发现阻止项或破坏性更改,会打开一个对话框。解决阻止项、检查更改并确认。要删除不在分支上的项目,请确认 Delete N projects and apply 删除 N 个项目并应用。
应用会在实例上更改什么
应用会带来你工作的结构,例如工作流、文件夹和数据表结构(schema)。它不会带来存储的内容,例如凭据密钥的字面值或数据表行。目前尚不包含智能体(Agents)。
| 资源 | 应用的行为 |
|---|---|
| 项目 | 实例级应用会创建分支上存在的项目,并在你确认后删除分支上不存在的项目。项目级应用绝不会创建或删除项目。要添加缺失的项目,请参阅添加缺失的项目。 |
| 文件夹 | 在项目内创建、重命名和移动文件夹,使其与分支一致。项目级应用只更改包含所选工作流的文件夹。 |
| 工作流 | 创建或更新工作流。如果你在源实例上删除了某个工作流,应用会在实例上删除它,而不是将其归档。已归档的工作流保持归档状态。应用不会改变工作流的发布状态。通过应用创建的工作流在到达时处于未发布状态,因此请在实例上发布它们。 |
| 凭据 | 将工作流关联到具有相同 ID 的凭据。如果凭据缺失,你需要在解决阻止项时创建它。如果凭据已存在且属于该项目,应用会更新其名称和使用表达式的字段,并保留其他所有值,例如密钥。 |
| 变量 | 变量必须已存在于实例上,或者你在解决阻止项时创建它(会预先填入源实例中的值)。应用绝不会更改现有变量的值。 |
| 数据表 | 创建数据表或更新其结构。现有行会保留。删除某列或更改其类型时,只会在你确认后删除该列的值。 |
| 标签 | 创建标签并重命名,使其与分支一致。应用绝不会删除标签。 |
应用按以下方式匹配实例上的内容:
- 按 ID: 项目、工作流、凭据和数据表。
- 按名称和范围: 变量。
- 先按 ID,再按名称: 标签。
推广和应用使用 n8n 包来导出和导入这些内容。
如果应用中途停止
分支已更改
如果在你加载更改后有人修改了环境的分支,应用会在写入任何内容之前停止。项目级应用会显示 The branch changed after the page loaded, so Apply didn't change anything.,实例级应用会显示 Apply paused。请查看最新更改,然后再次应用。
无法应用
如果实例级应用失败,n8n 会显示 Couldn't apply to the instance 和 Some changes may already be applied。n8n 不会回滚已经做出的更改。应用会让实例与分支保持一致,因此你可以再次运行它来完成操作。
如果项目级应用失败,n8n 会显示 Couldn't apply the changes 以及以下其中一项:
- Nothing changed: 根据提示信息修复原因,然后重试。
- The request may have run: 页面现在会显示最新更改。再次应用之前请先检查这些更改。