Skip to main content

フェーズ 5. リポジトリを Azure DevOps から Github に移行する

試用の実行を実行し、リポジトリを Azure DevOps から GitHub に移行します。

[前提条件]

  • このガイドの前のすべてのフェーズを完了している必要があります。
  • 移行されるデータと、Importer の既知のサポート制限事項を理解していることを確認します。詳細については、「フェーズ 1: Azure DevOps から GitHub への移行について」を参照してください。
  • 必須ではありませんが、運用環境の移行の間は作業を停止することをお勧めします。 Importer は差分移行をサポートしていないため、移行中に発生した変更は移行されません。 運用環境の移行の間に作業を停止しない場合は、これらの変更を手動で移行する必要があります。

移行スクリプトを生成する

マイグレーションスクリプトを生成するためのエンタープライズ移行ツールを使用する方法

移行スクリプトを生成するには、gh ado2gh generate-script コマンドを実行します。

Shell
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-URLGHE.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 フラグの値を更新します。 既定では、スクリプトはソース リポジトリと同じ表示範囲を設定します。

試運転を行う

  1. 試用版の移行のテスト用 Organization を作成します。

    すべての試験的実行に 1 つの Organization を使うことも、目的の移行先 Organization ごとに 1 つのテスト Organization を作成することもできます。 Organization が移行検証のみを目的としており、運用環境向けではないことを明確にするために、Organization 名の末尾に -sandbox を含めることを検討してください。 終わったら、テスト Organization を削除してかまいません。

  2. 試験的移行を実行します。

  3.        [AUTOTITLE](/migrations/ado/phase-6-follow-up-tasks) でフォローアップ タスクを完了できることを確認します。
    
  4. 移行の結果を検証するようにユーザーに依頼します。

  5. 試験的移行によって明らかになった問題を解決します。

  6. 必要に応じて、テスト用の Organization を削除します。

リポジトリを移行する

試用の実行が成功し、フォローアップ タスクを完了できた場合は、実際の移行に進むことができます。

警告

移行するリポジトリの作業は停止することをお勧めします。 移行中または移行後に行われた変更は、手動で移行する必要があります。

複数のリポジトリを移行するための企業用移行ツール

次のステップ

次のフェーズと最後のフェーズでは、フォローアップ タスクを実行し、ログを確認し、リポジトリを使用する準備をします。 「フェーズ 6. フォローアップ タスク」を参照してください。