文档

仓库同步

更新时间:

针对从其他平台导入至 Codeup 的代码库,支持快速触发三方源代码仓库数据的同步,在代码迁移阶段可以帮助企业循序渐进地将业务从旧系统迁移至云效Codeup。

当企业切换代码平台的过程中,为了降低对日常业务的干扰,可以先迁移一部分敏感度低的仓库,在 Codeup 上搭建研发流程,此时旧平台继续正常使用。在 Codeup 上运行稳定后,统一禁止旧平台的新增写入,保证数据的一致性。这个过程中,旧平台新增的数据需要同步至新平台。Codeup 支持触发第三方源代码仓库数据同步,实现业务逐渐从旧系统平滑迁移。

前提条件

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

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

步骤一:查看同步入口

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

说明

单击前往同步,可以快捷跳转至代码库仓库同步的设置页面。

1

  1. 单击代码库设置,选择左侧导航栏的仓库同步,进入同步服务设置页。

针对三方导入的代码库,默认同步功能模块已启用(“启用”指允许该代码库使用同步功能,但何时触发同步需要在功能内设置),如后续不再有同步需求,可手动关闭同步服务,在源文件页面也将不再显示同步状态标识。

1-2

步骤二:设置授权账号

设置授权账号:如果三方仓库为公开库无须授权,即可直接点击立即同步。若三方库私有,则需要首先设置授权后再执行同步。

1-2

授权参数说明:

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

  • 密码/Access Token:可用于 HTTP 克隆导入来源库的密码或令牌,令牌生成方式参见Access Token 访问令牌如何获取?

1-2

步骤三:触发同步

授权完成后单击立即同步,此时会提示注意事项,确认后即可触发同步;

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

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

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

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

4

同步操作需要一定时间,请等待同步完成。仓库同步过程中将不支持写入,请合理安排同步时间,特别是针对网络条件不佳或超大仓库的同步时,可能存在较长等待时间,你可以切换页面,同步完成后将向操作人发送邮件通知。

5

说明

仓库同步超时时间为 10 分钟,超时将同步失败,可能提示未知异常。如导入自建代码库出现超时,请自行调整自建仓库的网络带宽。