ob-repository-synchronize

Description

ob-repository-synchronize is a small tool which can help engineer to master their open source production’s code synchronization between GitHub, Gitee, CodeChina, internal repository and so on.

Principle

Base on git rebase

Base on git diff

backend

requirement

name	version	necessity
python	3.9	True
uvicorn	0.14.0	True
SQLAlchemy	1.4.21	True
fastapi	0.66.0	True
aiohttp	3.7.4	True
pydantic	1.8.2	True
starlette	0.14.2	True
aiomysql	0.0.21	True
requests	2.25.1	True
loguru	0.6.0	True
typing-extensions	4.1.1	True
aiofiles	0.8.0	True

how to install

[!NOTE] Run the code in python 3.9

pip3 install -r requirement.txt

python3 main.py

run the sync script locally

python3 sync.py

frontend

Refer the web readme

docker

docker pull XXX:latest

docker run -p 8000:8000 -d XXX bash start.sh -s backend

How to use it

1. Config your database

• Run the table.sql script in sql folder
• Config the database connection string in src/base/config.py

2. Config your repo address, branch, (todo token) by website

3. DIY yourself sync script (Refer the two example in sync folder) and run the sync script under a cronjob you should consider:

• http address or ssh address (how to add your ssh key)
• rebase logic or diff logic
• which cronjob (maybe the k8s cronjob or linux system crontab)

Issue Synchronization

The repository now supports synchronizing issues between different Git platforms:

Gitee to GitLink Issue Synchronization

A new feature has been added to synchronize open issues from Gitee to GitLink repositories. This feature:

1. Only synchronizes open issues, ignoring closed ones
2. Checks for existing issues to avoid duplication
3. Doesn’t synchronize deleted issues
4. Synchronizes issue comments

Configuration

In your env.ini file, add the following section:

[ISSUE_SYNC]
gitee_token = your_gitee_token
gitlink_cookie = your_gitlink_cookie
webhook_secret = your_webhook_secret
auto_sync_enabled = true

[REPO_MAPPINGS]
gitee:gitlink:owner/repo = target_owner/target_repo
gitlink:gitee:owner/repo = target_owner/target_repo

For more details, see the Issue Sync Documentation.