版本：v3&v6

集成GitHub/公有GitLab

通过代码关联集成GitHub/公有GitLab,将代码提交和Project模块结合使用

1.仓库集成配置

1.1 新建 Github/GitLab App

Github

登录对应的Github代码仓账号，进入Settings -> Developer settings -> OAuth Apps，点击New OAuth App，填写App信息，点击Register application。 NetEase NetEase 填写对应信息

Application name 应用名称自定义即可
Homepage URL 填入ONES主页URL
Authorization callback URL 用户确认后的回调地址，如{Homepage URL}/project/oauth

NetEase 生成Client ID和Client Secret NetEase 进入ONES服务容器，将对应的Client ID和Client Secret写入ONES的配置文件private.yaml中

  githubClientId: xxx
  githubClientSecret: xxx

配置更新后，make setup-ones 重启ONES服务

GitLab

与Github类似，登录对应的GitLab代码仓账号，进入Settings -> Applications，点击New application，填写App信息，点击Save application。 NetEase NetEase 生成Application ID和Secret 进入ONES服务容器，将对应的Application ID和Secret写入ONES的配置文件private.yaml中

  gitlabClientId: xxx
  gitlabClientSecret: xxx

配置更新后，make setup-ones 重启ONES服务

1.2 新建关联代码仓

如果你使用的是 ONES 私有部署版，请联系客服。ONES 的技术人员将为你准备基础配置，以便于能正常关联 GitHub/GitLab 代码仓。

通过 OAuth 的方式认证 GitHub/GitLab，以便系统能获取自动配置代码仓 Webhook 的权限。

如果未认证过 GitHub/GitLab，请点击「新建认证」按钮；在打开的 GitHub/GitLab 平台的界面中确认授权认证 ONES；授权认证 ONES 成功后，系统会引导你回到 ONES 系统。
如果你已认证过 GitHub/GitLab，但想修改认证帐号，请在浏览器的无痕模式下点击弹窗中的「重新认证」，登录新帐号并重新认证后，系统会引导你回到 ONES 系统。

OAuth 认证成功后，你需要选择代码仓并完成新建关联代码仓。

目前系统最多能获取到 GitHub/GitLab 的 100 个代码仓。如果希望关联 100 以上个代码仓，你需要将代码仓划分到不同的 GitHub/GitLab 帐号中进行关联。
操作关联的用户在 GitHub 中至少具有「Owner」权限、在 GitLab 中至少具有「Maintainor」权限，否则系统无权限自动配置代码仓的 Webhook，你需要手工配置。

新建关联代码仓后，系统会自动在代码仓中配置 Webhook。你可以在代码仓详情中检查 Webhook 的配置状态。 NetEase

1.2 重置webhook

Webhook 用于允许 ONES 监听代码平台上的特定提交事件。新建关联代码仓后，你可以通过以下方式重新配置 Webhook。

系统自动重置 Webhook 如果 Webhook 失效或被人为删除，你可以点击「重置 Webhook」按钮，系统会自动重置代码仓中的 Webhook。
手工配置 Webhook 点击「手工配置 Webhook」按钮，你可以查看当前代码仓的 Webhook 的配置信息，再进入 Git 平台中手工添加 Webhook。

NetEase NetEase NetEase