メモ
Enterprise Live Migrations は パブリック プレビュー であり、変更される可能性があります。
GitHub Enterprise Server インスタンスの準備はできましたか?
ELM は、サポートされているリリースにバックポートされています。 これを使用するには、次のいずれかのマイナー バージョン以降にアップグレードする必要があります。
3.20.23.19.63.18.93.17.15
GitHub Enterprise Server インスタンスには、次の項目も必要です。
- HTTPS URL を使用します。 HTTP URL はサポートされていません。
- 移行を有効にし、BLOB ストレージを構成します。 これらの設定は、管理コンソールの [移行] セクションで確認できます。 これらの設定をまだ構成していない場合は、 Enterprise Live Migrations を使用したリポジトリの移行 で既定値に設定する方法について説明します。
移行先の組織は何のようになりますか?
リポジトリは、 GHE.com上の新規または既存の組織に移行できます。 ELM は、ターゲット組織がまだ存在しない場合に作成します。
プラットフォームの移行は、組織とチームの構造を再考する良い機会です。 「企業で作業を整理するためのベスト プラクティス」を参照してください。
移行するリポジトリはどれですか?
ELM サポート 1 つの**** インスタンスから最大 GitHub Enterprise Server 個の同時リポジトリ移行、および移行先企業あたり **20** 個の同時移行。
最初に ELM を使用して移行するリポジトリと、後で、または別の移行ツールを使用して移行できるリポジトリを計画します。 ELMの恩恵を受ける可能性が最も高いリポジトリは次のとおりです。
- 長時間のダウンタイムによってビジネスが中断される重要なリポジトリ
- 他の移行ツールでは扱えないほど大規模なモノレポ
パブリック リポジトリは GHE.comでは使用できません。これらは ELMによって拒否されます。 開始する前に、 GitHub Enterprise Server でこれらのリポジトリの可視性を変更できます。
選択したリポジトリに 2 GB を超えるリリースアセットが含まれていないことを確認する必要があります。これは ELMの制限です。
誰が移行を実行するか?
ELM移行を実行するユーザーは、次の手順を実行する必要があります。
- GitHub Enterprise Server インスタンスへのサイト管理者アクセス権を持つ
- GHE.com 企業のエンタープライズ所有者になる
このユーザーは、次のタスクを実行する必要があります。
-
移行前に、移行元企業と移行先企業の両方で personal access tokens (classic) を作成します。
-
移行中は、移行の状態を監視し、問題に対応します。
ELM インスタンスからの同時GitHub Enterprise Server移行の場合、同じユーザーが同じトークンを使用して、すべての`elm`コマンドを実行する必要があります。
移行後、他のユーザーが GHE.comに対していくつかのフォローアップ タスクを実行する必要があります。 すべての組織の所有者がこれを行うことができます。
開発者は何を知っておくべきですか?
開始する前に、次の点を開発者に伝えます。
- リポジトリは新しい場所に移動しています。 オペレーターが新しい場所への最終カットオーバーを開始するまで、ユーザーは移行中もソース リポジトリを引き続き使用できます。
- 移行の進行中、開発者はリポジトリへの強制的なプッシュを回避する必要があります。これは、 ELM 解決できない方法で Git 履歴が中断されるためです。
- 移行プロセス中に開発者が実行する特定のアクションは、移行されたリポジトリに反映されない場合があります。 詳細については、 GitHub Enterprise Server から GHE.com へのライブ マイグレーション用に移行されたデータ でサポートされていないアクションを参照してください。
次のステップ
移行を実行する準備ができたら、 Enterprise Live Migrations を使用したリポジトリの移行 を参照してください。