# CLI-Referenz für Enterprise-Live-Migrationen

Detaillierte Nutzungsinformationen für das ELM CLI-Tool.

>[!NOTE] 
Enterprise Live Migrations ist in Öffentliche Vorschau 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` | Leitet die endgültige Umschaltung ein, archiviert 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. |