Hoppa till huvudinnehållet

Checklista före migrering

Innan du migrerar, gå igenom den här checklistan mot din befintliga tenant för att hitta det som orsakar överraskningar mitt i en migrering: för stora repon, tunga LFS-lager, komplexa CI-pipelines och tredjepartsintegrationer som inte ansluter igen av sig själva.

Använd skriptet (rekommenderas)

Checklistan nedan kan köras för hand, men fremforge levererar en skalbaserad bedömning som automatiserar varje kontroll på den här sidan. Den bläddrar sida för sida igenom källplattformens listor över repon, medlemmar och webhooks och tar fram en enda Markdown-rapport som du kan bifoga till migreringsärendet:

# 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

Skriptet är skrivskyddat: det gör bara GET-anrop mot källplattformens API och ändrar aldrig något i din tenant. Rapporten täcker samma områden som den manuella checklistan nedan, plus listor över repon som hanterar sidindelning (en säkerhetsgräns på 5000 repon) och en jämförelse av Marketplace-actions mot kompatibilitetsmatrisen. Att skanna efter secrets i historiken före migreringen är ditt ansvar: kör gitleaks detect lokalt på varje repo som du är orolig för. fremforges pre-receive-hook med gitleaks blockerar pushar som innehåller matchade secrets; om en äldre commit utlöser den, följ runbooken för secrets i historiken. Mejla skriptets utdata till support@frem.sh om du vill att en fremforge-ingenjör går igenom den med dig före migreringsdagen.

Om du vill ha maskinläsbar utdata till migreringsärendet anger du --json före plattformsargumentet:

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

JSON-strukturen speglar Markdown-rapporten (storlek + LFS + antal webhooks per repo, jämförelse av Marketplace-actions, lista över hinder och varningar), så att den kan jämföras mellan körningar före och efter migreringen eller bifogas till en issue.

Checklista före migrering

Innan du migrerar, kontrollera:

  • Antal repon och total storlek (använd git count-objects -vH i varje repo)
  • LFS-objekt: kör git lfs ls-files för att hitta filer som spåras med LFS och deras storlek
  • Arbetsflödesfiler för CI: kontrollera .github/workflows/ eller .gitlab-ci.yml med avseende på syntax och hänvisningar till actions som behöver uppdateras för fremforge
  • Regler för branch-skydd: anteckna obligatoriska statuskontroller, obligatoriska granskare och begränsningar för force-push som ska återskapas i fremforge
  • Secrets och miljövariabler: lista alla secrets för repon och organisationen som ska läggas till igen efter migreringen
  • Eget Git-värdnamn (t.ex. git.acme.com): hänvisar något av dina befintliga verktyg, CI-konfigurationer, byggskript eller introduktionsdokument för utvecklare till ett eget Git-värdnamn i stället för källplattformens kanoniska domän? Om ja, läs Migrering från GitHub § Vanity CNAMEs innan du migrerar: fremforge utfärdar i dag inga TLS-certifikat för kunddomäner med egen CNAME, och migreringsdagen är inte rätt tillfälle att upptäcka det.

Vad som kontrolleras

Alla plattformar:

  • Antal repon och storlek. Allt över 500 MB får en varning (importen går långsammare); allt över 2 GB flaggas som hinder (kräver kloning via spegel).
  • LFS-lagrets storlek i repon som deklarerar LFS.
  • Antal webhooks per repo: 3 eller fler webhooks ger en varning, så att du dokumenterar var och en för att ansluta dem igen.

Specifikt för GitHub:

  • Antal olika hänvisningar till Marketplace-actions i alla arbetsflöden. 10 eller fler olika actions ger en uppmaning att jämföra mot kompatibilitetsmatrisen för Marketplace.
  • Skyddade brancher, som dokumenteras för att återskapas i fremforge.
  • Actions-secrets, variabler och containerpaket på organisationsnivå, som alla måste anges igen eller migreras separat.

Specifikt för GitLab:

  • En heuristik för hur komplex .gitlab-ci.yml är (steg, hänvisningar med include:, kedjor med extends:, sidecars med services:). Komplexa pipelines får en varning om tidsåtgång.
  • Driftsättningar med GitLab Pages flaggas för manuell omkonfiguration.
  • Antal CI/CD-variabler på gruppnivå.

Specifikt för Azure DevOps:

  • Antal klassiska pipelines (inte YAML), som flaggas som hinder. Konvertera dem till YAML i ADO innan du migrerar.
  • Antal pipelines: en stor mängd pipelines flaggas med en varning om tidsåtgång.
  • Antal service connections, som flaggas för att ersättas med OIDC-federation.
  • Antal variabelgrupper.
  • Antal testplaner, som flaggas som hinder eftersom fremforge inte har någon direkt motsvarighet.

Vad checklistan omfattar

Den här checklistan handlar om beredskap för migrering, inte om granskning av kodkvalitet eller säkerhet. Den gör inte följande:

  • Bedömer kodkvalitet, testtäckning eller hur ofta CI går igenom.
  • Undersöker hur känsliga eller exponerade secrets är (använd fremforges secret-skanning vid pre-receive efter migreringen för det).
  • Kontrollerar att arbetsflöden är korrekt skrivna, bara att de hänvisar till ett hanterbart antal externa actions.
  • Bedömer om fremforges funktioner passar ditt teams arbetssätt. Det är en fråga för ett säljsamtal, inte en punkt på en checklista.

För driftdetaljer utöver checklistan beskriver guiden för migrering från GitHub, guiden för migrering från GitLab och guiden för migrering från Azure DevOps importen steg för steg.

Få hjälp

Om du får oväntade resultat och behöver hjälp att tolka dem, mejla support@frem.sh. Kunder som är tidiga användare har direktkontakt med fremforges utvecklingsteam för hjälp med migreringen.

Se även: Guide för migrering från GitHub · Guide för migrering från GitLab · Guide för migrering från Azure DevOps · Kompatibilitetsmatris för de 20 vanligaste Marketplace-actions.

Secrets i historiken