pfqgauxfb
/
gitlink_help_center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update 操作手册

Browse Source
main
maxjhandsome 1 year ago
parent 1844d84e0c
commit 50a4c83e6f
1 changed files with 17 additions and 13 deletions
Show Stats Download Patch File Download Diff File

26
docs/跨平台代码同步服务/操作手册
Unescape View File

@ -1,49 +1,53 @@
---
sidebar_label: '跨平台代码同步服务'
sidebar_position: 1
---
### 功能简介 ### 功能简介
跨平台仓库代码同步服务用于不同代码托管平台之间的仓库代码双向同步功能。用户将不同平台的仓库分支进行绑定，当任意仓库分支有push事件被webhook监听时，代码推送将实时自动同步至另一个仓库，以实现不同平台之间分支、提交信息的自动同步（代码托管平台仅限于github与gitee）。 跨平台仓库代码同步服务用于不同代码托管平台之间的仓库代码双向同步功能。用户将不同平台的仓库分支进行绑定，当任意仓库分支有push事件被webhook监听时，代码推送将实时自动同步至另一个仓库，以实现不同平台之间分支、提交信息的自动同步（代码托管平台仅限于github与gitee）。
![1.同步流程](../../static/img/reposyncer/1.同步流程.png)
![](/api/attachments/0509c679-dbb0-47d7-94d5-2a07b0912db7)
同步服务既满足双平台代码库分支同步需求，也支持最多创建三个平台的代码仓库同步，如下图所示 同步服务既满足双平台代码库分支同步需求，也支持最多创建三个平台的代码仓库同步，如下图所示
![](/api/attachments/3679de42-8b01-4d9c-ba6e-8cfc4ea9b553) ![2.同步方式](../../static/img/reposyncer/2.同步方式.png)
### 配置双向同步 ### 配置双向同步
1、进入需要创建同步的代码库“服务”tab，开通跨平台代码同步服务。 1、进入需要创建同步的代码库“服务”tab，开通跨平台代码同步服务。
![](/api/attachments/0ff1ec0c-ed60-40f0-9920-1019f4cd22d8) ![3.开启跨平台服务](../../static/img/reposyncer/3.开启跨平台服务.png)
2、配置跨平台的同步仓库，支持github和gitee。需输入代码库地址（git地址和网站访问地址均支持），以及配置对应token用于授权同步，此处须注意token的权限以及是否过期。 2、配置跨平台的同步仓库，支持github和gitee。需输入代码库地址（git地址和网站访问地址均支持），以及配置对应token用于授权同步，此处须注意token的权限以及是否过期。
Github配置方式为：个人头像→Settings→Developer Settings→Personal access tokens (classic)→Generate new token→勾选repo按钮→保存 Github配置方式为：个人头像→Settings→Developer Settings→Personal access tokens (classic)→Generate new token→勾选repo按钮→保存
Github配置方式为：个人头像→设置→私人令牌→生成新令牌→勾选projects权限→提交 Github配置方式为：个人头像→设置→私人令牌→生成新令牌→勾选projects权限→提交
![](/api/attachments/84e0aaa5-5b06-4b50-8d62-d1840083e1fd) ![4.配置同步仓库](../../static/img/reposyncer/4.配置同步仓库.png)
3、在首次创建同步仓库时，需要用户手动在目标仓库的代码库创建一条webhook，用于监听仓库push事件，从而向其他同步仓库推送代码完成同步，同步步骤如下： 3、在首次创建同步仓库时，需要用户手动在目标仓库的代码库创建一条webhook，用于监听仓库push事件，从而向其他同步仓库推送代码完成同步，同步步骤如下：
①点击“复制链接”按钮，复制平台用于接收webhook请求的地址 ①点击“复制链接”按钮，复制平台用于接收webhook请求的地址
![](/api/attachments/1af41823-53dd-40cf-9702-df05eff344a0) ![5.配置webhook](../../static/img/reposyncer/5.配置webhook.png)
②访问点击前往按钮前往目标仓库webhook页新建一个webhook，以github为例 ②访问点击前往按钮前往目标仓库webhook页新建一个webhook，以github为例
![](/api/attachments/7d67ab2d-d57f-4f18-aa64-bf112e10747b) ![6.webhook示例](../../static/img/reposyncer/6.webhook示例.png)
③粘贴链接，并确保该webhook支持push事件的监听，并已经成功激活 ③粘贴链接，并确保该webhook支持push事件的监听，并已经成功激活
![](/api/attachments/8304779b-776b-42a0-8b39-ad2e9c609336) ![7.webhook配置规则](../../static/img/reposyncer/7.webhook配置规则.png)
4、完成仓库配置绑定后，需要绑定这两个仓库的指定同步分支，建立首次同步方向。<font color=red>注：首次同步的策略为单向代码强推，请谨慎选择同步方向开启同步以避免代码被覆盖</font> 4、完成仓库配置绑定后，需要绑定这两个仓库的指定同步分支，建立首次同步方向。<font color=red>注：首次同步的策略为单向代码强推，请谨慎选择同步方向开启同步以避免代码被覆盖</font>
![](/api/attachments/27730e31-e971-4c13-8f4d-35d0f6a1f716) ![8.绑定分支](../../static/img/reposyncer/8.绑定分支.png)
5、完成分支的绑定，在绑定后会根据选择的同步方向立即执行一次同步。后续webhook监听到任意分支有代码推送，会实时向另一个绑定分支同步代码推送代码 5、完成分支的绑定，在绑定后会根据选择的同步方向立即执行一次同步。后续webhook监听到任意分支有代码推送，会实时向另一个绑定分支同步代码推送代码
![](/api/attachments/1fb36262-09bb-4ebf-afc6-9a64fc61b88e) ![9.确认绑定](../../static/img/reposyncer/9.确认绑定.png)
### 管理同步分支 ### 管理同步分支
@ -56,7 +60,7 @@ Github配置方式为：个人头像→设置→私人令牌→生成新令牌
⑤查询同步记录，包括查看历次同步的代码变更方，同步时间，同步状态及对应commt id，查询同步日志。 ⑤查询同步记录，包括查看历次同步的代码变更方，同步时间，同步状态及对应commt id，查询同步日志。
⑥中止、开启同步，相当于同步开关，可随时启停 ⑥中止、开启同步，相当于同步开关，可随时启停
![](/api/attachments/8e1722e5-36a0-48c2-a3f5-2b1378fe7f8b) ![同步分支管理](../../static/img/reposyncer/同步分支管理.png)
### 注意事项 ### 注意事项

Write Preview
Loading…
Cancel
Save