教程：使用源代码控制创建环境#

本教程将逐步介绍如何端到端地设置环境。您将创建两个环境：开发环境和生产环境。本教程使用GitHub作为Git提供商，其他提供商的过程类似。

n8n基于版本控制软件Git构建了其环境功能。您可以将n8n实例链接到Git分支，并使用推送-拉取模式在不同环境之间迁移工作。您应该对环境和Git有一定的了解。如果需要更多关于这些主题的信息，请参考：

• n8n中的环境: 环境的作用及其在n8n中的工作原理。
• Git and n8n: n8n中的Git概念与源代码控制。

选择您的源代码管理模式#

在设置源代码控制和环境之前，您需要规划您的环境以及它们与Git分支的关系。n8n支持不同的分支模式。对于环境，您需要在两种模式之间做出选择：多实例多分支或多实例单分支。本教程涵盖这两种模式。

多实例，多分支#

这种模式的优势是：

• 新增的安全层，防止变更意外进入生产环境。您需要在GitHub上发起拉取请求才能在环境之间复制工作流程。
• 它支持两个以上的实例。

缺点是在环境之间复制工作需要更多的手动步骤。

多个实例，一个分支#

这种模式的优点是，当你从一个实例推送时，工作可以立即在其他环境中使用。

缺点包括：

• 如果误推送，工作内容可能会进入生产环境实例。如果您使用GitHub Action自动拉取到生产环境，则必须采用多实例多分支模式，或者谨慎确保绝不推送不希望进入生产环境的工作内容。
• 向同一实例推送和拉取可能导致数据丢失，因为这些操作会覆盖更改。您应设置流程以确保内容单向流动。

设置您的代码仓库#

选择好模式后，您需要设置您的GitHub仓库。

将您的n8n实例连接到代码仓库#

创建两个n8n实例，一个用于开发环境，一个用于生产环境。

在n8n中配置Git#

1. 前往设置 > 环境。
2. 在Git仓库URL中输入您仓库的SSH URL。
3. n8n支持ED25519和RSA公钥算法。ED25519是默认选项。如果您的git主机需要RSA，请在SSH密钥下选择RSA。
4. 复制SSH密钥。

设置部署密钥#

通过使用n8n中的SSH密钥为代码库创建部署密钥来设置SSH访问权限。该密钥必须具有写入权限。具体操作指南请参考GitHub | 管理部署密钥。

连接n8n并配置您的实例#

从开发环境推送工作#

在您的开发实例中，创建一些工作流、标签、变量和凭据。

将工作推送到Git：

1. 在主菜单中选择推送 。

   查看截图

   

   

2. 在提交并推送更改模态窗口中，选择您想要推送的工作流。您可以按状态（新增、修改、删除）进行筛选，并搜索工作流。n8n会自动推送标签、变量和凭证存根。

3. 输入提交信息。这应该是对你所做更改的一句话描述。
4. 选择提交并推送。n8n将工作内容发送到Git，并在完成后显示成功消息。

将工作拉取到生产环境#

您的工作现已提交至GitHub。如果您使用的是多分支设置，它位于开发分支上。如果您选择的是单分支设置，它位于主分支上。

View screenshot

可选：使用GitHub Action自动化拉取#

如果想避免登录生产实例进行拉取操作，可以使用GitHub Action和n8n API，这样每次向生产或主分支推送新工作时就能自动完成拉取。

一个GitHub Action示例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

name: CI
on:
  # Trigger the workflow on push or pull request events for the "production" branch
  push:
    branches: [ "production" ]
  # Allows you to run this workflow manually from the Actions tab
  workflow_dispatch:
jobs:
  run-pull:
    runs-on: ubuntu-latest
    steps:
      - name: PULL
				# Use GitHub secrets to protect sensitive information
        run: >
          curl --location '${{ secrets.INSTANCE_URL }}/version-control/pull' --header
          'Content-Type: application/json' --header 'X-N8N-API-KEY: ${{ secrets.INSTANCE_API_KEY }}'

下一步#

了解更多关于：

• n8n中的环境 和 Git与n8n
• 源代码控制模式