GitHub Enterprise Server から GHE.com へのライブマイグレーションの準備

GitHub Enterprise Server インスタンスの準備はできましたか?

ELM は、 GitHub Enterprise Server 3.17 以降の最新のパッチリリースで使用できます。このドキュメントでは、次のパッチバージョン以降を使用していることを前提としています。この手順は、以前のバージョンでは機能しない場合があります。

GitHub Enterprise Server インスタンスには、次の項目も必要です。

HTTPS URL を使用します。 HTTP URL はサポートされていません。
移行先への送信トラフィックを許可します。
管理コンソールの [移行] セクションで移行を有効にします。
移行中に追加の負荷に備えます。リポジトリのアーカイブにより、リポジトリ内のすべての問題とプル要求が MySQL からプルされ、Elasticsearch でインデックスが再作成されます。

リポジトリは、 GHE.com上の新規または既存の組織に移行できます。 ELM は、ターゲット組織がまだ存在しない場合に作成します。

プラットフォームの移行は、組織とチームの構造を再考する良い機会です。「企業で作業を整理するためのベストプラクティス」を参照してください。

ELM サポート 1 つの**** インスタンスから最大 GitHub Enterprise Server 個の同時リポジトリ移行、および移行先企業あたり 20 個の同時移行。

最初に ELM を使用して移行するリポジトリと、後で、または別の移行ツールを使用して移行できるリポジトリを計画します。 ELMの恩恵を受ける可能性が最も高いリポジトリは次のとおりです。

パブリックリポジトリは GHE.comでは使用できません。これらは ELMによって拒否されます。開始する前に、 GitHub Enterprise Server でこれらのリポジトリの可視性を変更できます。

選択したリポジトリに 2 GB を超えるリリースアセットが含まれていないことを確認する必要があります。これは ELMの制限です。

ELM移行を実行するユーザーは、次の手順を実行する必要があります。

このユーザーは、次のタスクを実行する必要があります。

ELM インスタンスからの同時GitHub Enterprise Server移行の場合、同じユーザーが同じトークンを使用して、すべてのelmコマンドを実行する必要があります。

移行後、他のユーザーが GHE.comに対していくつかのフォローアップタスクを実行する必要があります。すべての組織の所有者がこれを行うことができます。

開始する前に、次の点を開発者に伝えます。

リポジトリは新しい場所に移動しています。オペレーターが新しい場所への最終カットオーバーを開始するまで、ユーザーは移行中もソースリポジトリを引き続き使用できます。カットオーバー後、ソースリポジトリはアーカイブされるため、リポジトリ管理者によってアーカイブされない限り、読み取り専用になります。
移行の進行中、開発者はリポジトリへの強制的なプッシュを回避する必要があります。これは、 ELM 解決できない方法で Git 履歴が中断されるためです。
移行プロセス中に開発者が実行する特定のアクションは、移行されたリポジトリに反映されない場合があります。詳細については、 GitHub Enterprise Server から GHE.com へのライブマイグレーション用に移行されたデータでサポートされていないアクションを参照してください。

移行を実行する準備ができたら、 Enterprise Live Migrations を使用したリポジトリの移行を参照してください。