Gå til hovedindhold

Tjekliste før migrering

Før du migrerer, så gå denne tjekliste igennem for din eksisterende tenant. Den finder de forhold, der giver overraskelser midt i en migrering: for store repositories, store LFS-mængder, komplekse CI-pipelines og tredjepartsintegrationer, der ikke forbinder sig igen af sig selv.

Brug scriptet (anbefales)

Du kan gå tjeklisten nedenfor igennem i hånden, men fremforge leverer en vurdering som shellscript, der automatiserer alle tjek på denne side. Den bladrer gennem kildeudbyderens lister over repos, medlemmer og webhooks og skriver én samlet Markdown-rapport, som du kan vedhæfte migreringssagen:

# 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

Scriptet læser kun: det sender udelukkende GET-kald til kildeudbyderens API og ændrer aldrig noget i din tenant. Rapporten dækker det samme som den manuelle tjekliste nedenfor, plus lister over repos, der håndterer sideinddeling (med en sikkerhedsgrænse på 5000 repos), og en krydstjek af Marketplace-actions mod kompatibilitetsmatrixen. Scanning af secrets i historikken er dit ansvar før migreringen: kør gitleaks detect lokalt på de repos, du er i tvivl om. fremforges gitleaks-pre-receive-hook blokerer push, der indeholder matchede secrets; hvis en gammel commit udløser den, så følg vejledningen om secrets i historikken. Send scriptets output til support@frem.sh, hvis du gerne vil gennemgå det med en fremforge-ingeniør før migreringsdagen.

Hvis du vil have maskinlæsbart output til migreringssagen, så angiv --json før platformsargumentet:

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

JSON-strukturen svarer til Markdown-rapporten (størrelse, LFS og antal webhooks pr. repo, krydstjek af Marketplace, liste over blokeringer og advarsler), så du kan sammenligne kørsler før og efter migreringen eller vedhæfte den til en sag.

Tjekliste før migrering

Kontrollér følgende, før du migrerer:

  • Antal repositories og samlet størrelse (brug git count-objects -vH i hvert repo)
  • LFS-objekter: kør git lfs ls-files for at finde de filer, LFS sporer, og deres størrelse
  • CI-workflowfiler: gennemgå .github/workflows/ eller .gitlab-ci.yml for syntaks og referencer til actions, der skal tilpasses til fremforge
  • Regler for branch-beskyttelse: notér påkrævede statustjek, påkrævede reviewere og begrænsninger på force-push, så du kan genskabe dem i fremforge
  • Secrets og miljøvariabler: lav en liste over alle secrets på repository- og organisationsniveau, så du kan tilføje dem igen efter migreringen
  • Eget Git-værtsnavn (f.eks. git.acme.com): henviser noget af dit eksisterende værktøj, dine CI-konfigurationer, build-scripts eller dokumentation til onboarding af udviklere til et eget Git-værtsnavn i stedet for kildeplatformens normale domæne? Hvis ja, så læs GitHub-migrering § Vanity CNAMEs, før du migrerer. fremforge udsteder i dag ikke TLS-certifikater til kundedomæner, der peger på os via CNAME, og migreringsdagen er ikke det rigtige tidspunkt at opdage det.

Hvad der skal tjekkes

Alle platforme:

  • Antal repositories og størrelse. Alt over 500 MB giver en advarsel (importen er langsommere); alt over 2 GB markeres som en blokering (kræver migrering via spejl-clone).
  • Størrelsen af LFS-data i repositories, der bruger LFS.
  • Antal webhooks pr. repository: 3 eller flere giver en advarsel, så du dokumenterer hver enkelt og kan forbinde dem igen.

Kun GitHub:

  • Antal forskellige Marketplace-actions, der henvises til på tværs af alle workflows. 10 eller flere forskellige actions udløser en opfordring til at krydstjekke dem mod kompatibilitetsmatrixen for Marketplace.
  • Beskyttede branches, som dokumenteres, så de kan genskabes i fremforge.
  • Actions-secrets, variabler og container-pakker på organisationsniveau, som alle skal indtastes igen eller migreres separat.

Kun GitLab:

  • En vurdering af kompleksiteten i .gitlab-ci.yml (stages, include:-referencer, extends:-kæder, services:-sidecars). Komplekse pipelines giver en advarsel om tidsforbruget.
  • Udrulninger til GitLab Pages markeres til manuel genopsætning.
  • Antal CI/CD-variabler på gruppeniveau.

Kun Azure DevOps:

  • Antal klassiske pipelines (uden YAML), som markeres som en blokering. Konvertér dem til YAML i ADO, før du migrerer.
  • Antal pipelines: mange pipelines giver en advarsel om tidsforbruget.
  • Antal service connections, som markeres, så de kan erstattes af OIDC-føderering.
  • Antal variable groups.
  • Antal testplaner, som markeres som en blokering, fordi fremforge ikke har noget direkte tilsvarende.

Hvad tjeklisten dækker

Tjeklisten handler om, hvorvidt du er klar til migreringen, ikke om kodekvalitet eller sikkerhedsrevision. Den:

  • vurderer ikke kodekvalitet, testdækning eller hvor ofte CI lykkes.
  • undersøger ikke secrets for følsomhed eller eksponering (brug fremforges scanning af secrets ved pre-receive til det efter migreringen).
  • validerer ikke, at workflows er skrevet korrekt, kun at de henviser til et overskueligt antal eksterne actions.
  • vurderer ikke, om fremforges funktioner passer til dit teams måde at arbejde på. Det er en samtale med salg, ikke et punkt på en tjekliste.

Ud over tjeklisten beskriver migreringsvejledningen til GitHub, migreringsvejledningen til GitLab og migreringsvejledningen til Azure DevOps importen trin for trin.

Få hjælp

Hvis du får uventede resultater og har brug for hjælp til at tolke dem, så skriv til support@frem.sh. Kunder, der er tidligt med, har direkte adgang til det team, der bygger fremforge, for at få hjælp til migreringen.

Se også: Migreringsvejledning til GitHub · Migreringsvejledning til GitLab · Migreringsvejledning til Azure DevOps · Kompatibilitetsmatrix for de 20 mest brugte Marketplace-actions.

Secrets i historikken