n8n 中文文档

环境

环境(Environments)让你可以将工作流和其他 n8n 资源(例如凭据、变量和数据表)在发布流程的各个阶段(例如开发和生产)之间移动。你在一个实例上构建和测试更改,然后将其推广(promote)到下一个阶段。

提示

Feature availability 功能可用性

环境适用于:

  • n8n Cloud: Enterprise
  • 自托管: Enterprise

只有实例所有者和实例管理员可以设置环境、推广、应用和审查推广。

提示

Preview status 预览状态

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

提示

Limited enterprise readiness 有限的企业就绪度

环境功能的企业就绪度为 Limited enterprise readiness(有限)。有关它尚不支持的 Enterprise 能力,请参阅企业就绪度。

为什么使用环境

独立的环境让你可以修改工作流,而不会破坏生产中正在运行的工作流。一种常见的设置:

  • 开发: 构建和修改工作流。
  • 生产: 运行线上工作流。

环境如何工作

示例:更改从开发实例出发,经过可选的审查,进入 Production 环境的 Git 分支,再到达生产实例

更改通过环境在实例之间移动:

  1. 在开发实例上,将更改推广到 Production 环境。
  2. 可选:在更改到达环境之前,由某人在推广审查中批准这些更改。
  3. 在生产实例上,从 Production 环境应用(apply)这些更改。

使用基于 Git 的推广时,推广会将更改提交到 Production 环境的 Git 分支。

概念

环境

从概念上讲,环境是发布流程中的一个阶段,以及运行该阶段的实例,例如预发布(staging)实例或生产实例。你将更改推广到下一个环境,由该环境的实例应用这些更改。

从技术上讲,使用基于 Git 的推广时,推广的更改会在远程 Git 仓库的某个分支中等待,直到实例应用它们。在执行推广的实例上,推广环境配置指向该仓库和分支,并定义更改如何到达该分支,例如推送功能分支或创建合并请求。在执行应用的实例上,应用环境配置指向同一个仓库和分支。

推广和应用

推广和应用是两种推广操作:

  • Promote 推广 将更改从你的实例发送到某个环境。
  • Apply 应用 将更改从某个环境引入你的实例。

执行推广的实例是源实例,执行应用的实例是目标实例。

你可以在两个级别上推广或应用:

  • 项目: 推广或应用一个团队项目。你可以选择要包含哪些更改。
  • 实例: 推广或应用实例上的所有团队项目。

警告

实例级应用会覆盖实例上的每个团队项目,使其与环境保持一致。它还会删除环境中不存在的项目。

推广的内容

工作流是推广的主要单位。选择工作流时,n8n 会包含它们的依赖项:凭据、变量、数据表和标签。n8n 绝不会将凭据密钥、数据表行或执行记录写入仓库。变量会连同其值一起传递。

推广和应用使用 n8n 包来导出和导入内容。要了解应用会在实例上更改哪些内容,请参阅应用更改。

推广模型

推广模型是指更改在环境之间传递的方式。n8n 目前支持基于 Git 的推广,即更改通过 Git 仓库传递。以后可能会提供其他模型,例如直接从一个实例推广到另一个实例。请参阅基于 Git 的推广。

提供商

提供商(provider)保存 n8n 连接 Git 托管平台并完成身份验证所需的详细信息,例如访问令牌或 SSH 密钥。多个环境可以使用同一个提供商。你选择的 Git 提供商类型决定了你能获得哪些额外功能,例如列出该提供商可以访问的仓库和分支。

环境与 Environments (Classic)

环境取代了早期的源代码控制功能 Environments (Classic)。一个实例只能使用其中之一。请参阅从 Environments (Classic) 升级。

本节内容

相关资源

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