规划环境
在进行任何设置之前,先确定哪些实例推广更改、哪些实例应用更改,以及每个环境对应哪个仓库和分支。
提示
Preview status 预览状态
环境功能处于 Preview 阶段,未来版本中可能会发生变化。在为生产实例设置之前,请先在测试实例上试用。
实例与环境的关系
每个实例属于一个环境,并推广到下一个环境。你需要在每个实例的 Settings 设置 > Environments 环境 中分别进行配置,最多两个环境配置:
- Apply 应用: 实例所属的环境。实例从该环境应用更改。
- Promote 推广: 下一个环境。实例将更改推广到该环境。
使用基于 Git 的推广时,每个环境配置都使用一个提供商、仓库和分支。它们在不同方向或不同实例之间不必一致,多个配置也可以共用一个提供商。一个实例可以从一个仓库应用、推广到另一个仓库,也可以使用同一仓库的不同分支。只要更改到达下一个实例所应用的分支,无论是 n8n 直接提交到该分支,还是有人将其合并进来,下一个实例都能获取这些更改。要在更改到达分支之前进行批准,请在 GitLab 上使用推广审查。
请按照发布流程中的阶段为每个环境命名,例如 Staging 或 Production。下面的模式是常见设置,但并非唯一选择。
开发和生产

当一个团队在一个实例上构建、在另一个实例上运行工作流时,使用此模式。
| 实例 | 推广更改到 | 从以下位置应用更改 |
|---|---|---|
| Development | Production:仓库 acme/n8n,分支 main |
无 |
| Production | 无 | Production:仓库 acme/n8n,分支 main |
在开发实例上,添加一个 Production 推广环境配置。在生产实例上,添加一个 Production 应用环境配置,指向同一个仓库和分支。
开发、预发布和生产

如果你希望在更改到达生产环境之前先在预发布实例上测试,请使用此模式。预发布实例有两个环境:它从 Staging 应用更改,并将更改推广到 Production。
| 实例 | 推广更改到 | 从以下位置应用更改 |
|---|---|---|
| Development | Staging:分支 staging |
无 |
| Staging | Production:分支 main |
Staging:分支 staging |
| Production | 无 | Production:分支 main |
在开发实例上,添加一个 Staging 推广环境配置。在预发布实例上,添加一个 Staging 应用环境配置和一个 Production 推广环境配置。在生产实例上,添加一个 Production 应用环境配置。同一环境的各个配置指向同一个仓库和分支。
Staging 和 Production 可以像表中那样是同一个仓库中的两个分支,也可以是两个仓库中的分支。如果预发布和生产由不同团队负责,或者它们在 Git 托管平台上需要不同的访问规则,请使用两个仓库。
设置新的目标实例
要首次将你的工作带到新的目标实例,请按照第一次推广操作。如果你的实例使用 Environments (Classic),请按照从 Environments (Classic) 迁移操作。
保护只执行应用的实例
在只应用更改的实例(例如生产实例)上开启 Protected instance 受保护实例。请参阅保护生产实例。