Skip to main content

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

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

インストール作業

gh extension install github/gh-elm

拡張機能には、 GitHub CLI (gh) バージョン 2.0 以降が必要です。

セットアップ コマンド

コマンド説明
gh elm configELM で使用するエンドポイントとトークンを対話形式で構成する
gh elm config reset保存されている構成と資格情報を削除する
gh elm config showトークンが編集された状態で現在の構成を表示する
gh elm completion指定したシェルのシェルオートコンプリート スクリプトを生成する

移行コマンド

コマンド説明
gh elm migration list移行を一覧表示する
gh elm migration create新しい移行を作成する
gh elm migration start MIGRATION-ID以前に作成した移行を開始する
gh elm migration status MIGRATION-ID移行の状態と詳細を取得する
gh elm migration watch MIGRATION-IDライブ更新の表示で移行の進行状況を監視する
gh elm migration pause MIGRATION-ID実行中の移行を一時停止する
gh elm migration resume MIGRATION-ID一時停止した移行を再開する
gh elm migration cancel MIGRATION-ID移行を取り消して終了する
gh elm migration target-id MIGRATION-ID移行のターゲット (移行先) 移行 ID を検索する
gh elm migration cutover MIGRATION-ID移行先へのカットオーバーを開始する
gh elm migration cutover status MIGRATION-ID移行の切り替えの状態と進捗を取得する
gh elm migration cutover revert MIGRATION-IDソース リポジトリを再度移行できるように、カットオーバーの効果を元に戻す

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

ターゲット コマンド

コマンド説明
gh elm target mannequin reclaimターゲット組織の 1 つ以上のマネキンを要求 (回収) する
gh elm target mannequin listターゲット組織のマネキンを CSV として一覧表示する
gh elm target report request移行のノード レポートを要求する
gh elm target report status移行のノード レポートの状態を照会する
gh elm target report url完成したレポートの署名付きダウンロード URL を取得する
gh elm target resources移行のリソースをターゲットから一覧表示する

gh elm migration create のオプション

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

フラグ必須Default説明
--source-orgYesN/Aソース組織のスラッグ GitHub Enterprise Server
--source-repoYesN/Aソース リポジトリの名前
--target-orgYesN/A宛先組織のスラッグ GHE.com
--target-repoYesN/A宛先リポジトリの名前
--target-visibilityいいえinternal宛先リポジトリの可視性。
private または internal である必要があります。 パブリック リポジトリはサポートされていません。
--startいいえfalse作成後に移行を自動的に開始する
--jsonいいえfalse人間が判読できるテキストではなく、API の生の JSON 応答を出力する

gh elm migration list のオプション

フラグ必須Default説明
--statusいいえN/A移行ステータスで結果をフィルターする。 有効な値: createdqueuedin_progresspausedcompletedfailedterminated
--page-sizeいいえN/A1 ページあたりの結果の数
--afterいいえN/A前の応答からのページネーションのカーソル
--jsonいいえfalse人間が判読できるテキストではなく、API の生の JSON 応答を出力する

gh elm migration cutover のオプション

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