42 lines
1.3 KiB
Markdown
42 lines
1.3 KiB
Markdown
|
# Git mirror
|
||
|
|
|
||
|
|
Run this script to synchronize a repository once.
|
||
|
|
|
||
|
|
## Dependencies
|
||
|
|
* bash
|
||
|
|
* git
|
||
|
|
* Tor and torify (see section "Tor")
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
```
|
||
|
|
./git-mirror.sh <workdir> <leader> <follower...>
|
||
|
|
```
|
||
|
|
|
||
|
|
## Get started
|
||
|
|
Create a git repo, add remotes for the leader and the followers:
|
||
|
|
```bash
|
||
|
|
mkdir ~/git-mirror-my-repo; cd ~/git-mirror-my-repo
|
||
|
|
git init
|
||
|
|
git remote add github https://github.com/interesting/repo
|
||
|
|
git remote add gitea ssh://git@git.example.org/me/interesting-repo
|
||
|
|
git remote add gitlab ssh://git@git.example.com/myself/interesting-repo
|
||
|
|
```
|
||
|
|
|
||
|
|
Make sure Tor is running (see section "Tor"). Then run the mirroring script:
|
||
|
|
```bash
|
||
|
|
cd
|
||
|
|
git clone https://git.zeus.gent/midgard/git-mirror.git; cd git-mirror
|
||
|
|
./git-mirror.sh ~/git-mirror-my-repo github gitea gitlab
|
||
|
|
```
|
||
|
|
The first remote, github is the leader. The others are followers that are updated.
|
||
|
|
|
||
|
|
## Tor
|
||
|
|
The leader is fetched over Tor through torify. Make sure Tor is running, or edit the script,
|
||
|
|
changing `torify git fetch` into `git fetch`.
|
||
|
|
|
||
|
|
## Motivation
|
||
|
|
GitHub has always been hypocritical, promoting open source while keeping its own stack closed. When
|
||
|
|
GitHub was bought by Microsoft, the author decided to stop using it. Unfortunately a lot of
|
||
|
|
software still only has a presence on GitHub. To make it easier to work with those, this simple
|
||
|
|
mirror script was written.
|