更新时间:2025-09-08 GMT+08:00
分享

同步仓库

如果用户导入外部仓库,且需要同步源仓库数据,可根据本章节进行配置。

约束限制

表1 同步仓库的约束限制

限制类别

具体限制

功能限制

当前仓库是导入的仓库。

权限限制

您需要具备仓库的“设置”权限。

配置同步仓库

  1. 如下图所示,具有仓库“设置”权限的用户单击上方导航栏“设置”,左侧导航栏选择“仓库管理 > 同步仓库”

  2. 用户请根据表2 同步仓库参数表格填写参数,表格的示例以GitLab仓导入为例。

    表2 “同步仓库”参数表格

    参数名称

    说明

    示例

    源仓库路径

    表示要导入的仓库路径,源仓库路径需要以(http://)或(https://)开头,以(.git)结尾。

    如果源仓库地址有变化,用户可重新填写源仓库地址。

    https://gitlab.com/example.git

    同步分支

    包括两个选项:

    • 默认分支。指新建代码仓库时自动创建的主分支,例如master分支。
    • 全部分支。指代码仓库中的所有分支,包括默认分支及其他自定义分支。

    勾选“默认分支”

    关联扩展点

    非必填参数。

    • 通用Git。该参数适用于所有外部导入仓库,第一列下拉选择“通用Git”,第二列下拉选择扩展点实例。
    • GitHub。该参数仅适用于导入仓库类型为GitHub仓,第一列下拉选择“GitHub”,第二列下拉选择扩展点实例。

    如果用户需要创建扩展点,可参考通过服务扩展点校验权限新建。

    第一列下拉选择“通用Git”,第二列下拉选择已经创建的扩展点实例“Test”。

  3. 用户请参考表3 “同步”参数表格,根据实际需求选择仓库数据同步的方式。

    表3 “同步”参数表格

    参数名称

    说明

    手动同步

    如果用户单击“同步仓库”,则出现弹框:

    • 如果用户想要强制同步源仓库内容,即勾选“允许强制同步”
    • 源仓库访问权限,包含两个可勾选的选项:
      • 不需要校验权限。
      • 需要校验权限。如果用户勾选此选项,“用户名”的填写请参考用户名“密码/Access Token”的填写请参考密码或Access Token
    警告:
    • 同步源仓库数据,可能会覆盖本地已经提交的代码,导致代码丢失,请用户谨慎操作!
    • 手动同步的时间间隔不能超过10分钟。

    定时同步

    此开关默认关闭,用户可以根据实际需求选择是否开启,开启开关后,仓库将会每24小时刷新一次,刷新内容为源仓库24小时前的内容。

    注意:

    如果用户打开定时同步功能,代码仓库为只读状态,无法提交或者上传代码。

相关文档