Aller au contenu principal

Liste de contrôle avant migration

Avant de migrer, parcourez cette liste de contrôle sur votre tenant existant afin de repérer les situations qui provoquent des surprises en cours de migration : dépôts trop volumineux, gros volumes LFS, pipelines CI complexes et intégrations tierces qui ne se reconnectent pas automatiquement.

Utiliser le script (recommandé)

La liste ci-dessous peut être parcourue à la main, mais fremforge fournit une évaluation en shell qui automatise toutes les vérifications de cette page. Elle parcourt page par page les listes de dépôts, de membres et de webhooks du fournisseur source et produit un unique rapport Markdown que vous pouvez joindre au ticket de migration :

# 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

Le script est en lecture seule : il n’émet que des appels GET vers l’API du fournisseur source et ne modifie jamais rien dans votre tenant. Le rapport couvre le même périmètre que la liste manuelle ci-dessous, avec en plus des listes de dépôts qui tiennent compte de la pagination (garde-fou à 5000 dépôts) et un croisement des actions de la Marketplace avec la matrice de compatibilité. L’analyse des secrets dans l’historique relève de votre responsabilité avant la migration : exécutez gitleaks detect localement sur tout dépôt qui vous inquiète. Le hook de pré-réception gitleaks de fremforge bloque les push contenant des secrets reconnus ; si un commit historique le déclenche, suivez le guide des secrets dans l’historique. Envoyez la sortie du script à support@frem.sh si vous souhaitez qu’un ingénieur fremforge la passe en revue avec vous avant le jour de la migration.

Pour obtenir une sortie lisible par machine pour le ticket de migration, passez --json avant l’argument de plateforme :

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

L’enveloppe JSON reprend le rapport Markdown (taille, LFS et nombre de webhooks par dépôt, croisement avec la Marketplace, liste des bloquants et avertissements), ce qui permet de la comparer entre les exécutions avant et après migration ou de la joindre à un ticket.

Liste de contrôle avant migration

Avant de migrer, vérifiez :

  • Le nombre de dépôts et leur taille totale (utilisez git count-objects -vH dans chaque dépôt)
  • Les objets LFS : exécutez git lfs ls-files pour identifier les fichiers suivis par LFS et leur taille
  • Les fichiers de workflow CI : vérifiez dans .github/workflows/ ou .gitlab-ci.yml la syntaxe et les références d’actions à mettre à jour pour fremforge
  • Les règles de protection des branches : notez les vérifications de statut requises, les relecteurs requis et les restrictions de force-push à recréer dans fremforge
  • Les secrets et variables d’environnement : listez tous les secrets de dépôt et d’organisation à ressaisir après la migration
  • Nom d’hôte Git personnalisé (par ex. git.acme.com) : vos outils, configurations CI, scripts de build ou documents d’accueil des développeurs font-ils référence à un nom d’hôte Git personnalisé plutôt qu’au domaine canonique de la plateforme source ? Si oui, consultez Migration depuis GitHub § CNAME personnalisés avant de migrer : fremforge n’émet pas actuellement de certificats TLS pour les domaines clients en CNAME personnalisé, et le jour de la migration n’est pas le moment de le découvrir.

Ce qu’il faut vérifier

Toutes les plateformes :

  • Nombre et taille des dépôts. Au-delà de 500 Mo, un avertissement est émis (l’import est plus lent) ; au-delà de 2 Go, un bloquant est signalé (passage obligatoire par un clone miroir).
  • Taille du volume LFS des dépôts qui déclarent LFS.
  • Nombre de webhooks par dépôt : 3 webhooks ou plus déclenchent un avertissement afin que vous documentiez chacun pour sa reconnexion.

Spécifique à GitHub :

  • Nombre de références distinctes à des actions de la Marketplace dans l’ensemble des workflows. 10 actions distinctes ou plus déclenchent une invitation à vérifier la matrice de compatibilité Marketplace.
  • Branches protégées, documentées pour être recréées sur fremforge.
  • Secrets, variables et paquets de conteneurs Actions au niveau de l’organisation, qui doivent tous être ressaisis ou migrés séparément.

Spécifique à GitLab :

  • Heuristique de complexité de .gitlab-ci.yml (stages, références include:, chaînes extends:, side-cars services:). Les pipelines complexes reçoivent un avertissement sur le temps à prévoir.
  • Déploiements GitLab Pages signalés pour une reconfiguration manuelle.
  • Nombre de variables CI/CD au niveau du groupe.

Spécifique à Azure DevOps :

  • Nombre de pipelines classiques (non YAML), signalés comme bloquants. Convertissez-les en YAML dans ADO avant de migrer.
  • Nombre de pipelines : un volume important est signalé par un avertissement sur le temps à prévoir.
  • Nombre de connexions de service, signalées pour un remplacement par la fédération OIDC.
  • Nombre de groupes de variables.
  • Nombre de Test Plans, signalés comme bloquants car fremforge n’a pas d’équivalent direct.

Périmètre de cette liste de contrôle

Cette liste couvre la préparation à la migration, pas la qualité du code ni les audits de sécurité. Elle ne :

  • n’évalue pas la qualité du code, la couverture de tests ni le taux de réussite de la CI ;
  • n’examine pas la sensibilité ou l’exposition des secrets (utilisez pour cela l’analyse des secrets en pré-réception de fremforge après la migration) ;
  • ne vérifie pas que les workflows sont correctement écrits, seulement qu’ils font référence à un nombre raisonnable d’actions externes ;
  • n’évalue pas si les fonctionnalités de fremforge correspondent au mode de travail de votre équipe. C’est un sujet pour un échange commercial, pas un point de liste de contrôle.

Pour les détails opérationnels au-delà de cette liste, le guide de migration depuis GitHub, le guide de migration depuis GitLab et le guide de migration depuis Azure DevOps décrivent pas à pas les procédures d’import.

Obtenir de l’aide

Si vous obtenez des résultats inattendus et avez besoin d’aide pour les interpréter, écrivez à support@frem.sh. Les clients précoces ont un accès direct à l’équipe de développement de fremforge pour l’accompagnement à la migration.

Voir aussi : Guide de migration depuis GitHub · Guide de migration depuis GitLab · Guide de migration depuis Azure DevOps · Matrice de compatibilité des 20 principales actions de la Marketplace.

Secrets dans l’historique