跳到主要内容

仓库镜像

仓库镜像管理功能用于配置和管理仓库镜像，配置仓库镜像可以实现不同平台之间仓库分支、标签和提交信息的自动同步。

GitCode支持两种镜像：Pull 和 Push

  • Push：用于将 GitCode 的仓库自动镜像到 GitHub 或 Gitee
  • Pull：用于将 GitHub 或 Gitee 的仓库镜像到 GitCode

设置入口​

首先进入项目主页，点击标签栏中的「项目设置」，再点击侧边栏中的「仓库镜像」

image-20241227175028255

添加 Push 镜像​

Push 镜像用于将 GitCode 的仓库自动镜像到 GitHub 或 Gitee

提示
  • 推送代码文件超时时间为30分钟，推送LFS文件超时时间为150分钟
  • 仓库每次提交都会⾃动触发同步操作，操作会直接覆盖镜像仓库代码
  • 镜像仓库推送同时支持不超过5个

  1. 在标签栏中选中「Push」，再点击「添加镜像」

    image-20241227175309393

  2. 输入目标项目的地址、目标平台的账号、目标平台的个人令牌后点击确认完成添加

    image-20241227175552346

  3. 添加完成后如下图所示，GitCode 仓库更新时将自动推送更新到目标仓库

    image-20241227184406892

设置 Pull 镜像​

Pull 镜像将用于将 GitHub 或 Gitee 的仓库镜像到 GitCode

您可以按一下方式配置 Pull 方向的镜像：

  1. 在标签栏选中「Pull」，填入所需的具体信息

    提示

    覆盖分叉分支（pull-f） 是一个控制镜像拉取操作时如何处理本地与远程分支差异的选项。

    启用时：镜像拉取操作会强制更新所有分支（包括分叉的分支），无论本地是否存在更改或分歧。这在需要强制同步所有分支为远程版本时非常有用，但可能导致本地数据丢失。

    禁用时：对本地分支的保护更严格，避免因远程更改覆盖本地数据；适合有本地修改且需确保数据安全的场景。

    image-20241227185319599

  2. 点击「设置镜像」后完成操作，设置结果如下图所示

    image-20241227185451937

双向镜像​

双向镜像是指对同一个 GitHub（或 Gitee） 仓库在 GitCode 上同时配置了两种镜像同步方式。配置完成后，无论您在 GitHub 还是 GitCode 平台上提交代码，变更内容都将被自动同步到另一个平台。

注意

为了避免代码丢失的问题，建议在使用双向镜像时遵循以下规则：

  1. 避免同时提交：不要在同一时间段内同时向 GitCode 和 GitHub 仓库提交代码，以免因冲突或覆盖导致数据丢失。
  2. 间隔提交操作：尽量保证在 GitCode 和 GitHub 仓库之间提交代码的时间间隔大于 30 分钟，以确保同步过程完成且状态一致。

通过遵循以上规则，您可以在享受双向镜像功能带来便利的同时，降低可能的风险。