Guides de migration
Des parcours de migration pas à pas depuis les trois plateformes d’origine les plus courantes. Chaque guide couvre la migration des dépôts et de l’historique, les secrets et variables d’environnement, l’adaptation des workflows de CI, le réenregistrement des clés SSH et la reconnexion des intégrations tierces. Lisez d’abord la liste de contrôle avant migration pour repérer les dépôts trop volumineux, les gros volumes LFS, les dépendances à des actions Marketplace et la complexité des pipelines avant de commencer.
Analyseur en lecture seule pour GitHub, GitLab ou Azure DevOps. À lancer avant de commencer, pour connaître d’emblée les obstacles et les avertissements.
.com, GHEC ou GHES. Importateur natif et clonage miroir, adaptation d’Actions, revue avant lancement des 20 actions Marketplace les plus utilisées.
Toujours sur GitHub et GitHub Actions ? Créez des miroirs des dépôts pour que fremforge les analyse, envoyez des SBOM, lisez les résultats via l’API.
.com, autogéré ou Dedicated. Aplatissement des sous-groupes, modèles de conversion de GitLab CI vers Forgejo Actions.
Repos, Pipelines et Boards. Passage obligé des pipelines classiques au YAML, Service Connections vers la fédération OIDC, Work Items vers les tickets.
Par où commencer
Lancez la liste de contrôle avant migration sur votre organisation actuelle. Le script est en lecture seule et fait apparaître les situations qui provoquent des surprises en cours de migration, avant que vous n’y consacriez du temps. Si vous avez besoin d’aide pour interpréter le résultat, écrivez à support@frem.sh.
Ce que la migration conserve toujours
- L’historique Git, les branches et les tags, à l’identique.
- Les tickets avec leurs métadonnées (étiquettes, jalons, personnes assignées lorsqu’elles sont associées par adresse e-mail).
- Les pull requests / merge requests avec leurs commentaires et leur état de fusion.
- Les versions, pièces jointes binaires comprises.
- Le contenu du wiki.
Ce que la migration ne conserve pas automatiquement
- L’historique des exécutions de workflows de CI : les exécutions passées restent sur la plateforme d’origine ; les nouvelles repartent de zéro sur fremforge.
- Les valeurs des secrets : elles doivent être saisies à nouveau (une rotation au moment de la migration est vivement recommandée).
- Les intégrations tierces configurées sur la plateforme d’origine : webhooks, notifications Slack/Teams et hooks de déploiement doivent tous être reconnectés.
- Les bases d’alertes de sécurité propres à la plateforme d’origine (alertes Dependabot de GitHub, Security Dashboard de GitLab) : fremforge exécute sa propre analyse des dépendances et produit ses propres résultats, de façon indépendante.
- Les déploiements Pages et domaines personnalisés propres à la plateforme d’origine : voir le guide de chaque plateforme.
Compatibilité des 20 actions Marketplace les plus utilisées
La matrice de compatibilité des actions GitHub Marketplace les plus utilisées est publiée sur /fr/develop/marketplace-compat/ au lancement. La page est vérifiée action par action sur de vrais runners fremforge ; les quatre guides de migration citent directement les actions concernées là où elles comptent, pour que vous puissiez migrer sans attendre la matrice complète.
Obtenir de l’aide
Si vous êtes bloqué en cours de migration, écrivez à support@frem.sh avec un objet commençant par MIGRATION - suivi du nom de la plateforme. Les clients de la première heure ont un accès direct à l’équipe de développement fremforge pour l’aide à la migration, sans frais supplémentaires.