Skip to main content

Référence CLI pour les migrations en direct Enterprise

Informations détaillées sur l’utilisation de l’outil ELM CLI .

Installation

gh extension install github/gh-elm

L’extension nécessite GitHub CLI (gh) la version 2.0 ou ultérieure.

Commandes d’installation

CommandeDescription
gh elm configConfigurer de manière interactive les points de terminaison et les jetons pour l’utilisation d’ELM
gh elm config resetSupprimer la configuration stockée et les informations d’identification
gh elm config showAfficher la configuration actuelle, avec des jetons supprimés
gh elm completionGénérer un script d’autocomplétion pour le shell spécifié

Commandes de migration

CommandeDescription
gh elm migration listRépertorier les migrations
gh elm migration createCréer une nouvelle migration
gh elm migration start MIGRATION-IDDémarrer une migration créée précédemment
gh elm migration status MIGRATION-IDObtenir l’état et les détails d’une migration
gh elm migration watch MIGRATION-IDSurveiller la progression de la migration avec un affichage de mise à jour dynamique
gh elm migration pause MIGRATION-IDSuspendre une migration en cours d’exécution
gh elm migration resume MIGRATION-IDReprendre une migration suspendue
gh elm migration cancel MIGRATION-IDAnnuler et mettre fin à une migration
gh elm migration target-id MIGRATION-IDRechercher l’ID de migration cible (destination) d’une migration
gh elm migration cutover MIGRATION-IDLancer un basculement vers la destination d’une migration
gh elm migration cutover status MIGRATION-IDAfficher l’état de basculement et l’avancement d’une migration
gh elm migration cutover revert MIGRATION-IDAnnuler les effets d’un basculement afin que le référentiel source puisse être migré à nouveau

Certaines de ces commandes peuvent prendre des options supplémentaires. Consultez les sections ultérieures de cet article.

Commandes cibles

CommandeDescription
gh elm target mannequin reclaimRevendication (récupérer) un ou plusieurs mannequins sur l’organisation cible
gh elm target mannequin listRépertorier les mannequins d’une organisation cible en tant que CSV
gh elm target report requestDemander un rapport de nœud pour une migration
gh elm target report statusVérifier l’état du rapport de nœud d’une migration
gh elm target report urlObtenir une URL de téléchargement signée pour un rapport terminé
gh elm target resourcesRépertorier les ressources d’une migration à partir de la cible

Options gh elm migration create

Créez une migration pour préparer l’exportation et l’importation du référentiel.

FlagObligatoireDefaultDescription
--source-orgOuiN/ASlug de l’organisation source sur GitHub Enterprise Server
--source-repoOuiN/ANom du référentiel source
--target-orgOuiN/ASlug de l’organisation de destination sur GHE.com
--target-repoOuiN/ANom du référentiel de destination
--target-visibilityNoninternalVisibilité du référentiel de destination. Doit être private ou internal. Les référentiels publics ne sont pas pris en charge.
--startNonfalseDémarre automatiquement la migration après sa création
--jsonNonfalseSortie de la réponse JSON brute de l’API au lieu de texte lisible par l’homme

Options gh elm migration list

FlagObligatoireDefaultDescription
--statusNonN/AFiltre les résultats par état de migration. Valeurs valides : created, , queued, in_progress``paused``completed``failed, , . terminated
--page-sizeNonN/ANombre de résultats par page
--afterNonN/ACurseur pour la pagination, à partir d’une réponse précédente
--jsonNonfalseSortie de la réponse JSON brute de l’API au lieu de texte lisible par l’homme

Options gh elm migration cutover

FlagObligatoireDefaultDescription
--migration-idOuiN/AID d’une migration prête pour le transfert.
--forceNonfalsePar défaut, la commande vérifie si la cible de migration signale la préparation avant de continuer. Permet --force de contourner cette vérification lorsque vous êtes certain que l’état de migration est correct.
--watchNonfalseAprès avoir déclenché le basculement, passez en mode de surveillance en direct