Requirements

• Python 3.5+ (Debian Stretch+, Ubuntu Xenial+)

• virtualenv if you don’t want to mess with System Python

• git-remote-bzr https://github.com/felipec/git-remote-bzr for Bazaar support

Features

• Mirror different types of source repositories: Bazaar, Git, Subversion. Mirror all into git.

• GitLab mirror adding.

  • When adding a mirror if the project doesn’t exist in GitLab it will be auto-created.

  • Set project creation defaults (e.g. issues enabled, wiki enabled, etc.)

• Github mirror adding.

  • Same as with Gitlab.

• mirror anything to Git (not just Gitlab and Github).

• Update a single mirror.

• Update all known mirrors.

On Debian

For Bazaar support:

$ apt install git-remote-bzr

Install into a virtualenv:

$ virtualenv -p /usr/bin/python3 --no-site-packages venv
$ venv/bin/pip install "vcs-mirrors[gitlab,github]"

Then copy vcs-mirrors.yaml.example into your current-working-directory:

$ cp venv/lib/python3.6/site-packages/vcs-mirrors/vcs-mirrors.yaml.sample vcs-mirrors.yaml

Edit it for your needs.

venv/bin/vcs-mirrors -h
venv/bin/vcs-mirrors add -h

add examples:

This one try to create a repo “pcdummy/proxmox-dockerfiles” on git.lxch.eu - the identifier must be unique in the config file:

$ vcs-mirrors add me/p-dockerfiles https://github.com/pcdummy/proxmox-dockerfiles.git git.lxch.eu:pcdummy/proxmox-dockerfiles

This doesn’t:

$ vcs-mirrors add me/p-dockerfiles https://github.com/pcdummy/proxmox-dockerfiles.git git@git.lxch.eu:pcdummy/proxmox-dockerfiles.git

Full mirroring include “prune” and “force” pull/push:

$ vcs-mirrors add -f -p me/p-dockerfiles https://github.com/pcdummy/proxmox-dockerfiles.git git.lxch.eu:pcdummy/proxmox-dockerfiles

If you give an host as target “add” creates the repo on the host and translates it to a git URL else add does nothing else than adding the params to your configuration file.

$ pip install -e ."[development,gitlab,github]"

0.0.7 (2018-04-23)

• Fix pip install by moving away of PEP 420 Namespaces. [pcdummy]

0.0.6 (2018-04-23)

• Fix another typo in MANIFEST.in. [pcdummy]

0.0.5 (2018-04-23)

• Include python files in the pip packages, part2. [pcdummy]

0.0.4 (2018-04-23)

• Include python files in the pip packages. [pcdummy]

0.0.3 (2018-04-22)

• Add another debug line (to show CWD changes). [pcdummy]

• Add tag pushes. [pcdummy]

• Make mirroring finaly working by using “–mirror”. [pcdummy]

0.0.2 (2018-04-21)

• Fixup classifiers. [pcdummy]

0.0.1 (2018-04-21)

• Initial Release. [pcdummy]