Migreringsguider
Steg-för-steg-vägar för migrering från de tre vanligaste källplattformarna. Varje guide täcker migrering av repon och historik, secrets och miljövariabler, anpassning av CI-workflows, ny registrering av SSH-nycklar och återanslutning av tredjepartsintegrationer. Läs checklistan före migrering först, så hittar du för stora repon, tunga LFS-lager, beroenden till Marketplace-actions och komplexa pipelines innan du börjar.
Skanner med enbart läsbehörighet för GitHub, GitLab eller Azure DevOps. Kör den innan du börjar, så ser du hinder och varningar från början.
.com, GHEC eller GHES. Inbyggd importör och spegelkloning, anpassning av Actions, genomgång av de 20 mest använda Marketplace-actions före lansering.
Kvar på GitHub och GitHub Actions? Spegla repona så att fremforge skannar dem, ladda upp SBOM:er och läs fynd via API:t.
.com, självhanterad eller Dedicated. Utplattning av undergrupper, mönster för att konvertera GitLab CI till Forgejo Actions.
Repos, Pipelines och Boards. Krav på att klassiska pipelines först blir YAML, Service Connections till OIDC-federation, Work Items till issues.
Var du ska börja
Kör checklistan före migrering mot din nuvarande tenant. Skriptet har enbart läsbehörighet och lyfter fram förhållanden som annars ger överraskningar mitt i migreringen, innan du lagt någon tid. Om du behöver hjälp att tolka resultatet, mejla support@frem.sh.
Det här bevarar migreringen alltid
- Git-historik, branches och taggar, exakt.
- Issues med metadata (etiketter, milstolpar och tilldelade personer där de mappas via e-post).
- Pull requests och merge requests med kommentarer och merge-status.
- Releaser, inklusive binära bilagor.
- Wikiinnehåll.
Det här bevarar migreringen inte automatiskt
- Körningshistorik för CI-workflows: historiska körningar stannar på källplattformen och nya körningar börjar från noll på fremforge.
- Värden för secrets: de måste anges igen (vi rekommenderar starkt att du roterar dem i samband med migreringen).
- Tredjepartsintegrationer som är konfigurerade i källan: webhooks, aviseringar till Slack/Teams och driftsättningshooks behöver alla anslutas igen.
- Källplattformens egna databaser för säkerhetsbulletiner (Dependabot-aviseringar i GitHub, Security Dashboard i GitLab): fremforge kör sin egen beroendeskanning och tar fram sina egna fynd oberoende av dem.
- Källplattformens Pages-driftsättningar och egna domäner: se guiden för respektive plattform.
Kompatibilitet med de 20 mest använda Marketplace-actions
Kompatibilitetsmatrisen för de mest använda actions i GitHub Marketplace publiceras på /marketplace-compat/ vid lansering. Sidan verifieras action för action mot riktiga fremforge-runners. De fyra migreringsguiderna nämner specifika actions där de spelar roll, så du kan migrera utan att vänta på den fullständiga matrisen.
Få hjälp
Om du har kört fast mitt i en migrering, mejla support@frem.sh med en ämnesrad som börjar med MIGRATION - följt av plattformens namn. Kunder som är tidiga användare har direkt tillgång till fremforges utvecklingsteam för hjälp med migreringen utan extra kostnad.