# 全局配置代码仓库连接流程

整体连接流程

  • 企业注册和认证: 在数产平台完成企业注册及认证
  • 查看全局配置:平台会为用户自动生成用户全局对接的webhook配置,在进行代码仓库连接前,需要在保护平台获取生成的Webhook Url
    Webhook Secret用于后续代码仓库的全局连接配置
  • 在企业内代码管理工具平台配置webhook:配置完成后,对应企业代码仓库后续的代码提交摘要信息会自动对接数产平台存证
    进行存证(平台目前支持的Git包含:Gitlab、Bitbucket)
  • 验证代码仓库连接配置是否成功:完成企业代码的全局webhook配置后,企业成员提交(push)代码后,在数产平台会存在存证记录。
graph TD
    ss((开始))
    ss --> s1[企业注册和认证]
    s1 --> s2[查看全局配置]
    s2 --> s3[获取Webhook Url和Webhook Secret]
    s3 --> s4[在企业内代码管理工具平台配置webhook]
    s4 --> s5[验证代码仓库连接配置是否成功]
    s5 --> se((结束))

# 企业注册和认证

如果您暂未完成企业注册,请按照注册/登录及企业认证流程流程完成注册及认证

# 查看全局配置

  1. 登录数产平台,点击左侧「超级软著」选项,进入超级软著对接仓库列表页。
  2. 点击"全局配置"的"查看"按钮,进入全局配置详情页面。
  3. 详情页展示用于全局对接的Webhook UrlWebhook Secret
  4. 点击刷新按钮可重置Webhook Secret
  5. 复制保存全局配置的Webhook UrlWebhook Secret用于后续代码仓库的全局连接配置。

全局配置详情页视图
全局配置详情页视图


# 在企业内代码管理工具平台配置webhook

  1. 登录GitLab并打开管理区域(Admin Area)。(管理员权限)
  2. 在管理区域的左侧边栏中,选择“System Hooks”选项,进入全局webhook"页面。
  3. 在"URL"文本框中输入数产平台中复制的Webhook Url,该URL即为推送存证对接的API地址。
  4. 在"Secret token"文本框中输入数产平台中复制的Webhook Secret
  5. 在"Trigger"下选择触发推送commit信息的事件,选择"Push events"。
  6. 在"SSL verification"下勾选"Enable SSL verification"。
  7. 点击"Add system hook"按钮,完成Gitlab 全局 Webhook配置,滑动页面至最底部查看配置信息。

Gitlab配置完成后视图
Gitlab配置完成后视图

首先进行webhooks插件安装(如果已完成插件安装,请跳过此过程):

  1. 在Bitbucket上打开任意代码仓库。
  2. 点击仓库页面左下方的"Repository settings"选项,进入仓库设置页面。
  3. 点击左侧"Hooks"按钮,进入hooks页面。
  4. 点击页面右上角"Add hook"按钮,进入插件应用市场,搜索"Post-Receive WebHooks"并进行安装。 Bitbucket插件安装后视图

完成插件安装后,进行webhook配置:

  1. 登录到Bitbucket的管理界面。(管理员权限)
  2. 在管理区域的左侧边栏中,选择“Post Webhooks”选项,进入Webhooks设置页面。
  3. 在Webhooks设置页面中,单击“Add webhook”按钮,进入Webhook配置页面。
  4. 在"Title"文本框中输入Webhook的名称.
  5. 在"URL"文本框中输入数产平台中复制的Webhook Url,该URL即为推送存证对接的API地址,请求方式为POST.
  6. 在"URL"底部选项框中选择"Enable Authentication",选择"Authentication type"为"BEARER",在"Token"文本框中输入数产平台中复制的Webhook Secret.
  7. 在"Repository events"下选择触发推送commit信息的事件,选择"On push",取消其余选项勾选。
  8. 取消"Pull request events"下所有选项勾选。
  9. 点击"Save"按钮,完成Bitbucket 全局Webhook配置。

Bitbucket配置完成后视图
Bitbucket配置完成后视图

# 验证全局配置是否成功

  1. 首先在一个已经存在的代码仓库B中进行一次代码提交(push)。 【假设仓库归属项目组GroupA】
  2. 然后再新建一个新的代码仓库C进行一次代码提交(push)。【假设仓库归属项目组GroupB】
  3. 登录数产平台:
    1. 进入「超级软著」tab页,查看页面是否新增对应的仓库记录。
    2. 进入全局配置详情页,查看连接状态、连接仓库数量、存证总数量。
  4. 若存在名称分别为GroupA-B、GroupB-C的对应记录且全局配置详情页中连接状态为"连接正常",连接仓库数量为2,存证总数量为2,则表示配置成功

超级软著tab页视图
超级软著tab页视图

全局配置详情页视图
全局配置详情页视图