1. Migration Setup
1.1 Prerequisites
Before starting the migration, ensure you have the following:
- Access to both Redmine and GitLab instances
- API keys for both platforms
For a detailed guide on obtaining API keys, refer to Migrating project management software from Redmine to GitLab from Paul Cochrane .
1.2 Tool Installation
Install the migrator using pip:
pip install git+https://gitlab.git.nrw/git.nrw-public/templates/redmine-gitlab-migrator-fork
This is a modified version of the original migrator tool, tailored for the rate limits of the git.nrw GitLab instance.
1.3 User Mapping Configuration
Create a redmine-gitlab-user-map.yml file to map Redmine users to GitLab accounts:
John Smith: jsmith42
Emily Johnson: ejohns
Michael Williams: mwillia
Sarah Brown: sbrown1
2. Migration Execution
2.1 Migrating Issues
Use the following command to migrate issues:
migrate-rg issues \
--keep-title \
--user-dict redmine-gitlab-user-map.yml \
--redmine-key <REDMINE_API_KEY> \
--gitlab-key <GITLAB_API_KEY> \
https://redmine.de/projects/Project \
https://gitlab.git.nrw/projects/Project \
--no-sudo
2.2 Migrating Roadmaps
For roadmap migration:
migrate-rg roadmap \
--redmine-key <REDMINE_API_KEY> \
--gitlab-key <GITLAB_API_KEY> \
https://redmine.de/projects/Project \
https://gitlab.git.nrw/projects/Project
Key Parameters Explained:
--no-sudo: Required for GitLab instance compatibility--keep-title: Preserves original issue titles- User dictionary: Ensures proper author attribution