仓库同步

更新时间:
复制为 MD 格式

本文主要为您介绍将第三方平台的代码库内容,通过Codeup仓库同步的设置实现快速导入。

背景信息

企业在转型代码平台的过程中,为了降低对日常业务的干扰,采取将仓库低敏部分内容先迁移至Codeup,并在Codeup上同步进行研发流程的搭建,在 Codeup 上运行稳定后,统一禁止旧平台的新增写入,保证数据的一致性。在此之前,旧平台新增的数据需要同步至新平台。

前提条件

  • 同步代码会强制覆盖当前库的内容,不受保护分支等规则限制,可能导致大量数据变更。因此,同步功能仅允许仓库管理员执行。如何设置仓库管理员,请参见平台权限设置

  • 仅通过网页端导入的代码库和通过自建Gitlab迁移工具(BETA)导入的Gitlab仓库支持同步。其他来源的新建库不支持同步功能。如何通过网页端导入三方代码库,请参见网页端导入三方代码库

步骤一:查看同步入口

  1. 作为仓库管理员,前往代码库源文件概览页,单击前往同步,查看最近一次同步时间和状态。

    说明

    单击前往同步,跳转至同步设置页面。

  2. 左侧导航栏选择设置 > 仓库同步

    进入同步服务设置页。默认情况下,三方导入的代码库已启用同步功能。若不再需要同步,可手动关闭同步服务。

步骤二:设置授权账号

如果三方仓库为公开库,无需授权,直接点击“立即同步”。若为私有库,则需先设置授权后再执行同步。

在仓库同步页面,找到授权账号显示为"未设置",单击旁边的立即设置链接进入授权配置。

授权参数说明:

  • 账号:用于HTTP克隆导入来源库的账号。

  • 密码/Access Token:用于 HTTP 克隆导入来源库的密码或令牌。令牌生成方式参见Access Token访问令牌如何获取?。在更新授权对话框中,填写密码 / Access Token,单击确定完成授权设置。

步骤三:触发同步

授权完成后单击立即同步,此时会提示注意事项,请确定后提交触发同步。在仓库同步页面,单击立即同步,在弹出的确认对话框中确认注意事项后,单击确定

重要
  • 强制同步会覆盖当前仓库和远端仓库不同的所有Git改动数据。

  • 为保证数据一致性,同步过程中将暂时禁止仓库写入。

  • 同步过程不受保护分支、推送规则等规则限制。

如果三方数据有变更,会直接使用三方库内容覆盖当前库内容,包括提交的历史和评论信息等数据,请在合适的场景下使用仓库同步,此功能不适合新旧平台同时提交并行开发的情况。

同步操作需要时间,请等待同步完成。

触发同步后,页面顶部弹出提示仓库同步中,暂不支持操作,请稍后再试立即同步按钮变为灰色同步中状态。页面底部展示同步记录表格,包含操作人、同步时间、状态、说明、同步方式等列,状态可能为等待同步失败(失败时说明列显示具体原因,如"未知异常,请重试")。

说明
  • 同步操作需要时间,请等待完成。同步过程中禁止写入,请合理安排时间。网络条件不佳或超大仓库可能需要更长时间。您可以切换页面,完成后会发送邮件通知。

  • 网络条件不佳或超大仓库可能需要更长时间。如导入自建代码库出现超时,请自行调整自建仓库的网络带宽。