Migration von Redmine

Migrations

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‑Map­ping‑Konfi­guration

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

Weitere Ressourcen und Referenzen