Remarque
Enterprise Live Migrations est préversion publique et sujet à changement.
Notre instance est-elle GitHub Enterprise Server prête ?
ELM a été rétroporté vers les versions prises en charge. Pour l’utiliser, vous devez effectuer une mise à niveau vers l’une des versions mineures suivantes ou ultérieures :
3.20.23.19.63.18.93.17.15
Votre GitHub Enterprise Server instance doit également :
- Utilisez une URL HTTPS . Les URL HTTP ne sont pas prises en charge.
- Les migrations sont activées et le stockage blob est configuré. Vous pouvez vérifier ces paramètres dans la section « Migrations » de la console de gestion. Si ces paramètres ne sont pas déjà configurés, nous expliquerons comment les définir sur les valeurs par défaut dans Migration de votre référentiel avec Enterprise Live Migrations.
À quoi ressemblera notre organisation de destination ?
Vous pouvez migrer des dépôts vers une organisation nouvelle ou existante sur GHE.com. ELM crée l’organisation cible si elle n’existe pas déjà.
Une migration de plateforme est une bonne occasion de reconsidérer votre organisation et votre structure d’équipe. Consultez « Meilleures pratiques pour organiser le travail dans votre entreprise ».
Quels référentiels migrerons-nous ?
ELM Soutient jusqu’à **10** migrations de référentiels simultanés à partir d’une seule GitHub Enterprise Server instance et **20** migrations simultanées par entreprise de destination.
Planifiez quels référentiels vous allez migrer en premier avec ELM, et lesquels vous pouvez migrer plus tard ou à l’aide d’un autre outil de migration. Les dépôts les plus susceptibles de bénéficier de ELM sont :
- Dépôts importants où de longues périodes de temps d’arrêt perturberaient votre activité
- Monorepos trop grands pour d’autres outils de migration.
Les dépôts publics ne sont pas disponibles sur GHE.com, et ceux-ci seront rejetés par ELM. Vous pouvez modifier la visibilité de ces dépôts GitHub Enterprise Server avant de commencer.
Vous devez vérifier que les référentiels que vous choisissez ne contiennent pas de ressources de mise en production supérieures à 2 Go, car il s’agit de la limite pour ELM.
Qui va exécuter la migration ?
La personne qui exécute une ELM migration doit :
- Disposer d’un accès administrateur de site à l’instance GitHub Enterprise Server
- Être propriétaire d’entreprise sur l’entreprise GHE.com
Cette personne doit effectuer les tâches suivantes :
- Avant la migration, créez personal access tokens (classic) sur l’entreprise source et de destination.
- Pendant la migration, surveillez l’état de la migration et répondez aux problèmes.
Pour les migrations simultanées ELM à partir d’une GitHub Enterprise Server instance, la même personne doit exécuter toutes les elm commandes à l’aide des mêmes jetons.
Après la migration, une personne doit effectuer certaines tâches de suivi sur GHE.com. Tout propriétaire de l’organisation peut le faire.
Que doivent savoir mes développeurs ?
Avant de commencer, communiquez avec les développeurs qui :
- Le dépôt passe à un nouvel emplacement. Les utilisateurs peuvent continuer à utiliser le référentiel source pendant la migration jusqu’à ce que l’opérateur commence le basculement final vers le nouvel emplacement.
- Bien que la migration soit en cours, les développeurs doivent éviter les push forcés vers le référentiel, car ceux-ci interrompent l’historique Git d’une manière qui ELM ne peut pas être résolue.
- Certaines actions effectuées par les développeurs pendant le processus de migration peuvent ne pas être reflétées dans le référentiel migré. Pour plus d’informations, consultez les actions non prises en charge dans Données migrées pour les migrations dynamiques de GitHub Enterprise Server vers GHE.com.
Étapes suivantes
Lorsque vous êtes prêt à exécuter une migration, consultez Migration de votre référentiel avec Enterprise Live Migrations.