### 1. Migrations‑Setup
#### 1.1 Voraussetzungen Bevor Sie mit der Migration beginnen, stellen Sie sicher, dass Sie Folgendes haben:
- Zugriff auf beide Redmine‑ und GitLab‑Instanzen
- API‑Schlüssel für beide Plattformen
- Eine Python installation mit pip
Für eine detaillierte Anleitung zum Abrufen von API‑Schlüsseln siehe Migrating project management software from Redmine to GitLab from Paul Cochrane .
#### 1.2 Tool‑Installation Installieren Sie den Migrator mit pip:
pipx install git+https://gitlab.git.nrw/git.nrw-public/templates/redmine-gitlab-migrator-fork
Dies ist eine modifizierte Version des ursprünglichen Migrator‑Tools, angepasst an die Rate‑Limits der GitLab‑Instanz von git.nrw.
1.3 Benutzer‑Mapping‑Konfiguration
Erstellen Sie eine redmine-gitlab-user-map.yml Datei, um Redmine‑Benutzer:innen GitLab‑Accounts zuzuordnen:
John Smith: jsmith42
Emily Johnson: ejohns
Michael Williams: mwillia
Sarah Brown: sbrown1
2. Migrationsausführung
2.1 Migration von Issues
Verwenden Sie den folgenden Befehl, um Issues zu migrieren:
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 Migration von Roadmaps
Für die Migration von Roadmaps:
migrate-rg roadmap \
--redmine-key <REDMINE_API_KEY> \
--gitlab-key <GITLAB_API_KEY> \
https://redmine.de/projects/Project \
https://gitlab.git.nrw/projects/Project
Wichtige Parameter erklärt:
--no-sudo: Erforderlich für die Kompatibilität mit git.nrw--keep-title: Bewahrt die ursprünglichen Issue‑Titel--user-dict: Stellt die korrekte Zuordnung der Autoren sicher