码云阅读 2022-03-04

万一 Github不让用了，Gitee同步指南请收好

文章目录隐藏

现有仓库同步
未来代码的同步

方案一：增加 remote 源
方案二：增加 push 源
方案三: 使用 github action

最近很多开源项目让一个本该纯粹的地方混入了政治色彩。例如 Node 还有 React 这些超明星级的项目。

目前来看 React 的 issues 已经沦陷了，大家都在反对一个原本纯粹的地方为什么会有了政治？

如果说开源项目涉及了政治，那么 github 还会远吗，我不得而知。为了避免造成不必要的损失，因此连夜把自己 github 上的项目都同步一份到了 gitee，并且写下了这一份指南。

因此我也建议大家未雨绸缪，对自己的 github 账户进行备份，不管一切，不能让我们本应该有的权益受到损失。

同步主要分为现有仓库同步以及未来代码同步两个部分。

现有仓库同步

这一步其实 gitee 官网已经集成了一键导入的功能。

详情：点击这里

一共分为 3 个步骤：

1. 从 + 号找到从 Github/Gitlab 导入仓库。

2. 授权 gitee github 权限。

3. 授权后可以看到这样一个 tab 页面选项，我们选择导入当前页面所有仓库。

gitee 就会自动帮我们导入在 github 的项目，等待一些时间就好。

导入完成之后，所有的项目都是私有权限，因此也不用担心自己原本在 gihtub 上的私有仓库权限泄漏。

未来代码的同步

虽然我们已经把现有的仓库全部同步到了 gitee ，但是我们本地仓库的源还是 github 的，因此还需要对这部分未来增量代码做处理。

方案一：增加 remote 源

这个方案其实很简单，很多同学在提交开源项目，想要合入开源项目最新代码的时候肯定用到过。

git remote add <name> <url>

一共分为 2 个步骤：

1. 在你原来的 github 仓库下添加远端仓库。

例如：git remote add gitee ``[git@github.com](mailto:git@github.com "git@github.com")``:hua1995116/mmt.git

添加后可以看到这样的：

2.提交当前的增量代码。

git push origin   // 提交到 github
git push gitee    // 提交到 gitee

而这种方式有一个缺点就是每次需要提交两次。

方案二：增加 push 源

1. 删除方法一的 gitee 源 (还没有操作方案一的忽略这个步骤)。

git remote rm gitee

2.添加 push 源。

git remote set-url --add origin git@github.com:hua1995116/mmt.git

3.提交代码。

git push origin

为了省去第二步繁琐，我配置了一个脚本能够快速添加。（前提是你的 gihtub 账户名字和 gitee 的账户名字是一样的）

npm i -g mmt
mmt import https://gitee.com/hua1995116/mmt-practices/raw/master/mmt-export-gitee.json
// 进入到你想要添加命令的目录
mmt run gitee // 每个原有 github 仓库无脑运行这个命令就可以

效果：

方案三: 使用 github action

此方案一共 2 个步骤

1. 在仓库根目录创建 .github/workflows 目录。

2. 创建 gitee-sync.yml。

# 通过 Github actions， 在 Github 仓库的每一次 commit 后自动同步到 Gitee 上
name: gitee-sync
on:
  push:
    branches:
      - master
jobs:
  repo-sync:
    env:
      dst_key: ${{ secrets.GITEE_PRIVATE_KEY }}
      dst_token: ${{ secrets.GITEE_TOKEN }}
      gitee_user: ${{ secrets.GITEE_USER }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
        with:
          persist-credentials: false

      - name: sync github -> gitee
        uses: Yikun/hub-mirror-action@master
        if: env.dst_key && env.dst_token && env.gitee_user
        with:
          # 必选，需要同步的 Github 用户（源）
          src: 'github/${{ github.repository_owner }}'
          # 必选，需要同步到的 Gitee 用户（目的）
          dst: 'gitee/${{ secrets.GITEE_USER }}'
          # 必选，Gitee 公钥对应的私钥，https://gitee.com/profile/sshkeys
          dst_key: ${{ secrets.GITEE_PRIVATE_KEY }}
          # 必选，Gitee 对应的用于创建仓库的 token，https://gitee.com/profile/personal_access_tokens
          dst_token:  ${{ secrets.GITEE_TOKEN }}
          # 如果是组织，指定组织即可，默认为用户 user
          # account_type: org
          # 直接取当前项目的仓库名
          static_list: ${{ github.event.repository.name }}
          # 还有黑、白名单，静态名单机制，可以用于更新某些指定库
          # static_list: 'repo_name,repo_name2'
          # black_list: 'repo_name,repo_name2'
          # white_list: 'repo_name,repo_name2'

3.在 Github 需要同步的仓库上添加 3 个 secrets: (Setting -> Secrets -> New repository secret)

GITEE_USER, 例如我的 gitee hua1995116
GITEE_PRIVATE_KEY，获取方法(如果已有，直接设置) – Gitee 公钥对应的私钥^[2]
- 新建 private key 方法：
- 生成 SSH 公钥^[3]
- 将 SSH 公钥添加到 Gitee 公钥^[4]
- 同时将公钥添加到 Github 项目的 secrets 中;
GITEE_TOKEN，获取方法 – Gitee 对应的用于创建仓库的 token^[5]新建 token 方法：
- 点击上面的链接并登录 Gitee, 点击“生成新令牌”，
- 添加描述，比如用处 – Github 仓库同步到 Gitee；
- 权限默认全选，点击提交，显示出生成的 token 值；（注意保存，需要填到 Github 的 secrets 中）