Skip to main content

CLI-Referenz für Enterprise-Live-Migrationen

Detaillierte Nutzungsinformationen für das ELM CLI Tool.

Installation

gh extension install github/gh-elm

Die Erweiterung erfordert GitHub CLI (gh) Version 2.0 oder höher.

Setupbefehle

BefehlDescription
gh elm configEndpunkte und Token für ELM interaktiv konfigurieren
gh elm config resetEntfernen gespeicherter Konfiguration und Anmeldeinformationen
gh elm config showAktuelle Konfiguration anzeigen, mit geschwärzten Token
gh elm completionGeneriere ein Shell-Autovervollständigungsskript für die angegebene Shell

Migrationsbefehle

BefehlDescription
gh elm migration listMigrationen auflisten
gh elm migration createErstellen Sie eine neue Migration
gh elm migration start MIGRATION-IDStarten einer zuvor erstellten Migration
gh elm migration status MIGRATION-IDAbrufen des Status und der Details einer Migration
gh elm migration watch MIGRATION-IDÜberwachen des Migrationsfortschritts mit einer Liveaktualisierungsanzeige
gh elm migration pause MIGRATION-IDAnhalten einer ausgeführten Migration
gh elm migration resume MIGRATION-IDFortsetzen einer angehaltenen Migration
gh elm migration cancel MIGRATION-IDAbbrechen und Beenden einer Migration
gh elm migration target-id MIGRATION-IDNachschlagen der Zielmigrations-ID (Ziel) für eine Migration
gh elm migration cutover MIGRATION-IDUmstellung zum Ziel für eine Migration einleiten
gh elm migration cutover status MIGRATION-IDStatus und Fortschritt einer Migration abrufen
gh elm migration cutover revert MIGRATION-IDDie Auswirkungen der Umstellung rückgängig machen, damit das Quell-Repository erneut migriert werden kann

Einige dieser Befehle können zusätzliche Optionen verwenden. Weitere Informationen finden Sie in den späteren Abschnitten in diesem Artikel.

Zielbefehle

BefehlDescription
gh elm target mannequin reclaimBeanspruchen (zurückfordern) eines oder mehrerer Dummies in der Zielorganisation
gh elm target mannequin listAuflisten der Mannequins einer Zielorganisation als CSV
gh elm target report requestAnfordern eines Knotenberichts für eine Migration
gh elm target report statusDen Status des Knotenberichts einer Migration abfragen
gh elm target report urlSignierte Download-URL für einen abgeschlossenen Bericht abrufen
gh elm target resourcesDie Ressourcen einer Migration im Ziel auflisten

gh elm migration create-Optionen

Erstellen Sie eine neue Migration, um den Repositoryexport und -import vorzubereiten.

FlagErforderlichDefaultDescription
--source-orgYesN/ASlug der Quellorganisation auf GitHub Enterprise Server
--source-repoYesN/AName des Quell-Repositorys
--target-orgYesN/AKurzbezeichnung der Zielorganisation auf GHE.com
--target-repoYesN/AName des Ziel-Repositorys
--target-visibilityNointernalSichtbarkeit des Ziel-Repositorys. Muss private oder internal sein. Öffentliche Repositorys werden nicht unterstützt.
--startNofalseDie Migration wird nach dem Erstellen automatisch gestartet.
--jsonNofalseAusgeben der unformatierten JSON-Antwort der API anstelle von lesbarem Text

gh elm migration list-Optionen

FlagErforderlichDefaultDescription
--statusNoN/AFiltert Ergebnisse nach Migrationsstatus. Gültige Werte: created, , queued, in_progress``paused, completed, , failed. terminated
--page-sizeNoN/AAnzahl der Ergebnisse pro Seite
--afterNoN/ACursor für Paginierung basierend auf einer vorherigen Antwort
--jsonNofalseAusgeben der unformatierten JSON-Antwort der API anstelle von lesbarem Text

gh elm migration cutover-Optionen

FlagErforderlichDefaultDescription
--migration-idYesN/ADie ID einer Migration, die für den Cutover-Prozess bereit ist.
--forceNofalseStandardmäß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.
--watchNofalseNach dem Auslösen der Umschaltung wechseln Sie in den Live-Überwachungsmodus