Naar de hoofdinhoud

Checklist vóór de migratie

Loop deze checklist voor de migratie door voor je bestaande tenant, zodat je de situaties vindt die midden in een migratie voor verrassingen zorgen: te grote repository’s, zware LFS-voorraden, complexe CI-pipelines en integraties van derden die niet vanzelf opnieuw verbinden.

Het script gebruiken (aanbevolen)

Je kunt de checklist hieronder met de hand doorlopen, maar fremforge levert een beoordeling als shellscript die elke controle op deze pagina automatiseert. Het bladert door de lijsten met repository’s, leden en webhooks van de bronprovider en levert één Markdown-rapport op dat je aan het migratieticket kunt toevoegen:

# Clone the migration tools (read-only — no fremforge account needed yet)
curl -sSL https://docs.frem.sh/tools/pre-migration-check.sh -o pre-migration-check.sh
chmod +x pre-migration-check.sh

# GitHub
GITHUB_TOKEN=<your-PAT> ./pre-migration-check.sh github <your-org> > report.md

# GitLab
GITLAB_TOKEN=<your-PAT> ./pre-migration-check.sh gitlab <your-group> > report.md

# Azure DevOps
ADO_TOKEN=<your-PAT> ./pre-migration-check.sh azure-devops <your-org> > report.md

Het script leest alleen: het doet uitsluitend GET-aanroepen naar de API van de bronprovider en wijzigt nooit iets in je tenant. Het rapport dekt hetzelfde terrein als de handmatige checklist hieronder, plus lijsten met repository’s die met paginering omgaan (met een veiligheidsgrens van 5000 repository’s) en een vergelijking van Marketplace-actions met de compatibiliteitsmatrix. Het scannen van de geschiedenis op secrets vóór de migratie is jouw verantwoordelijkheid: voer lokaal gitleaks detect uit op elke repository waarover je twijfelt. De gitleaks-pre-receive-hook van fremforge houdt pushes tegen die herkende secrets bevatten; zet een historische commit hem in werking, volg dan het draaiboek voor secrets in de geschiedenis. Mail de uitvoer van het script naar support@frem.sh als je wilt dat een engineer van fremforge hem vóór de migratiedag met je doorloopt.

Wil je machineleesbare uitvoer voor het migratieticket, geef dan --json mee vóór het platformargument:

GITHUB_TOKEN=<your-PAT> ./pre-migration-check.sh --json github <your-org> > report.json

De JSON-envelop volgt het Markdown-rapport (per repository de omvang, LFS en het aantal webhooks, de vergelijking met de Marketplace, de lijst met blokkades en waarschuwingen), zodat je runs van vóór en na de migratie kunt vergelijken of het rapport aan een ticket kunt toevoegen.

Checklist vóór de migratie

Controleer vóór de migratie:

  • Het aantal repository’s en de totale omvang (gebruik git count-objects -vH in elke repository)
  • LFS-objecten: voer git lfs ls-files uit om de bestanden die LFS volgt en hun omvang te vinden
  • CI-workflowbestanden: controleer .github/workflows/ of .gitlab-ci.yml op syntaxis en op verwijzingen naar actions die voor fremforge moeten worden aangepast
  • Regels voor branchbescherming: noteer verplichte statuschecks, verplichte reviewers en beperkingen op force-push, om ze in fremforge opnieuw in te stellen
  • Secrets en omgevingsvariabelen: maak een lijst van alle secrets van repository’s en de organisatie die je na de migratie opnieuw moet toevoegen
  • Eigen Git-hostnaam (bijvoorbeeld git.acme.com): verwijzen je bestaande tooling, CI-configuraties, buildscripts of onboardingdocumentatie voor ontwikkelaars naar een eigen Git-hostnaam in plaats van het standaarddomein van het bronplatform? Zo ja, lees dan GitHub-migratie § Vanity CNAMEs voordat je migreert: fremforge geeft op dit moment geen TLS-certificaten uit voor klantdomeinen met een eigen CNAME, en de migratiedag is niet het moment om daarachter te komen.

Wat je controleert

Alle platforms:

  • Het aantal repository’s en hun omvang. Alles boven 500 MB krijgt een waarschuwing (de importer is trager); alles boven 2 GB krijgt een blokkade (een mirror-clone is nodig).
  • De omvang van de LFS-voorraad bij repository’s die LFS gebruiken.
  • Het aantal webhooks per repository: bij 3 of meer webhooks volgt een waarschuwing, zodat je ze allemaal documenteert om ze opnieuw te verbinden.

Specifiek voor GitHub:

  • Het aantal verschillende Marketplace-actions waarnaar alle workflows verwijzen. Bij 10 of meer verschillende actions volgt een verzoek om ze te vergelijken met de compatibiliteitsmatrix voor de Marketplace.
  • Beschermde branches, gedocumenteerd om ze op fremforge opnieuw in te stellen.
  • Actions-secrets, variabelen en containerpakketten op organisatieniveau: die moeten allemaal opnieuw worden ingevoerd of apart worden gemigreerd.

Specifiek voor GitLab:

  • Een heuristiek voor de complexiteit van .gitlab-ci.yml (fasen, verwijzingen via include:, ketens van extends:, sidecars via services:). Complexe pipelines krijgen een waarschuwing over de benodigde tijd.
  • Deployments van GitLab Pages worden gemarkeerd om met de hand opnieuw in te stellen.
  • Het aantal CI/CD-variabelen op groepsniveau.

Specifiek voor Azure DevOps:

  • Het aantal klassieke pipelines (niet in YAML), gemarkeerd als blokkade. Zet ze vóór de migratie in ADO om naar YAML.
  • Het aantal pipelines: een groot aantal pipelines wordt gemarkeerd met een waarschuwing over de benodigde tijd.
  • Het aantal service connections, gemarkeerd om te vervangen door OIDC-federatie.
  • Het aantal variabelegroepen.
  • Het aantal testplannen, gemarkeerd als blokkade omdat fremforge geen direct equivalent heeft.

Reikwijdte van deze checklist

Deze checklist gaat over gereedheid voor de migratie, niet over codekwaliteit of beveiligingsaudits. Ze doet het volgende niet:

  • Codekwaliteit, testdekking of slagingspercentages van CI beoordelen.
  • Secrets beoordelen op gevoeligheid of blootstelling (gebruik daarvoor na de migratie de secret-scanning vóór ontvangst van fremforge).
  • Controleren of workflows correct zijn geschreven, alleen of ze naar een werkbaar aantal externe actions verwijzen.
  • Beoordelen of de functies van fremforge passen bij de werkwijze van je team. Dat is een onderwerp voor een verkoopgesprek, niet voor een checklist.

Voor operationele details buiten de checklist beschrijven de migratiegids voor GitHub, de migratiegids voor GitLab en de migratiegids voor Azure DevOps de importprocedures stap voor stap.

Hulp krijgen

Heb je onverwachte bevindingen en wil je hulp bij het interpreteren ervan, mail dan naar support@frem.sh. Klanten van het eerste uur hebben voor hulp bij de migratie direct toegang tot het buildteam van fremforge.

Zie ook: Migratiegids voor GitHub · Migratiegids voor GitLab · Migratiegids voor Azure DevOps · Compatibiliteitsmatrix voor de top-20 Marketplace-actions.

Secrets in de geschiedenis