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

Detaillierte Nutzungsinformationen für das ELM CLI Tool.

## Installation

```shell
gh extension install github/gh-elm
```

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

## Setupbefehle

| Command               | Description                                                    |
|-----------------------|----------------------------------------------------------------|
| `gh elm config`       | Endpunkte und Token für ELM interaktiv konfigurieren   |
| `gh elm config reset` | Entfernen gespeicherter Konfiguration und Anmeldeinformationen                    |
| `gh elm config show`  | Aktuelle Konfiguration anzeigen, mit geschwärzten Token           |
| `gh elm completion`   | Generiere ein Shell-Autovervollständigungsskript für die angegebene Shell |

## Migrationsbefehle

| Command | Description |
|---|---|
| `gh elm migration list` | Migrationen auflisten |
| `gh elm migration create` | Erstellen Sie eine neue Migration |
| `gh elm migration start MIGRATION-ID` | Starten einer zuvor erstellten Migration |
| `gh elm migration status MIGRATION-ID` | Abrufen des Status und der Details einer Migration |
| `gh elm migration watch MIGRATION-ID` | Überwachen des Migrationsfortschritts mit einer Liveaktualisierungsanzeige |
| `gh elm migration pause MIGRATION-ID` | Anhalten einer ausgeführten Migration |
| `gh elm migration resume MIGRATION-ID` | Fortsetzen einer angehaltenen Migration |
| `gh elm migration cancel MIGRATION-ID` | Abbrechen und Beenden einer Migration |
| `gh elm migration target-id MIGRATION-ID` | Nachschlagen der Zielmigrations-ID (Ziel) für eine Migration |
| `gh elm migration cutover MIGRATION-ID` | Umstellung zum Ziel für eine Migration einleiten |
| `gh elm migration cutover status MIGRATION-ID` | Status und Fortschritt einer Migration abrufen |
| `gh elm migration cutover revert MIGRATION-ID` | Die 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

| Command | Description |
| ------- | ----------- |
| `gh elm target mannequin reclaim` | Beanspruchen (zurückfordern) eines oder mehrerer Dummies in der Zielorganisation |
| `gh elm target mannequin list` | Auflisten der Mannequins einer Zielorganisation als CSV |
| `gh elm target report request` | Anfordern eines Knotenberichts für eine Migration |
| `gh elm target report status` | Den Status des Knotenberichts einer Migration abfragen |
| `gh elm target report url` | Signierte Download-URL für einen abgeschlossenen Bericht abrufen |
| `gh elm target resources` | Die Ressourcen einer Migration im Ziel auflisten |
  
## `gh elm migration create`-Optionen

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

| Flag                  | Required | Vorgabe    | 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-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.                                                              |
| `--json`              | No       | `false`    | Ausgeben der unformatierten JSON-Antwort der API anstelle von lesbarem Text                                                |

## `gh elm migration list`-Optionen

| Flag          | Required | Vorgabe | 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                                                                                       |
| `--json`      | No       | `false` | Ausgeben der unformatierten JSON-Antwort der API anstelle von lesbarem Text                                                                    |

## `gh elm migration cutover`-Optionen

| Flag             | Required | Vorgabe | 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. |
| `--watch`        | No       | `false` | Nach dem Auslösen der Umschaltung wechseln Sie in den Live-Überwachungsmodus                                                                                                                                         |