一、从github导入仓库,手动同步
在 Gitee 的项目主页,导入的仓库会会有一个同步的按钮,你只用点一下,即可与 Github 同步更新,但是注意这里的同步功能默认是强制同步。有点麻烦的是,我们需要在推送到 Github 后,再到 Gitee 项目主页手动点击一下。
二、推送两个仓库
可以通过本地仓库的形式,同时推送到github和gitee,相当于执行两次commit的操作,push两次。但显然也不是我想要的。
git remote add 远程库名 远程库地址
eg: git remote add gitee git@github.com:xxx/xxx.git
三、Github Actions 自动同步
官方的Action方法Github Action。可以参考阮一峰老师的《GitHub Actions 入门教程》
运用CI/CD的思想,从github中自动化的执行流程,完美符合我们的预期。
需要将SSH公钥传到 Gitee和GitHub 上,这样就可以实现 GitHub 和 Gitee 的通信。
Actions方法1:使用Yikun/hub-mirror-action@master
需要本机私钥和gitee私人令牌
在项目根目录新建.github/workflows/syncToGitee.yml脚本如下:
name: Sync to Gitee
on:
push:
branches: [master, gh-pages]
workflow_dispatch:
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Sync to Gitee
uses: Yikun/hub-mirror-action@master
with:
# 必选,需要同步的Github用户(源)
src: 'github/ytking'
# 必选,需要同步到的Gitee的用户(目的)
dst: 'gitee/ytanck'
# 必选,Gitee公钥对应的私钥
dst_key: ${{ secrets.GITEE_PRIVATE_KEY }}
# 必选,Gitee对应的用于创建仓库的token
dst_token: ${{ secrets.GITEE_TOKEN }}
# static_list 仓库名称 单一仓库同步
static_list: "ytking"
# 如果是组织,指定组织即可,默认为用户user
# account_type: org
# 还有黑、白名单,静态名单机制,可以用于更新某些指定库
# static_list: repo_name
# black_list: 'repo_name,repo_name2'
# white_list: 'repo_name,repo_name2'
# force_update 表示启用 git push -f 强制同步
force_update: true
# debug 为 true 表示启用 debug 开关,会显示所有执行命令
debug: true
src
表示需要被同步的源端账户名,即我们 Github 的账户名,因为我的 Github ID 是 ytking
,所以这里我应该改成 github/ytking
。
dst
表示需要同步到的目的端账户名,即我们 Gitee 的账户名,因为我的 Gitee ID 也是 ytanck
,所以这里我应该改成 gitee/ytanck
。
dst_key
表示用于在目的端上传代码的私钥SSH,然后将其保存在 Secrets 中。如何获取本机ssh请自行百度
复制私钥内容,然后在要同步的 Github 仓库中,选择 “Setting” -> “Secrets” -> “New repository secret”
如何获取GITEEN_TOKEN
在 Gitee 上创建一个私人令牌(token),这个记得保存,因为它只会出现一次
配置完成后我们push分支,使用Sync to Gitee的 Action的workflow已经运行起来了
Actions方法二:
使用 wearerequired/git-mirror-action@v1
在项目根目录新建.github/workflows/sync-gitee.yml脚本
name: Sync to Gitee
on:
push:
branches: [master, gh-pages]
workflow_dispatch:
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Sync to Gitee
uses: wearerequired/git-mirror-action@v1
env:
# 在 Settings->Secrets 配置 GITEE_PRIVATE_KEY
SSH_PRIVATE_KEY: ${{ secrets.GITEE_PRIVATE_KEY }}
with:
# GitHub 源仓库地址
source-repo: git@github.com:ytking/monorepo-pnpm.git
# Gitee 目标仓库地址
destination-repo: git@gitee.com:ytanck/monorepo-pnpm.git
GITEE_PRIVATE_KEY
就是本机的SSH私钥
,如何获取shh请自行百度。另外方法二需要配置公钥,方法如下:复制id_rsa.pub
,
配置完成后,但你再push master分支时就会触发工作流的Action
此时就会发现Gitee也同步更新了
注:方法一如果不指定仓库,会自动同步所有仓库,方法二是针对某一仓库去同步。
如果有错误的地方,请务必给予指正,十分感谢。如果喜欢或者有所启发,欢迎 star。