跳到主要内容

Git 仓库对接

Rainbond 支持对接 Git 代码仓库,从源代码仓库直接创建组件。

目前 Rainbond 支持 GitHub GitLab Gitee 三种支持 Git 仓库对接的 Oauth 类型。Rainbond 所有支持的 OAuth 类型需要正常配置权限才能正常使用,比如 Github GitLab Gitee 需要授予获取代码仓库列表等权限。

对接 GitHub

创建 GitHub OAuth Apps

进入 Settings -> Developer settings -> OAuth Apps -> New OAuth App

说明
Application name自定义应用名称
Homepage URL访问 Rainbond 的URL,如 https://rainbond.com
Authorization callback URL回跳路径,用于接收返回的凭证,Homepage URL + /console/oauth/redirect,如:https://rainbond.com/console/oauth/redirect

创建 Rainbond OAuth

进入 平台管理 -> 设置 -> 基础设置 -> OAuth 第三方服务集成 -> 添加

说明
OAuth 类型github
名称自定义
客户端 IDGitHub OAuth Apps Client ID
客户端密钥GitHub OAuth Apps Client Secret
回调地址默认为当前 Rainbond 访问地址

对接 GitLab

创建 GitLab Applications

进入 User Settings -> Applications

说明
Name自定义
Redirect URL回跳路径,用于接收返回的凭证,Homepage URL + /console/oauth/redirect,如:https://rainbond.com/console/oauth/redirect
Scopes勾选 api read_user read_repository

创建 Rainbond OAuth

进入 平台管理 -> 设置 -> 基础设置 -> OAuth 第三方服务集成 -> 添加

说明
OAuth 类型gitlab
名称自定义
服务地址GitLab 访问地址
客户端 IDGitLab Applications Client ID
客户端密钥GitLab Applications Client Secret
回调地址默认为当前 Rainbond 访问地址

对接 Gitee

创建 Gitee 第三方应用

进入 设置 -> 第三方应用 -> 创建应用

说明
应用名称自定义
应用主页Rainbond 访问地址,如 https://rainbond.com
应用回调地址回跳路径,用于接收返回的凭证,Homepage URL + /console/oauth/redirect,如:https://rainbond.com/console/oauth/redirect
权限勾选 user_info projects hook

创建 Rainbond OAuth

进入 平台管理 -> 设置 -> 基础设置 -> OAuth 第三方服务集成 -> 添加

说明
OAuth 类型gitee
名称自定义
服务地址Gitee 访问地址
客户端 IDGitee Client ID
客户端密钥Gitee Client Secret
回调地址默认为当前 Rainbond 访问地址

OAuth 服务认证

在配置 OAuth 服务后在 Rainbond 右上角的用户信息内可以进行OAuth服务认证,与第三方平台互联。

Rainbond 右上角 个人中心 -> OAuth 账号绑定 -> 去认证

通过 Git 仓库创建组件

配置并认证 OAuth 服务后,可以通过代码仓库的项目直接创建组件。

进入 团队视图 -> 基于源码创建 -> 选择代码仓库 -> 基于项目创建组件

tip

GitLab 10.6 版本以后为了安全,不允许向本地网络发送 Webhook 请求。

解决:进入 Admin area -> settings -> OutBound Request 勾选 Allow requests to the local network from hooks and services

支持的 api 版本:

  • Github 目前支持的 api 版本为v3 版本
  • Gitlab 目前支持的 api 版本为 v4 版本
  • Gitee 目前支持的 api 版本为 v5 版本