メモ
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 に設定します |