IMPORTANT: This project is no longer actively maintained. It was last known to work with the GitLab version from 2014 and is unlikely to work with newer versions of GitLab with a different API. If you are interested in contributing or maintaining this project, please let us know.
This repository contains two scripts (dump_gitlab_json.py and
gitlab_to_stash.py) that export issues and code from GitLab to JIRA and Stash
respectively. Each script is described in more detail below.
This script attempts to export all of the issues (and the users associated with them) from GitLab to JIRA. I wrote it in a few hours, but it got the job done. I'm posting it on GitHub since other people may also find it useful.
usage: dump_gitlab_json.py [-h] [-d DATE_FILTER] [-e] [-i IGNORE_LIST]
[-p PASSWORD] [-P PAGE_SIZE] [-s] [-t TOKEN]
[-u USERNAME] [-v] [--version]
gitlab_url
Export all users/issues from GitLab to JIRA JSON format.
positional arguments:
gitlab_url The full URL to your GitLab instance.
optional arguments:
-h, --help show this help message and exit
-d DATE_FILTER, --date_filter DATE_FILTER
Only include issues, notes, etc. created after the
specified date. Expected format is YYYY-MM-DD
(default: 1970-01-01)
-e, --include_empty Include projects in output that do not have any
issues. (default: False)
-i IGNORE_LIST, --ignore_list IGNORE_LIST
List of project names to exclude from dump. (default:
None)
-p PASSWORD, --password PASSWORD
The password to use to authenticate if token is not
specified. If password and token are both unspecified,
you will be prompted to enter a password. (default:
None)
-P PAGE_SIZE, --page_size PAGE_SIZE
When retrieving result from GitLab, how many results
should be included in a given page?. (default: 20)
-s, --verify_ssl Enable SSL certificate verification (default: False)
-t TOKEN, --token TOKEN
The private GitLab API token to use for
authentication. Either this or username and password
must be set. (default: None)
-u USERNAME, --username USERNAME
The username to use for authentication, if token is
unspecified. (default: None)
-v, --verbose Print more status information. For every additional
time this flag is specified, output gets more verbose.
(default: 0)
--version show program's version number and exit
gitlab_to_stash.py clones all projects from GitLab and recreates them on
Stash. It attempts to replicate the GitLab's project/namespace hierarchy.
usage: gitlab_to_stash.py [-h] [-p PASSWORD] [-P PAGE_SIZE] [-s] [-S]
[-t TOKEN] [-u USERNAME] [-v] [--version]
gitlab_url stash_url
Transfer all projects/repositories from GitLab to Stash. Note: This script
assumes you have your SSH key registered with both GitLab and Stash.
positional arguments:
gitlab_url The full URL to your GitLab instance.
stash_url The full URL to your Stash instance.
optional arguments:
-h, --help show this help message and exit
-p PASSWORD, --password PASSWORD
The password to use to authenticate if token is not
specified. If password and token are both unspecified,
you will be prompted to enter a password. (default:
None)
-P PAGE_SIZE, --page_size PAGE_SIZE
When retrieving result from GitLab, how many results
should be included in a given page?. (default: 20)
-s, --verify_ssl Enable SSL certificate verification (default: False)
-S, --skip_existing Do not update existing repositories and just skip
them. (default: False)
-t TOKEN, --token TOKEN
The private GitLab API token to use for
authentication. Either this or username and password
must be set. (default: None)
-u USERNAME, --username USERNAME
The username to use for authentication, if token is
unspecified. (default: None)
-v, --verbose Print more status information. For every additional
time this flag is specified, output gets more verbose.
(default: 0)
--version show program's version number and exit
- Python 3 (although pull request to support 2 are welcome)
- Python GitLab API library
- Stashy Python library
- Admin access to GitLab is necessary to export private repositories
New BSD License (3-clause)