[前提条件]
- このガイドの前のすべてのフェーズを完了している必要があります。
- 移行されるデータと、Importer の既知のサポート制限事項を理解していることを確認します。詳細については、「フェーズ 1: Azure DevOps から GitHub への移行について」を参照してください。
- 必須ではありませんが、運用環境の移行の間は作業を停止することをお勧めします。 Importer は差分移行をサポートしていないため、移行中に発生した変更は移行されません。 運用環境の移行の間に作業を停止しない場合は、これらの変更を手動で移行する必要があります。
移行スクリプトを生成する
マイグレーションスクリプトを生成するためのエンタープライズ移行ツールを使用する方法
移行スクリプトを生成するには、gh ado2gh generate-script コマンドを実行します。
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME
上のコマンドのプレースホルダーを次の値に置き換えます。
プレースホルダー | 値 |
----------- | ----- |SOURCE | 移行元の Organization の名前DESTINATION | 移行先の Organization の名前FILENAME | 結果の移行スクリプトのファイル名
ターミナルを使っている場合は、生成されたスクリプトの実行に PowerShell が必要なので、.ps1 ファイル拡張子を使います。 Mac 用または Linux 用の PowerShell をインストールできます。
追加の引数
| 引数 | Description |
|---|---|
--target-api-url TARGET-API-URL | GHE.com に移行する場合は、--target-api-url TARGET-API-URL を追加します。TARGET-API-URL は Enterprise のサブドメインのベース API URL です。 (例: https://api.octocorp.ghe.com)。 |
--all | パイプラインの再調整、チームの作成、Azure Boards 統合の構成など、スクリプトに新しい機能を追加します。 |
--download-migration-logs | 移行された各リポジトリの移行ログをダウンロードします。 移行ログについて詳しくは、「GitHub Enterprise Importer の移行ログへのアクセス」をご覧ください。 |
移行スクリプトの確認
スクリプトを生成したら、ファイルを確認し、必要に応じてスクリプトを編集します。
- 移行したくないリポジトリがある場合は、対応する行を削除するかコメントにします。
- 移行先の Organization でリポジトリに別の名前を使う場合は、対応する
--target-repoフラグの値を更新します。 - 新しいリポジトリの可視性を変更する場合は、対応する
--target-repo-visibilityフラグの値を更新します。 既定では、スクリプトはソース リポジトリと同じ表示範囲を設定します。
試運転を行う
-
試用版の移行のテスト用 Organization を作成します。
すべての試験的実行に 1 つの Organization を使うことも、目的の移行先 Organization ごとに 1 つのテスト Organization を作成することもできます。 Organization が移行検証のみを目的としており、運用環境向けではないことを明確にするために、Organization 名の末尾に
-sandboxを含めることを検討してください。 終わったら、テスト Organization を削除してかまいません。 -
試験的移行を実行します。
-
[AUTOTITLE](/migrations/ado/phase-6-follow-up-tasks) でフォローアップ タスクを完了できることを確認します。 -
移行の結果を検証するようにユーザーに依頼します。
-
試験的移行によって明らかになった問題を解決します。
-
必要に応じて、テスト用の Organization を削除します。
リポジトリを移行する
試用の実行が成功し、フォローアップ タスクを完了できた場合は、実際の移行に進むことができます。
警告
移行するリポジトリの作業は停止することをお勧めします。 移行中または移行後に行われた変更は、手動で移行する必要があります。
複数のリポジトリを移行するための企業用移行ツール
次のステップ
次のフェーズと最後のフェーズでは、フォローアップ タスクを実行し、ログを確認し、リポジトリを使用する準備をします。 「フェーズ 6. フォローアップ タスク」を参照してください。