如何将GitHub Git仓库迁移至Gogs？解决CI/CD克隆超时问题

一、将GitHub仓库复刻至Gogs的可行方案 #

完全可以通过镜像迁移的方式复刻GitHub仓库到Gogs，全程保留所有提交历史、分支、标签，完美适配GitOps场景，操作步骤如下：

• 在Gogs界面创建空仓库，不要勾选初始化README、.gitignore等选项，避免后续推送冲突
• 本地克隆原GitHub仓库的镜像版：

  git clone --mirror https://github.com/your-org/target-repo.git
  

• 进入克隆后的镜像仓库目录：

  cd target-repo.git
  

• 添加Gogs仓库作为新远程源：

  git remote add gogs http://<gogs-aks-ingress-domain>/your-org/target-repo.git
  

• 推送所有镜像内容到Gogs：

  git push --mirror gogs
  

• 登录Gogs仓库验证，确认分支、标签、提交记录与原GitHub仓库完全一致

二、移除原仓库的上游复刻关系 #

如果原GitHub仓库本身是另一个仓库的复刻，要彻底断开上游关联，操作分两种场景：

1. Gogs仓库层面取消复刻关联 #

如果是在Gogs创建仓库时直接选择了「复刻自GitHub仓库」，直接在Gogs仓库的设置 > 仓库管理中找到「复刻关系」选项，点击「取消关联」即可，无需命令行操作。

2. 本地仓库移除上游远程 #

如果是通过镜像迁移的仓库，本地操作移除上游：

• 克隆Gogs上的仓库到本地：

  git clone http://<gogs-aks-ingress-domain>/your-org/target-repo.git
  

• 查看当前远程源列表：

  git remote -v
  

• 如果存在upstream（上游复刻源），执行删除：

  git remote remove upstream
  

• （可选）如果需要同步到Gogs仓库，推送远程源配置变更：

  git push origin --delete upstream
  

三、无需重新部署的Flux配置切换 #

核心是修改Flux的Git源配置，保留现有集群资源，操作步骤：

1. 更新Ansible Playbook中的Flux Bootstrap参数 #

编辑调用Flux Bootstrap的Playbook，将git-url替换为Gogs仓库地址，同时配置Gogs的认证信息（用户名密码或SSH密钥）：

- name: Bootstrap Flux
  flux_bootstrap_git:
    url: "http://<gogs-aks-ingress-domain>/your-org/target-repo.git"
    branch: "main"
    path: "./clusters/aks-cluster"
    git_username: "{{ gogs_username }}"
    git_password: "{{ gogs_password }}"
    # 若用SSH认证，替换为ssh_key参数
    # ssh_key: "{{ lookup('file', '~/.ssh/gogs-flux-key') }}"

2. 直接更新集群中的Flux资源 #

如果不想重新运行Playbook，可直接修改集群内的Flux GitRepository资源：

• 查看当前Flux GitRepository：

  kubectl get gitrepositories.source.toolkit.fluxcd.io -n flux-system
  

• 编辑该资源，将spec.url改为Gogs仓库地址，同步更新认证Secret引用：

  kubectl edit gitrepositories.source.toolkit.fluxcd.io flux-system -n flux-system
  

• 保存退出后，Flux会自动尝试从新地址拉取内容，验证同步状态：

  kubectl get gitrepositories.source.toolkit.fluxcd.io -n flux-system
  

  确认READY状态为True即可。

3. 清理旧GitHub认证（可选） #

如果不再需要访问原GitHub仓库，可删除集群内的旧GitHub认证Secret：

kubectl delete secret flux-system -n flux-system
# 注意：如果该Secret同时用于其他资源，需确认后再删除

关键注意事项 #

• 迁移前确认Gogs服务器的存储空间足够容纳大型CI/CD仓库的所有内容
• 迁移过程中暂停对原GitHub仓库的重大提交，避免内容不一致；迁移完成后统一切换到Gogs作为唯一GitOps源
• 若使用SSH认证，需将Gogs的SSH公钥添加到Flux的Secret中，确保集群内Flux组件能正常拉取仓库内容

内容的提问来源于stack exchange，提问作者icordoba