Remarque
Enterprise Live Migrations est préversion publique et sujet à changement.
Commandes elm migration
| Commande | Description |
|---|---|
elm migration create | Crée une migration pour un référentiel source unique |
elm migration start --migration-id MIGRATION-ID | Démarre une migration |
elm migration status --migration-id MIGRATION-ID | Affiche l’état, la progression, la préparation au basculement et le calendrier d’une migration |
elm migration list | Répertorie toutes les migrations et leurs états |
elm migration cancel --migration-id MIGRATION-ID | Annule une migration en cours |
elm migration cutover-to-destination --migration-id MIGRATION-ID | Lance le basculement final, verrouille le référentiel source et termine la migration |
Certaines de ces commandes peuvent prendre des options supplémentaires. Consultez les sections ultérieures de cet article.
Options elm migration create
Créez une migration pour préparer l’exportation et l’importation du référentiel.
| Flag | Obligatoire | Default | Description |
|---|---|---|---|
--source-org | Oui | N/A | Slug de l’organisation source sur GitHub Enterprise Server |
--source-repo | Oui | N/A | Nom du référentiel source |
--target-org | Oui | N/A | Slug de l’organisation de destination sur GHE.com |
--target-repo | Oui | N/A | Nom du référentiel de destination |
--target-api | Oui | N/A | URL de l’API pour votre entreprise de destination (par exemple : https://api.octocorp.ghe.com). N’incluez pas de barre oblique finale dans l’URL. |
--pat-name | Oui | N/A | Cette valeur doit être définie sur une chaîne statique : system-pat |
--target-visibility | Non | internal | Visibilité du référentiel de destination. Doit être private ou internal. Les référentiels publics ne sont pas pris en charge. |
--start | Non | false | Démarre automatiquement la migration après sa création |
Options elm migration list
| Flag | Obligatoire | Default | Description |
|---|---|---|---|
--status | Non | N/A | Filtre les résultats par état de migration. Valeurs valides : created, , queued, in_progress``paused``completed``failed, , . terminated |
--page-size | Non | N/A | Nombre de résultats par page |
--after | Non | N/A | Curseur pour la pagination, à partir d’une réponse précédente |
Options elm migration cutover-to-destination
| Flag | Obligatoire | Default | Description |
|---|---|---|---|
--migration-id | Oui | N/A | ID d’une migration prête pour le transfert. |
--force | Non | false | Par 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. |
Drapeaux globaux et variables
Les propriétés suivantes peuvent être fournies en tant que variables d’environnement ou en tant qu’indicateurs sur n’importe quelle commande, avec des indicateurs de commande prenant la priorité. Vous devez définir ces valeurs après l’application de la ghe-config configuration.
| Variable | Flag | Obligatoire | Description |
|---|---|---|---|
| API_URL | --api-url | Oui | Cette propriété doit être définie sur http://localhost:1738. |
| MIGRATION_MANAGER_HMAC_KEY | --migration-manager-hmac-key | Oui | Cette propriété doit être définie sur $(ghe-config secrets.elm-exporter.elm-exporter-hmac-keys). |
| MIGRATION_TARGET_URL | --migration-target-url | Oui | URL de l’API pour votre entreprise de destination (par exemple : https://api.octocorp.ghe.com). N’incluez pas de barre oblique finale dans l’URL. |
| MIGRATION_TARGET_TOKEN | --migration-target-token | Oui | Le personal access token (classic) pour GHE.com |
| DEBUG_HTTP | --debug-http | Non | Réglez sur true pour imprimer la méthode HTTP, l'URL, les en-têtes et le corps de réponse d’erreur pour chaque requête, à des fins de débogage. |