メモ
Enterprise Live Migrations は パブリック プレビュー であり、変更される可能性があります。
Enterprise Live Migrations とは
Enterprise Live Migrations (ELM) は、リポジトリを GitHub Enterprise Server から データ所在地付き GitHub Enterprise Cloud (GHE.com) に移行するためのサービスです。 これは、 GitHub Enterprise Serverのコマンド ライン ツールを使用して動作します。
ほとんどの移行プロセスでユーザーがソース リポジトリを引き続き使用できるため、移行は "ライブ" です。 リポジトリ データが最初に収集されると、webhook は、新しいコミットや設定の更新など、リポジトリへの変更を確認します。 これらの変更は ELM に報告され、移行に含まれます。
ELM移行には、1 つのリポジトリが含まれます。 組織の設定、チーム、プロジェクトなどの組織レベルのデータは移行に含 **まれていない** ので、移行先企業で手動で再構成する必要があります。
GitHub Enterprise Importer との違い
ELM
GitHub Enterprise Importer (GEI) は、リポジトリのGitHub Enterprise ServerからGHE.comへの移行をサポートする個別のツールです。
ELMの主な利点は次のとおりです。
- 開発者のダウンタイムの短縮: GEI を使用した移行中、開発者は移行期間中、リポジトリにアクセスできなくなります。 このダウンタイムにより、デプロイのブロックや機能の停止などのリスクが発生します。
- Monorepo のサポート: ELM は、深い履歴を持つ大規模で複雑な monorepos を移行できます。 多くの場合、これらは GEI の容量を超えています。
- 可視性の向上: ELM では、移行の進行状況に関してリポジトリ レベルでの詳細な可視性を提供し、細かなエラーを明らかにすることで、移行されたリポジトリが正確なレプリカであることを確信できます。
ただし、ライブ更新に関連するトラフィック負荷が高いため、 ELM は GEI よりも少ない同時移行をサポートします。 1 つの**** インスタンスから最大 GitHub Enterprise Server 個の同時リポジトリ移行、および移行先企業あたり 20 個の同時移行。
プラットフォームの移行の過程で両方のツールを使用し、 ELMの恩恵を最も受けるリポジトリに優先順位を付けることができます。
移行の概要
通常、サイト管理者は、SSH 経由のターミナル セッションで、 elm CLI ツールを使用して移行を実行します。 オペレーターは、personal access tokensと宛先企業の両方にアクセスできるGitHub Enterprise Serverを提供する必要があります。
移行の大まかなフェーズは次のとおりです。
-
**作成**: サイト管理者は CLI コマンドを実行して移行を作成および開始し、ソース リポジトリと移行先を指定します。 -
**プレフライト チェック**: 移行サービスは、パラメーター、トークン、ネットワーク接続、およびリポジトリの構成を検証します。 -
**バックフィル**: ELM ツールは、最初のクロールを実行してすべてのリポジトリ データをキャプチャし、移行先プラットフォームの移行サービスに送信します。 バックフィル フェーズ中、Webhook は、移行が続行されるにつれて、リポジトリのライブ更新を確認します。 -
**カットオーバー**: ソース リポジトリがロックされ、最終的なライブ更新が ELMに送信されます。 これは、開発者のダウンタイム期間です。 -
**完了**: 移行が完了しました。 サイト管理者は、データが正常に移行されたことを確認できます。 -
**フォローアップ**: 組織の所有者は、組織の設定の再構成やユーザーへのアクティビティの再送信など、移行先企業でフォローアップ タスクを実行します。
次のステップ
移行を実行する準備をするには、 GitHub Enterprise Server から GHE.com へのライブ マイグレーションの準備 を参照してください。