GitCode ↔ GitHub 仓库双向同步方案
【摘要】 目标:任意一端 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双向自动同步】,也是最常用实时方案
核心原理
- 往 GitHub push → GitHub Actions 触发,拉取代码,推送到 GitCode
- 往 GitCode push → GitCode CI(Gitee/GitCode CI)触发,拉取代码,推送到 GitHub
- 关键防循环:CI 自动提交时,commit message 带上特殊标记,流水线脚本检测到标记就直接退出,不再推送,避免 A→B→A→B 死循环
前置准备
- 两边仓库建好(GitHub 仓库、GitCode 仓库,分支结构尽量一致,推荐主分支
main/master) - 生成两个 Token:
- GitHub Personal access token (PAT):权限
repo,用于 GitCode CI 推送到 GitHub - GitCode Access Token:权限
repo,用于 GitHub Actions 推送到 GitCode
- GitHub Personal access token (PAT):权限
- 分别在两个仓库的【仓库 Secrets】存入 token
- GitHub 仓库 Secrets:
GITCODE_TOKEN - GitCode 仓库 Secrets:
GITHUB_TOKEN
- GitHub 仓库 Secrets:
仓库地址示例:
- 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],可以临时暂停一轮同步
冲突处理说明
双向同步无法自动解决代码冲突:
- ❌ 不要两边同时修改同一个文件并推送,一定会冲突
- ✅ 最佳习惯:固定一个主仓库作为开发入口,另一边仅镜像;双向只适合低并发、少冲突场景
- 出现冲突:需要人工在其中一侧仓库拉取、解决冲突、提交,冲突解决提交会自动同步到另一端
手动一次性同步命令(应急用)
本地拉取双远端,适合第一次初始化、CI 挂掉的时候手动同步
# 添加双远端
git remote add github
git remote add gitcode
# 拉取两边最新
git fetch github
git fetch gitcode
# 推送
git push github main
git push gitcode main
常见坑清单
- Token 权限不足:私有仓库必须勾选完整 repo 权限
- 没设置 fetch-depth:0:只拉单条commit,无法正确识别历史
- 忘记防循环标记 → CI 疯狂互相推送,消耗配额甚至仓库受限
- 分支名不一致(一边 main 一边 master)同步失败
- 大仓库、二进制文件多,推送超时,需要调整 CI 超时时间
补充:单向同步对比(如果你后续想降级)
- GitHub → GitCode:只配 GitHub Actions
- GitCode → GitHub:只配 GitCode CI
单向不需要担心循环问题,稳定很多,优先推荐单向镜像,双向是进阶玩法
如果你想要,我可以再单独输出一份极简版(去掉说明、只留配置)的 Markdown,或者给你做成一份可直接复制到 Notion 的版本。
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
评论(0)