# Enterprise Live Migrations コマンドラインインターフェース リファレンス

ELM CLI ツールの詳細な使用状況情報。

>[!NOTE] 
Enterprise Live Migrations は パブリック プレビュー であり、変更される可能性があります。

## `elm migration` コマンド

| コマンド | 説明 |
|---|---|
| `elm migration create` | 1 つのソース リポジトリの新しい移行を作成します |
| `elm migration start --migration-id MIGRATION-ID` | 移行を開始する |
| `elm migration status --migration-id MIGRATION-ID` | 移行の状態、進行状況、カットオーバーの準備状況、およびタイミングを表示します |
| `elm migration list` | すべての移行とその状態を一覧表示します |
| `elm migration cancel --migration-id MIGRATION-ID` | 進行中の移行を取り消します |
| `elm migration cutover-to-destination --migration-id MIGRATION-ID` | 最終的なカットオーバーを開始し、ソース リポジトリをアーカイブし、移行を完了します |

これらのコマンドの一部では、追加のオプションを使用できます。 この記事の後のセクションを参照してください。

## `elm migration create` のオプション

リポジトリのエクスポートとインポートを準備するための新しい移行を作成します。

| フラグ | 必須 | Default | 説明 |
|---|---|---|---|
| `--source-org` | Yes | N/A | ソース組織のスラッグ GitHub Enterprise Server |
| `--source-repo` | Yes | N/A | ソース リポジトリの名前 |
| `--target-org` | Yes | N/A | 宛先組織のスラッグ GHE.com |
| `--target-repo` | Yes | N/A | 宛先リポジトリの名前 |
| `--target-api` | Yes | N/A | 移行先企業の API URL (例: `https://api.octocorp.ghe.com`)。 URL の末尾に末尾のスラッシュを含 **めないでください** 。 |
| `--pat-name` | Yes | N/A | これは静的文字列に設定する必要があります。 `system-pat` |
| `--target-visibility` | いいえ | `internal` | 宛先リポジトリの可視性。 
`private` または `internal` である必要があります。 パブリック リポジトリはサポートされていません。 |
| `--start` | いいえ | `false` | 作成後に移行を自動的に開始する |

## `elm migration list` のオプション

| フラグ | 必須 | Default | 説明 |
|---|---|---|---|
| `--status` | いいえ | N/A | 移行ステータスで結果をフィルターする。 有効な値: `created`、 `queued`、 `in_progress`、 `paused`、 `completed`、 `failed`、 `terminated`。 |
| `--page-size` | いいえ | N/A | 1 ページあたりの結果の数 |
| `--after` | いいえ | N/A | 前の応答からのページネーションのカーソル |

## `elm migration cutover-to-destination` のオプション

| フラグ | 必須 | Default | 説明 |
|---|---|---|---|
| `--migration-id` | Yes | N/A | カットオーバーの準備ができている移行の ID。 |
| `--force` | いいえ | `false` | 既定では、このコマンドは、移行先が準備状況を報告するかどうかを確認してから続行します。 移行状態が正しいと確信している場合は、 `--force` を使用してこのチェックをバイパスします。 |

## グローバル フラグと変数

次のプロパティは、環境変数または任意のコマンドのフラグとして指定でき、コマンド フラグが優先されます。 これらの値は、__ 構成を適用`ghe-config`に設定する必要があります。

| Variable | フラグ | 必須 | 説明 |
|----------|------|----------|-------------|
| API_URL | `--api-url` | Yes | 
`http://localhost:1738`に設定する必要があります。 |
| MIGRATION_MANAGER_HMAC_KEY | `--migration-manager-hmac-key` | Yes | 
`$(ghe-config secrets.elm-exporter.elm-exporter-hmac-keys)`に設定する必要があります。 |
| MIGRATION_TARGET_URL | `--migration-target-url` | Yes | 移行先企業の API URL (例: `https://api.octocorp.ghe.com`)。 URL の末尾に末尾のスラッシュを含 **めないでください** 。 |
| MIGRATION_TARGET_TOKEN | `--migration-target-token` | Yes | のpersonal access token (classic)GHE.com |
| DEBUG_HTTP | `--debug-http` | いいえ | デバッグのために、各要求の HTTP メソッド、URL、ヘッダー、およびエラー応答本文を出力する `true` に設定します |