Skip to content

Latest commit

 

History

History
59 lines (44 loc) · 1.41 KB

README.md

File metadata and controls

59 lines (44 loc) · 1.41 KB
Raw

Gitlab Sync

This is a helper python program which downloads remote Gitlab repo(s) with support for group / sub-groups.

The program accepts a single top-level group-id, which it will use to traverse through the sub-groups to perform agit [clone|pull] command using ssh.

Requires

  • gitlab api token
  • gitlab configured with ssh-key

Install

git clone [email protected]:nabadger/gitlab-sync.git
cd gitlab-sync
python3 -m pip install .

To uninstall:

python3 -m pip uninstall gitlab-sync

Run

gitlab-sync --help

usage: gitlab-sync [-h] [--group-id GROUP_ID]
                      [--local-repo-path LOCAL_REPO_PATH]
                      [--gitlab-token GITLAB_TOKEN] [--dry-run] [--no-dry-run]

optional arguments:
  -h, --help            show this help message and exit
  --group-id GROUP_ID   group id
  --local-repo-path LOCAL_REPO_PATH
                        local repo path (clone under this dir)
  --gitlab-token GITLAB_TOKEN
                        gitlab private token
  --dry-run             dry-run (do not do git commands)
  --no-dry-run          no-dry-run (do git commands)

Example

gitlab-sync \
	--group-id <numeric-gitlab-group-id> \
	--local-repo-path /tmp/mycheckouts \
	--gitlab-token <gitlab-api-token> \
	--no-dry-run

Finding the Group Id on Gitlab

The Group ID can be found by navigating to the Group (or SubGroup) settings page and expanding the General settings.