Gå til hovedinnhold

Sjekkliste før migrering

Før du migrerer, går du gjennom denne sjekklisten mot det eksisterende miljøet ditt for å avdekke forholdene som gir overraskelser midt i en migrering: for store repositoryer, tunge LFS-samlinger, komplekse CI-pipelines og tredjepartsintegrasjoner som ikke kobler seg til igjen av seg selv.

Bruk skriptet (anbefalt)

Sjekklisten nedenfor kan gjøres for hånd, men fremforge leverer en skallbasert vurdering som automatiserer hver kontroll på denne siden. Den blar side for side gjennom oversiktene over repositoryer, medlemmer og webhooker hos kildeleverandøren og lager én Markdown-rapport som du kan legge ved migreringsticketen:

# 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 bare leser: det sender kun GET-kall mot API-et til kildeleverandøren og endrer aldri noe i miljøet ditt. Rapporten dekker det samme som den manuelle sjekklisten nedenfor, i tillegg til oversikter over repositoryer som tåler paginering (sikkerhetsgrense på 5000 repositoryer) og en kryssjekk av Marketplace-actions mot kompatibilitetsmatrisen. Det er ditt ansvar å skanne historikken etter secrets før migreringen: kjør gitleaks detect lokalt på alle repositoryer du er usikker på. gitleaks-pre-receive-hooken i fremforge blokkerer pusher som inneholder secrets den kjenner igjen; hvis en eldre commit utløser den, følger du runbooken for secrets i historikken. Send utdataene fra skriptet på e-post til support@frem.sh hvis du vil at en fremforge-ingeniør skal gå gjennom dem med deg før migreringsdagen.

Hvis du vil ha maskinlesbare utdata til migreringsticketen, legger du til --json før plattformargumentet:

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

JSON-strukturen speiler Markdown-rapporten (størrelse, LFS og antall webhooker per repository, Marketplace-kryssjekken, listen over blokkeringer og advarsler), så den kan sammenlignes mellom kjøringer før og etter migreringen eller legges ved en ticket.

Sjekkliste før migrering

Før du migrerer, kontroller:

  • Antall repositoryer og samlet størrelse (bruk git count-objects -vH i hvert repository)
  • LFS-objekter: kjør git lfs ls-files for å finne filene som spores med LFS, og størrelsen deres
  • CI-workflowfiler: sjekk .github/workflows/ eller .gitlab-ci.yml for syntaks og action-referanser som må oppdateres for fremforge
  • Regler for branchbeskyttelse: noter påkrevde statussjekker, påkrevde godkjennere og begrensninger på force-push, slik at du kan gjenskape dem i fremforge
  • Secrets og miljøvariabler: list opp alle secrets for repositoryer og organisasjoner som skal legges inn igjen etter migreringen
  • Eget Git-vertsnavn (for eksempel git.acme.com): viser noe av det eksisterende verktøyet, CI-konfigurasjonen, byggeskriptene eller onboarding-dokumentasjonen for utviklere til et eget Git-vertsnavn i stedet for kildeplattformens standarddomene? Hvis ja, les Migrering fra GitHub § Vanity CNAMEs før du migrerer. fremforge utsteder foreløpig ikke TLS-sertifikater for kundedomener med egen CNAME, og migreringsdagen er ikke tidspunktet for å oppdage det.

Hva du bør sjekke

Alle plattformer:

  • Antall repositoryer og størrelse. Alt over 500 MB gir en advarsel (importen går tregere); alt over 2 GB får et blokkeringsflagg (krever speilkloning).
  • Størrelsen på LFS-samlingen i repositoryer som bruker LFS.
  • Antall webhooker per repository: 3 eller flere webhooker gir en advarsel, slik at du dokumenterer hver av dem for å koble dem til igjen.

Spesifikt for GitHub:

  • Antall ulike Marketplace-actions det vises til på tvers av alle workflower. 10 eller flere ulike actions gir en oppfordring om å kryssjekke mot kompatibilitetsmatrisen for Marketplace.
  • Beskyttede brancher dokumenteres, slik at de kan gjenskapes i fremforge.
  • Actions-secrets, variabler og containerpakker på organisasjonsnivå må alle legges inn på nytt eller migreres separat.

Spesifikt for GitLab:

  • En heuristikk for kompleksiteten i .gitlab-ci.yml (stages, include:-referanser, extends:-kjeder, services:-sidevogner). Komplekse pipelines får en advarsel om tidsbruk.
  • Utrullinger med GitLab Pages flagges for manuell rekonfigurering.
  • Antall CI/CD-variabler på gruppenivå.

Spesifikt for Azure DevOps:

  • Antall klassiske pipelines (ikke YAML) flagges som blokkering. Konverter dem til YAML i ADO før du migrerer.
  • Antall pipelines: et stort volum flagges som en advarsel om tidsbruk.
  • Antall service connections flagges for erstatning med OIDC-føderasjon.
  • Antall variabelgrupper.
  • Antall testplaner flagges som blokkering, fordi fremforge ikke har noen direkte tilsvarende funksjon.

Hva sjekklisten dekker

Denne sjekklisten handler om klarhet for migrering, ikke om kodekvalitet eller sikkerhetsrevisjoner. Den:

  • vurderer ikke kodekvalitet, testdekning eller hvor ofte CI går grønt.
  • undersøker ikke secrets for følsomhet eller eksponering (bruk skanningen etter secrets i fremforges pre-receive etter migreringen til det).
  • kontrollerer ikke at workflowene er riktig skrevet, bare at de viser til et håndterlig antall eksterne actions.
  • vurderer ikke om funksjonene i fremforge passer teamets arbeidsflyt. Det hører hjemme i en salgssamtale, ikke på en sjekkliste.

For driftsdetaljer utover sjekklisten beskriver veiledningen for migrering fra GitHub, veiledningen for migrering fra GitLab og veiledningen for migrering fra Azure DevOps importen trinn for trinn.

Få hjelp

Hvis du får uventede funn og trenger hjelp til å tolke dem, send e-post til support@frem.sh. Kunder som er tidlig ute, har direkte tilgang til teamet som bygger fremforge, for hjelp med migreringen.

Se også: Veiledning for migrering fra GitHub · Veiledning for migrering fra GitLab · Veiledning for migrering fra Azure DevOps · Kompatibilitetsmatrise for de 20 mest brukte Marketplace-actions.

Secrets i historikken