通用 Git
通用 Git(Generic Git)提供商通过 URL 将环境连接到任意 Git 仓库,包括 GitHub 和 Bitbucket 上的仓库。它使用 SSH 密钥或用户名和访问令牌进行身份验证。
提示
Preview status 预览状态
环境功能处于 Preview 阶段,未来版本中可能会发生变化。在为生产实例设置之前,请先在测试实例上试用。
通用 Git 支持的功能
| 功能 | 是否支持 |
|---|---|
| 身份验证 | SSH 密钥,或用户名和访问令牌 |
| 从列表中选择仓库和分支 | 否。你需要输入仓库 URL 和分支。 |
| 将每次推广推送到功能分支 | 是 |
| 推广审查 | 否。由某人在 Git 托管平台上手动合并功能分支。 |
使用 SSH 密钥连接
- 在 Connect Generic Git 连接通用 Git 对话框中,输入 Name 名称,并将 Authentication 身份验证 设置为 SSH key SSH 密钥。
- 选择 SSH key type SSH 密钥类型。n8n 会生成密钥对。
- 选择 Continue 继续,然后选择 Copy deploy key 复制部署密钥。
- 在你的 Git 托管平台上,将该密钥作为具有写入权限的部署密钥添加到仓库。
Bitbucket Cloud 只提供只读的仓库访问密钥,因此请使用用户名和访问令牌连接 Bitbucket Cloud,或者将部署密钥添加到 Bitbucket 账户而不是仓库。账户密钥会让 n8n 访问该账户能访问的所有仓库,因此请使用专用账户。
警告
请使用以 ssh:// 开头的 SSH 仓库 URL,例如 ssh://[email protected]/acme/n8n.git。Environments (Classic) 接受的 [email protected]:acme/n8n.git 格式在这里无效。
要更换密钥,请编辑提供商并选择 Generate a new key 生成新密钥。将新密钥添加到你的 Git 托管平台,然后在那里移除旧密钥。
使用用户名和访问令牌连接
- 在 Connect Generic Git 连接通用 Git 对话框中,输入 Name 名称,并将 Authentication 身份验证 设置为 Username and password 用户名和密码。
- 输入 Username 用户名,并在 Password or access token 密码或访问令牌 中输入一个对仓库具有写入权限的访问令牌。
- 选择 Continue 继续。
请使用不含凭据的 HTTPS 仓库 URL,例如 https://github.com/acme/n8n.git。
令牌需要哪些权限
通用 Git 只运行 Git 命令,不会调用 Git 托管平台的 API。令牌需要对仓库代码具有读写权限。如果你将每次推广推送到功能分支,它还需要创建分支的权限。
常见 Git 托管平台:
| Git 托管平台 | 用户名 | 令牌 |
|---|---|---|
| GitHub | 你的 GitHub 用户名 | 针对该仓库的细粒度个人访问令牌(fine-grained personal access token),权限为 Contents:Read and write。这也涵盖创建分支。 |
| GitLab | 你的 GitLab 用户名 | 具有 write_repository 范围的个人、群组或项目访问令牌。如果使用细粒度个人访问令牌,请添加 Code:Download、Push,以及 Branch:Create。 |
| Bitbucket Cloud | 你的 Bitbucket 用户名 | 具有 read:repository:bitbucket 和 write:repository:bitbucket 范围的 API 令牌。 |
你无法更改提供商的身份验证方式。要切换,请创建另一个提供商。
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。