現(xiàn)在很多開(kāi)發(fā)者都不滿足于只在一個(gè)代碼托管平臺(tái)活躍，將項(xiàng)目同時(shí)托管于 Gitee 和 GitHub 是目前國(guó)內(nèi)很多開(kāi)發(fā)者的選擇，既擁有更快的訪問(wèn)和代碼推拉速度，也可以和更多國(guó)際上的優(yōu)秀開(kāi)發(fā)者交流。

Gitee 的倉(cāng)庫(kù)鏡像管理功能在這兩天重新受到了開(kāi)發(fā)者們的關(guān)注，今天馬建倉(cāng)再次為大家介紹一下這個(gè)超方便的功能，方便各位開(kāi)發(fā)者更優(yōu)雅地將代碼在世界上最大的兩個(gè)代碼托管平臺(tái)之間同步。

什么是倉(cāng)庫(kù)鏡像管理

倉(cāng)庫(kù)鏡像管理功能用于配置和管理倉(cāng)庫(kù)鏡像；配置倉(cāng)庫(kù)鏡像可以實(shí)現(xiàn)不同平臺(tái)之間倉(cāng)庫(kù)分支、標(biāo)簽和提交信息的自動(dòng)同步。

簡(jiǎn)單來(lái)說(shuō)，就是你可以通過(guò)倉(cāng)庫(kù)鏡像管理功能實(shí)現(xiàn) Gitee 和 GitHub 兩個(gè)平臺(tái)的雙向自動(dòng)同步。

將 Gitee 的倉(cāng)庫(kù)鏡像至 GitHub

配置此鏡像后，當(dāng)你提交代碼到 Gitee 的倉(cāng)庫(kù)時(shí)，Gitee 會(huì)自動(dòng)向 GitHub 同步倉(cāng)庫(kù)。

將 GitHub 的倉(cāng)庫(kù)鏡像至 Gitee

你可以根據(jù)自身需求選擇自動(dòng)鏡像或手動(dòng)鏡像。

自動(dòng)鏡像：當(dāng)你提交代碼到 GitHub 鏡像倉(cāng)庫(kù)時(shí)，Gitee 會(huì)自動(dòng)從 GitHub 同步倉(cāng)庫(kù)。

手動(dòng)鏡像：只有你手動(dòng)點(diǎn)擊更新按鍵時(shí)，Gitee 才會(huì)從 GitHub 同步倉(cāng)庫(kù)。

倉(cāng)庫(kù)鏡像會(huì)同步以下內(nèi)容：

分支（Branches）

標(biāo)簽（Tags）

提交記錄（Commits）

如何為自己的倉(cāng)庫(kù)設(shè)置鏡像

以將 GitHub 的倉(cāng)庫(kù)鏡像至 Gitee 為例

進(jìn)入需要使用鏡像功能的倉(cāng)庫(kù)，進(jìn)入「管理」找到「?jìng)}庫(kù)鏡像管理」選項(xiàng)，點(diǎn)擊「添加鏡像」按鈕，如果你還沒(méi)有綁定 GitHub 帳號(hào)，請(qǐng)根據(jù)彈窗提示綁定 GitHub 帳號(hào)；

添加鏡像

在「鏡像方向」中選擇 Pull 方向；

在「鏡像倉(cāng)庫(kù)」下拉列表中選擇需要鏡像的倉(cāng)庫(kù)；

在「私人令牌」中輸入你的 GitHub 私人令牌；

私人令牌中必須包含對(duì)repo的訪問(wèn)授權(quán)，否則添加后鏡像不可用。

根據(jù)自身需求選擇是否勾選「自動(dòng)從 GitHub 同步倉(cāng)庫(kù)」

勾選后，將會(huì)在鏡像倉(cāng)庫(kù)中自動(dòng)生成 webhook 用于實(shí)現(xiàn)自動(dòng)鏡像。此功能需要你的個(gè)人令牌中包含對(duì) admin:repo_hook 的訪問(wèn)授權(quán)，否則會(huì)添加失敗。

點(diǎn)擊「添加」保存鏡像配置。

配置完成后，可以通過(guò)提交代碼到 Gitee 倉(cāng)庫(kù)或手動(dòng)更新鏡像的方式觸發(fā)鏡像操作。

一次提交，同步兩個(gè)倉(cāng)庫(kù)，更優(yōu)雅的倉(cāng)庫(kù)鏡像姿勢(shì)你 Get 到了嗎？

點(diǎn)擊后面的鏈接了解更多功能細(xì)節(jié)：https://gitee.com/help/articles/4336

注意事項(xiàng)

鏡像觸發(fā)的最短間隔時(shí)間為 5 分鐘；

只支持鏡像已綁定 GitHub 帳號(hào)授權(quán)訪問(wèn)的倉(cāng)庫(kù)；

更新請(qǐng)求一旦發(fā)出，除非強(qiáng)制停止，否則將無(wú)法中斷；

暫時(shí)不支持同步Git-LFS；

同步時(shí)間超過(guò) 30 分鐘視為超時(shí)，大型倉(cāng)庫(kù)不建議使用鏡像方式同步；

鏡像操作會(huì)覆蓋目標(biāo)倉(cāng)庫(kù)的分支、標(biāo)簽和提交記錄；請(qǐng)注意備份并小心使用。

單向?qū)胪瑯又С?/p>

同時(shí) Gitee 也支持從 GitHub 單向?qū)雮}(cāng)庫(kù)的操作。

點(diǎn)擊右上角+后選擇從 GitHub/GitLab 導(dǎo)入倉(cāng)庫(kù)，連接自己的 GitHub 賬號(hào)即可實(shí)現(xiàn)倉(cāng)庫(kù)的一鍵導(dǎo)入。