n8n 中文文档

从 Environments (Classic) 升级

环境改进并取代了早期的源代码控制功能 Environments (Classic)。每个实例要么使用 Classic,要么使用环境;在环境功能处于 Preview 阶段期间,你可以切换回 Classic。

提示

Preview status 预览状态

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

比较 Classic 与环境

Environments (Classic) 环境
模型 实例向一个分支推送并从同一个分支拉取。 实例推广到一个环境,并从另一个环境应用。每个环境都可以使用自己的仓库和分支。
Git 托管平台 任何支持 SSH 或 HTTPS 的 Git 托管平台。 与 Classic 一样,可通过通用 Git 使用任何 Git 托管平台。GitLab 额外提供仓库和分支列表。
审查 在 Git 托管平台上手动审查。 在 n8n 中进行推广审查并提供可视化差异,基于 n8n 在 GitLab 上创建的合并请求。
选择更改 你选择要推送的内容。拉取会引入所有内容。 你可以通过项目级推广或项目级应用在两个方向上选择更改,也可以通过实例级推广或实例级应用移动所有团队项目。
依赖项 你选择工作流、凭据和数据表。n8n 会添加标签和变量存根。 n8n 会包含所选工作流使用的所有内容。已计划支持自行选择依赖项。
更改生效之前 确认后,拉取可能会覆盖本地更改。 应用会先检查阻止项,并要求你确认破坏性更改。
凭据 不含值的存根。 必须已存在于目标实例上,或者在应用时创建。
变量 不含值的存根。 连同其值一起写入仓库。必须已存在于目标实例上,或者在应用时创建。
可以使用的人 实例所有者和管理员。项目管理员可以推送。 实例所有者和管理员。已计划支持项目管理员执行项目级推广和项目级应用。
个人项目 包含。 不包含。
自动化 公共 API 中的源代码控制端点,以及 n8n CLI 中的 pull 命令。 公共 API 中的推广端点,以及 n8n CLI 中的推广命令。

环境尚不支持的 Classic 功能

环境目前还没有覆盖 Environments (Classic) 的所有功能。升级之前请检查以下各项:

  • 个人项目: Classic 包含个人项目。环境只推广团队项目。
  • 项目管理员: 在 Classic 中,项目管理员可以推送。在环境中,只有实例所有者和实例管理员可以推广和应用。已计划支持项目管理员执行项目级推广和项目级应用。
  • 自动发布: Classic 可以在拉取时发布工作流。应用不会改变工作流的发布状态。已计划支持自动发布。
  • 实例颜色: Classic 允许你为实例设置颜色。环境没有此设置。
  • 选择依赖项: Classic 允许你单独推送凭据和数据表。环境会包含所选工作流的所有依赖项,且你无法自行选择依赖项。已计划支持选择依赖项。
  • 跨项目移动: Classic 拉取会将工作流移动到它们在 Git 中所属的项目。项目级推广或项目级应用无法在项目之间移动工作流或文件夹,因此请使用实例级推广和实例级应用。请参阅在项目之间移动工作流和文件夹。
  • 工作流描述: Classic 会同步工作流描述,环境不会。
  • 凭据设置: Classic 会同步凭据是否共享给所有用户和项目,以及是否由每个用户连接自己的账户。环境不会同步这些设置,因此请在目标实例上重新设置这些选项。

提示

环境还有一些与 Classic 无关的限制。请参阅已知限制。

从 Environments (Classic) 迁移

Classic 和环境在 Git 中存储内容的格式不同,因此应用无法读取 Classic 推送的内容。从技术上讲,环境可以与 Classic 内容共用一个仓库,但 n8n 建议使用新仓库或空分支。

请先在测试实例上尝试。你的 Classic 设置会在后台保持连接,因此你可以切换回去。

开始之前:

  1. 将调用公共 API 中 Classic 端点的所有 CI 流水线切换到推广端点。升级只会改变 UI,因此这些端点仍会继续执行 Classic 的推送和拉取。n8n 计划在使用环境的实例上阻止这些端点。
  2. 在每个实例(例如开发和生产实例)上,前往 Settings 设置 > Environments (Classic),选择 Upgrade 升级 并确认。
  3. 为 Production 环境创建一个新仓库或空分支。
  4. 按照开发和生产中的说明添加环境配置。分支为空时,不要在生产实例上执行应用。

然后通过以下两种方式之一填充分支。

从开发实例开始

如果开发实例上没有尚未准备好进入生产环境的更改,请从第 3 步开始按照第一次推广操作。

从生产实例开始

如果开发实例上有尚未准备好进入生产环境的更改,请改为从生产实例填充分支。这样分支就与生产实例保持一致,等开发实例上的更改准备好后再推广。

从 Environments (Classic) 迁移:1. 生产实例执行一次实例级推广,推送到 Production 环境的 Git 分支。2. 开发实例将更改推广到该分支。3. 生产实例应用这些更改。

  1. 在生产实例上,添加一个指向同一仓库和分支的 Production 推广环境配置,并运行实例级推广。然后从生产实例中移除该推广环境配置。
  2. 此后,当开发实例上的更改准备好时,使用项目级推广推广它们。实例级推广还会发送尚未准备好的更改。
  3. 在生产实例上应用这些更改。

在这两种情况下,Classic 拉取都保留了源实例的 ID,因此应用会就地更新生产实例上的内容。工作流会保留其版本历史和执行记录,变量会保留其值,凭据会保留其密钥。完成后,请保护生产实例。

切换回 Environments (Classic)

  1. 前往 Settings 设置 > Environments 环境。
  2. 选择 Switch back 切换回去,然后确认。

切换回去只影响此实例。你可以随时再次升级。

相关资源

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