Hinweis
Enterprise Live Migrations ist in beta und kann geändert werden.
`elm migration`-Befehle
| Befehl | Description |
|---|---|
elm migration create | Erstellt eine neue Migration für ein einzelnes Quell-Repository. |
elm migration start --migration-id MIGRATION-ID | Startet eine Migration |
elm migration status --migration-id MIGRATION-ID | Zeigt den Status, den Fortschritt, die Bereitschaft zum Umschalten und den Zeitplan für eine Migration an. |
elm migration list | Listet alle Migrationen und deren Status auf |
elm migration cancel --migration-id MIGRATION-ID | Bricht eine laufende Migration ab |
elm migration cutover-to-destination --migration-id MIGRATION-ID | Startet die endgültige Umstellung, sperrt das Quell-Repository und schließt die Migration ab. |
Einige dieser Befehle können zusätzliche Optionen verwenden. Weitere Informationen finden Sie in den späteren Abschnitten in diesem Artikel.
`elm migration create`-Optionen
Erstellen Sie eine neue Migration, um den Repositoryexport und -import vorzubereiten.
| Flag | Erforderlich | Default | Description |
|---|---|---|---|
--source-org | Yes | N/A | Slug der Quellorganisation auf GitHub Enterprise Server |
--source-repo | Yes | N/A | Name des Quell-Repositorys |
--target-org | Yes | N/A | Kurzbezeichnung der Zielorganisation auf GHE.com |
--target-repo | Yes | N/A | Name des Ziel-Repositorys |
--target-api | Yes | N/A | Die API-URL für Ihr Zielunternehmen (z. B.: https://api.octocorp.ghe.com). Fügen Sie am Ende der URL keinen Schrägstrich hinzu. |
--pat-name | Yes | N/A | Dies muss auf eine statische Zeichenfolge festgelegt werden: system-pat |
--target-visibility | No | internal | Sichtbarkeit des Ziel-Repositorys. Muss private oder internal sein. Öffentliche Repositorys werden nicht unterstützt. |
--start | No | false | Die Migration wird nach dem Erstellen automatisch gestartet. |
`elm migration list`-Optionen
| Flag | Erforderlich | Default | Description |
|---|---|---|---|
--status | No | N/A | Filtert Ergebnisse nach Migrationsstatus. Gültige Werte: created, , queued, in_progress``paused, completed, , failed. terminated |
--page-size | No | N/A | Anzahl der Ergebnisse pro Seite |
--after | No | N/A | Cursor für Paginierung basierend auf einer vorherigen Antwort |
`elm migration cutover-to-destination`-Optionen
| Flag | Erforderlich | Default | Description |
|---|---|---|---|
--migration-id | Yes | N/A | Die ID einer Migration, die für den Cutover-Prozess bereit ist. |
--force | No | false | Standardmäßig überprüft der Befehl, ob das Migrationsziel seine Bereitschaft meldet, bevor fortgefahren wird. Wird --force verwendet, um diese Überprüfung zu umgehen, wenn Sie sicher sind, dass der Migrationsstatus korrekt ist. |
Globale Flags und Variablen
Die folgenden Eigenschaften können entweder als Umgebungsvariablen oder als Flags für einen beliebigen Befehl bereitgestellt werden, wobei Befehlskennzeichnungen Priorität haben. Sie sollten diese Werte nach dem Anwenden der ghe-config Konfiguration festlegen.
| Variable | Flag | Erforderlich | Description |
|---|---|---|---|
| API_URL | --api-url | Yes | Muss auf http://localhost:1738 festgelegt sein. |
| MIGRATION_MANAGER_HMAC_KEY | --migration-manager-hmac-key | Yes | Muss auf $(ghe-config secrets.elm-exporter.elm-exporter-hmac-keys) festgelegt sein. |
| MIGRATION_TARGET_URL | --migration-target-url | Yes | Die API-URL für Ihr Zielunternehmen (z. B.: https://api.octocorp.ghe.com). Fügen Sie am Ende der URL keinen Schrägstrich hinzu. |
| MIGRATION_TARGET_TOKEN | --migration-target-token | Yes | Die personal access token (classic) für GHE.com |
| DEBUG_HTTP | --debug-http | No | Setzen Sie true, um die HTTP-Methode, die URL, die Header und den Fehlerantwortkörper für jede Anfrage zu Debuggingzwecken auszugeben. |