GitCode ↔ GitHub 仓库双向同步方案

举报
Tony Ren 发表于 2026/10/28 08:06:38 2026/10/28
【摘要】 目标:任意一端 push 代码,自动同步到另一端;私有仓库也支持 **GitCode、GitHub 原生都不自带双向镜像**,双向同步只能靠 CI 流水线实现,要做好防循环触发配置,否则会出现无限来回推送。

GitCode ↔ GitHub 仓库双向同步方案

目标:任意一端 push 代码,自动同步到另一端;私有仓库也支持
⚠️ 重要前提:GitCode、GitHub 原生都不自带双向镜像,双向同步只能靠 CI 流水线实现,要做好防循环触发配置,否则会出现无限来回推送。

方案选型总览

方案 原理 优点 缺点 推荐度
GitHub Actions + GitCode CI 双端触发 GitHub 有提交 → Action 推 GitCode;GitCode 有提交 → GitCode CI 推 GitHub 标准稳定,可控性强,私有仓库可用 需要两边分别配置 CI、配置两个 access token,必须加循环拦截 ⭐⭐⭐⭐⭐(首选)
本地定时脚本镜像 一台常驻机器/服务器定时拉取两边仓库对比推送 逻辑简单,适合不会写 CI 的人 不是实时,有延迟,需要一台常驻主机 ⭐⭐⭐
第三方镜像服务 第三方中转服务监听两端 webhook 不用自己维护流水线 私有仓库有密钥泄露风险,服务不稳定,不推荐生产 ⭐

✅ 下面详细讲【双端CI双向自动同步】,也是最常用实时方案

核心原理

  1. 往 GitHub push → GitHub Actions 触发,拉取代码,推送到 GitCode
  2. 往 GitCode push → GitCode CI(Gitee/GitCode CI)触发,拉取代码,推送到 GitHub
  3. 关键防循环:CI 自动提交时,commit message 带上特殊标记,流水线脚本检测到标记就直接退出,不再推送,避免 A→B→A→B 死循环

前置准备

  1. 两边仓库建好(GitHub 仓库、GitCode 仓库,分支结构尽量一致,推荐主分支 main / master)
  2. 生成两个 Token:
    • GitHub Personal access token (PAT):权限 repo,用于 GitCode CI 推送到 GitHub
    • GitCode Access Token:权限 repo,用于 GitHub Actions 推送到 GitCode
  3. 分别在两个仓库的【仓库 Secrets】存入 token
    • GitHub 仓库 Secrets:GITCODE_TOKEN
    • GitCode 仓库 Secrets:GITHUB_TOKEN

仓库地址示例:

  • GitHub:[github.com/xxx/demo.git](github.com/xxx/demo.git)
  • GitCode:[gitcode.com/xxx/demo.git](gitcode.com/xxx/demo.git)

第一部分:GitHub Actions 配置(GitHub → GitCode)

在 GitHub 仓库新建文件:.github/workflows/sync-to-gitcode.yml

name: Sync to GitCode
on:
  push:
    branches: [ main ]
jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Sync to GitCode
        env:
          GITCODE_REPO: [/gitcode.com/xxx/demo.git](gitcode.com/xxx/demo.git)
          GITCODE_TOKEN: ${{ secrets.GITCODE_TOKEN }}
        run: |
          # 检测循环标记,自动提交的commit跳过同步
          if git log -1 --pretty=%B | grep -q "[skip sync]"; then
            echo "Detected sync commit, skip"
            exit 0
          fi
          git remote add gitcode /oauth2:${GITCODE_TOKEN}@gitcode.com/xxx/demo.git
          git push gitcode main

第二部分:GitCode CI 配置(GitCode → GitHub)

GitCode CI 兼容 Gitee CI 语法,在 GitCode 仓库根目录新建 .gitci.yml

name: Sync to GitHub
on:
  push:
    branches: [ main ]
jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: gitcode/checkout@v2
        with:
          fetch-depth: 0
      - name: Sync to GitHub
        env:
          GITHUB_REPO: [ github.com/xxx/demo.git]
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          if git log -1 --pretty=%B | grep -q "[skip sync]"; then
            echo "Detected sync commit, skip"
            exit 0
          fi
          git remote add github  /${GITHUB_TOKEN}@github.com/xxx/demo.git
          git push github main

循环同步拦截规则(重中之重)

规则:流水线自动推送产生的提交,commit 信息带上 [skip sync]

  • 当脚本读到最新 commit 包含 [skip sync],直接终止流水线,不再反向推送
  • 你自己手动提交代码时不要加这个标记,才会正常触发同步

如果后续你手动合并冲突,提交信息也加上 [skip sync],可以临时暂停一轮同步

冲突处理说明

双向同步无法自动解决代码冲突:

  1. ❌ 不要两边同时修改同一个文件并推送,一定会冲突
  2. ✅ 最佳习惯:固定一个主仓库作为开发入口,另一边仅镜像;双向只适合低并发、少冲突场景
  3. 出现冲突:需要人工在其中一侧仓库拉取、解决冲突、提交,冲突解决提交会自动同步到另一端

手动一次性同步命令(应急用)

本地拉取双远端,适合第一次初始化、CI 挂掉的时候手动同步

# 添加双远端
git remote add github
git remote add gitcode

# 拉取两边最新
git fetch github
git fetch gitcode

# 推送
git push github main
git push gitcode main

常见坑清单

  1. Token 权限不足:私有仓库必须勾选完整 repo 权限
  2. 没设置 fetch-depth:0:只拉单条commit,无法正确识别历史
  3. 忘记防循环标记 → CI 疯狂互相推送,消耗配额甚至仓库受限
  4. 分支名不一致(一边 main 一边 master)同步失败
  5. 大仓库、二进制文件多,推送超时,需要调整 CI 超时时间

补充:单向同步对比(如果你后续想降级)

  • GitHub → GitCode:只配 GitHub Actions
  • GitCode → GitHub:只配 GitCode CI
    单向不需要担心循环问题,稳定很多,优先推荐单向镜像,双向是进阶玩法

如果你想要,我可以再单独输出一份极简版(去掉说明、只留配置)的 Markdown,或者给你做成一份可直接复制到 Notion 的版本。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。