Migrationsleitfäden
Schritt-für-Schritt-Migrationswege von den drei häufigsten Quellplattformen. Jeder Leitfaden behandelt die Migration von Repositorys und Historie, Secrets und Umgebungsvariablen, die Anpassung von CI-Workflows, das erneute Registrieren von SSH-Schlüsseln und das Wiederverbinden von Integrationen von Drittanbietern. Lies zuerst die Checkliste vor der Migration, damit übergroße Repositorys, große LFS-Bestände, Abhängigkeiten von Marketplace-Actions und komplexe Pipelines sichtbar werden, bevor du anfängst.
Schreibgeschützter Scanner für GitHub, GitLab oder Azure DevOps. Führe ihn vor dem Start aus, um Blocker und Warnungen frühzeitig zu finden.
.com, GHEC oder GHES. Nativer Importer und Mirror-Clone-Weg, Anpassung von Actions, Prüfung der Top-20-Marketplace-Actions vor dem Launch.
Noch auf GitHub und GitHub Actions? Spiegle Repositorys, damit fremforge sie scannt, lade SBOMs hoch und lies Befunde über die API.
.com, selbst verwaltet oder Dedicated. Abflachen von Untergruppen, Muster für die Umstellung von GitLab CI auf Forgejo Actions.
Repos, Pipelines und Boards. Hürde von Classic-Pipelines zu YAML, Service Connections zu OIDC-Föderation, Work Items zu Issues.
Wo du anfängst
Führe die Checkliste vor der Migration gegen deinen aktuellen Mandanten aus. Das Skript ist schreibgeschützt und zeigt die Umstände, die mitten in einer Migration für Überraschungen sorgen, bevor du Zeit investierst. Wenn du Hilfe beim Deuten der Ausgabe brauchst, schreib an support@frem.sh.
Was die Migration immer erhält
- Git-Historie, Branches und Tags, exakt.
- Issues mit Metadaten (Labels, Meilensteine, Zuständige, sofern über die E-Mail-Adresse zugeordnet).
- Pull- und Merge-Requests mit Kommentaren und Merge-Status.
- Releases einschließlich binärer Anhänge.
- Wiki-Inhalte.
Was die Migration nicht automatisch erhält
- Die Historie der CI-Workflow-Läufe: Frühere Läufe bleiben auf der Quellplattform, neue Läufe beginnen frisch auf fremforge.
- Werte von Secrets: Sie müssen neu eingegeben werden (eine Rotation zum Zeitpunkt der Migration wird dringend empfohlen).
- An der Quelle konfigurierte Integrationen von Drittanbietern: Webhooks, Slack-/Teams-Benachrichtigungen und Deploy-Hooks müssen alle neu verbunden werden.
- Quellspezifische Advisory- und Sicherheitsdatenbanken (GitHub-Dependabot-Alerts, GitLab Security Dashboard): fremforge führt seinen eigenen Abhängigkeits-Scan aus und erzeugt unabhängig davon eigene Befunde.
- Quellspezifische Pages-Deployments und eigene Domains, siehe den Leitfaden der jeweiligen Plattform.
Top-20-Marketplace-Kompatibilität
Die Kompatibilitätsmatrix für die meistgenutzten GitHub-Marketplace-Actions erscheint zum Launch unter /marketplace-compat/. Die Seite wird Action für Action gegen echte fremforge-Runner geprüft; die vier Migrationsleitfäden nennen bestimmte Actions direkt dort, wo sie wichtig sind, sodass du migrieren kannst, ohne auf die vollständige Matrix zu warten.
Hilfe bekommen
Wenn du mitten in einer Migration feststeckst, schreib an support@frem.sh mit einer Betreffzeile, die mit MIGRATION - und dem Namen der Plattform beginnt. Kunden aus dem Early-Adopter-Programm haben ohne Aufpreis direkten Zugang zum Entwicklungsteam von fremforge, wenn sie Hilfe bei der Migration brauchen.