Migratiegidsen
Stapsgewijze migratieroutes vanaf de drie meest gebruikte bronplatforms. Elke gids behandelt het migreren van repository’s en geschiedenis, secrets en omgevingsvariabelen, het aanpassen van CI-workflows, het opnieuw registreren van SSH-sleutels en het opnieuw koppelen van integraties van derden. Lees eerst de checklist voor de migratie, zodat te grote repository’s, zware LFS-opslag, afhankelijkheden van Marketplace-actions en complexe pipelines boven water komen voordat je begint.
Scanner met alleen leestoegang voor GitHub, GitLab of Azure DevOps. Voer hem uit voordat je begint, zodat je blokkades en waarschuwingen vooraf ziet.
.com, GHEC of GHES. Ingebouwde importer plus mirror-clone-route, aanpassen van Actions, beoordeling vóór de lancering van de top 20 Marketplace-actions.
Zit je nog op GitHub en GitHub Actions? Spiegel repository's zodat fremforge ze scant, upload SBOM's en lees bevindingen via de API.
.com, self-managed of Dedicated. Subgroepen platslaan, patronen om GitLab CI om te zetten naar Forgejo Actions.
Repos, Pipelines en Boards. Classic pipelines eerst naar YAML, Service Connections naar OIDC-federatie, Work Items naar issues.
Waar je begint
Voer de checklist voor de migratie uit tegen je huidige tenant. Het script heeft alleen leestoegang en brengt situaties aan het licht die halverwege de migratie voor verrassingen zorgen, nog voordat je er tijd in steekt. Heb je hulp nodig bij het lezen van de uitvoer, mail dan naar support@frem.sh.
Wat de migratie altijd behoudt
- Git-geschiedenis, branches en tags, exact.
- Issues met metadata (labels, mijlpalen, toegewezen personen voor zover ze via e-mail te koppelen zijn).
- Pull requests en merge requests met opmerkingen en merge-status.
- Releases, inclusief binaire bijlagen.
- Wiki-inhoud.
Wat de migratie niet automatisch behoudt
- De geschiedenis van CI-workflowruns: historische runs blijven op het bronplatform, nieuwe runs beginnen opnieuw op fremforge.
- Waarden van secrets: die moet je opnieuw invoeren (roteren tijdens de migratie wordt sterk aangeraden).
- Integraties van derden die bij de bron zijn ingesteld: webhooks, meldingen in Slack/Teams en deploy-hooks moet je allemaal opnieuw koppelen.
- Bronspecifieke advisory- en beveiligingsdatabases (Dependabot-alerts van GitHub, het Security Dashboard van GitLab): fremforge voert zijn eigen dependency-scans uit en levert onafhankelijk zijn eigen bevindingen.
- Bronspecifieke Pages-deployments en eigen domeinen: zie de gids per platform.
Compatibiliteit van de top 20 Marketplace-actions
De compatibiliteitsmatrix voor de meest gebruikte GitHub Marketplace-actions verschijnt bij de lancering op /marketplace-compat/. De pagina wordt action voor action geverifieerd op echte fremforge-runners; de migratiegidsen noemen specifieke actions ter plekke waar dat ertoe doet, zodat je kunt migreren zonder op de volledige matrix te wachten.
Hulp krijgen
Zit je halverwege een migratie vast, mail dan naar support@frem.sh met een onderwerpregel die begint met MIGRATION - en de naam van het platform. Early-adopter-klanten krijgen zonder extra kosten rechtstreeks hulp van het bouwteam van fremforge bij hun migratie.