移行について
移行とは、「ソース」場所 (GitHub.com Organization か GitHub Enterprise Server インスタンスのいずれか) から「ターゲット」となる GitHub Enterprise Server インスタンスにデータを移譲するプロセスです。 移行は、プラットフォームを変更したり、インスタンスのハードウェアをアップグレードしたりする場合にデータを転送するのに利用できます。
移行の種類
行える移行は3種類あります。
- GitHub Enterprise Server インスタンスから別の GitHub Enterprise Server インスタンスへの移行。 インスタンス上の任意のユーザあるいはOrganizationが所有する任意の数のリポジトリを移行できます。 移行を行う前に、双方のインスタンスにサイト管理者としてアクセスできなければなりません。
- GitHub.com Organization から GitHub Enterprise Server インスタンスへの移行。 Organizationが所有する任意の数のリポジトリを移行できます。 移行を実行するためには、GitHub.com Organization への管理アクセスと、ターゲットインスタンスへのサイト管理者としてのアクセスが必要です。
- トライアル実行は、データをステージングインスタンスにインポートする移行です。 これは、GitHub Enterprise Server インスタンス に対して移行を行ったときに何が起こることになるのかを確認するのに役立ちます。 本番インスタンスへデータをインポートする前に、ステージングインスタンスで試行することを強くおすすめします。
データの移行
移行においては、すべての事項についてリポジトリが中心になります。 リポジトリに関係するほとんどのデータは移行できます。 たとえば Organization 内のリポジトリは、リポジトリおよびその Organization、またそのリポジトリに関連付けられているユーザ、Team、Issue、プルリクエストのすべてを移行します。
以下の表の項目はレポジトリと共に移行できます。 このデータの移行リストに記載されていない項目はどれも移行できません。
メモ: マイグレーション後には、フォークの関係性は保持されません。
| 移行されたリポジトリに関連するデータ | 注釈 |
|---|---|
| ユーザ | ユーザの @メンション は、ターゲットにマッチするよう書き換えられます。 |
| Organization | Organizationの名前と詳細は移行されます。 |
| リポジトリ | Git ツリー、blob、コミット、および行へのリンクは、ターゲットにマッチするよう書き換えられます。 移行者がリダイレクトできるリポジトリの上限は 3 つです。 |
| Wiki | すべてのWikiのデータは移行されます。 |
| Team | チームの @メンション はターゲットにマッチするよう書き換えられます。 |
| マイルストーン | タイムスタンプは保持されます。 |
| プロジェクトボード | リポジトリやリポジトリを所有するOrganizationに関連するプロジェクトボードは移行されます。 |
| 問題 | Issueへの参照とタイムスタンプは保持されます。 |
| Issueのコメント | コメントへの相互参照は、ターゲットインスタンスに合わせて書き換えられます。 |
| プルリクエスト | プルリクエストへの相互参照はターゲットにマッチするよう書き換えられます。 タイムスタンプは保持されます。 |
| プルリクエストのレビュー | プルリクエストのレビューと関連データは移行されます。 |
| プルリクエストのレビューのコメント | コメントへの相互参照は、ターゲットインスタンスに合わせて書き換えられます。 タイムスタンプは保持されます。 |
| コミットのコメント | コメントへの相互参照は、ターゲットインスタンスに合わせて書き換えられます。 タイムスタンプは保持されます。 |
| リリース | すべてのリリースデータは移行されます。 |
| プルリクエストあるいはIssueに対して行われたアクション | ユーザの割り当て、タイトルの変更、ラベルの変更など、プルリクエストあるいはIssueに対するすべての変更は、それぞれのアクションのタイムスタンプと共に保持されます。 |
| 添付ファイル | Issue およびプルリクエストの添付ファイルは移行されます。 移行に関するこの機能は無効化できます。 |
| webhook | アクティブなwebhookのみが移行されます。 |
| リポジトリのデプロイキー | リポジトリのデプロイキーは移行されます。 |
| 保護されたブランチ | 保護されたブランチの設定と関連データは移行されます。 |