GitHub Enterprise Importer の移行ログへのアクセス

移行を実行した後、移行ログを確認して、想定どおりに移行されなかったデータをチェックする必要があります。

この記事の内容

移行ログについて

GitHub Enterprise Importer で移行を実行するたびに、移行ログが作成されます。 移行の警告を確認するには、移行のたびに移行ログをチェックする必要があります。

移行ログには、移行の一環として完了した手順が一覧表示され、追加情報も含まれています。

  • 移行の警告。想定どおりに移行されなかったデータ (問題、pull request、コメントなど) を表します
  • 移行を実行したユーザー
  • 移行元
  • 移行にかかった時間

リポジトリ移行の移行ログには、複数の方法でアクセスできます。

  • GitHub では、移行済みのリポジトリの "移行ログ" の issue を表示します。 この issue を使って、チームと警告について話し合い、決定事項を記録できます。
  • GitHub CLI を使ってログ ファイルをダウンロードします。

Organization の移行を実行すると、GitHub Enterprise Importer によって、移行先の Organization に gei-migration-results という名前のリポジトリが追加で作成されます。 このリポジトリには、Organization レベルのデータの移行に関する情報が含まれており、移行された各リポジトリの "移行ログ" の issue の情報が複製されています。

移行ログでの警告の解釈の詳細については、「GitHub Enterprise Importer を使用した移行のトラブルシューティング」を参照してください。

GitHub でのリポジトリ移行ログの表示

リポジトリへの読み取りアクセス権を持つユーザーは、GitHub 上のリポジトリの移行ログにアクセスできます。

  1. 移行先 Organization の移行済みリポジトリに移動します。

  2. リポジトリ名の下にある [イシュー] をクリックします。

    リポジトリのメイン ページのスクリーンショット。 水平ナビゲーション バーでは、[イシュー] というラベルが付いたタブが濃いオレンジ色の枠線で囲まれています。

  3. "移行ログ" というタイトルの issue をクリックします。

GitHub CLI

を使ったリポジトリ移行ログのダウンロード

Organization の所有者と移行者ロールを持つ Organization のメンバーは、GitHub CLI を使って移行ログをダウンロードできます。

download-logs コマンドを使って、個々のリポジトリの最新の移行ログをダウンロードできます。 正確なコマンドは、移行元によって異なります。

移行ログをダウンロードできるのは、移行が完了してから 24 時間です。

ADO2GH extension

を使ったリポジトリ移行ログのダウンロード

移行元が Azure DevOps の場合は、gh ado2gh download-logs コマンドを使って個々のリポジトリの最新の移行ログをダウンロードできます。 DESTINATION を移行先の Organization に、REPOSITORY をリポジトリ名に、FILENAME をダウンロードしたファイルのファイル名に、それぞれ置き換えます。

Shell
gh ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
  • 移行先の Organization にアクセスできる personal access token に設定された GH_PAT 環境変数がまだない場合は、--github-target-pat TOKEN を追加し、TOKEN を personal access token に置き換えます。personal access token の要件については、「Azure DevOps からの移行のアクセスの管理」を参照してください。
  • GHE.com に移行する場合は、--target-api-url TARGET-API-URL を追加します。TARGET-API-URL は Enterprise のサブドメインのベース API URL です。 (例: https://api.octocorp.ghe.com)。

BBS2GH extension

を使ったリポジトリ移行ログのダウンロード

移行元が Bitbucket Server の場合は、gh bbs2gh download-logs コマンドを使って個々のリポジトリの最新の移行ログをダウンロードできます。 DESTINATION を移行先の Organization に、REPOSITORY をリポジトリ名に、FILENAME をダウンロードしたファイルのファイル名に、それぞれ置き換えます。

Shell
gh bbs2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
  • 移行先の Organization にアクセスできる personal access token に設定された GH_PAT 環境変数がまだない場合は、--github-target-pat TOKEN を追加し、TOKEN を personal access token に置き換えます。personal access token の要件については、「Bitbucket サーバーからの移行のアクセスの管理」を参照してください。
  • GHE.com に移行する場合は、--target-api-url TARGET-API-URL を追加します。TARGET-API-URL は Enterprise のサブドメインのベース API URL です。 (例: https://api.octocorp.ghe.com)。

GEI extension

を使ったリポジトリ移行ログのダウンロード

移行元が GitHub 製品の場合は、gh gei download-logs コマンドを使って個々のリポジトリの最新の移行ログをダウンロードできます。 DESTINATION を移行先の Organization に、REPOSITORY をリポジトリ名に、FILENAME をダウンロードしたファイルのファイル名に、それぞれ置き換えます。

Shell
gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
  • 移行先の Organization にアクセスできる personal access token に設定された GH_PAT 環境変数がまだない場合は、--github-target-pat TOKEN を追加し、TOKEN を personal access token に置き換えます。personal access token の要件については、「GitHub 製品間の移行のためのアクセスの管理」を参照してください。
  • GHE.com に移行する場合は、--target-api-url TARGET-API-URL を追加します。TARGET-API-URL は Enterprise のサブドメインのベース API URL です。 (例: https://api.octocorp.ghe.com)。

移行スクリプトのすべてのリポジトリ移行ログのダウンロード

移行されたすべてのリポジトリの移行ログに確実にアクセスできるようにするには、リポジトリ移行用の移行スクリプトを生成するときに --download-migration-logs フラグを使うことができます。 このフラグを使うと、スクリプトに移行された各リポジトリの download-logs コマンドがスクリプトに含まれます。 詳しくは、「GitHub Enterprise Importer について」をご覧ください。

Note

--download-migration-logs フラグはリポジトリの移行でのみ使うことができ、organization の移行では使用できません。

Organization の移行ログへのアクセス

移行先 Organization の所有者は、GitHub 上の Organization 移行の移行ログにアクセスできます。

Organization の移行の移行ログにアクセスするには、移行先の Organization で gei-migration-results という名前のリポジトリに移動します。

リポジトリのルートにある README.md ファイルには、Organization の移行に関する次の情報が含まれています。

  • 設定やチームなど、Organization レベルのデータの移行に関連する警告またはエラー
  • 正常に移行されたリポジトリの数と、移行に失敗したリポジトリの数

/success および /failure ディレクトリには、正常に移行されたリポジトリまたは移行に失敗したリポジトリごとに、それぞれ 1 つのファイルが含まれています。 これらのファイルは、名前付け規則 REPO_NAME.md に従います。

Note

gei-migration-results リポジトリは移行プロセスの開始時に作成されますが、移行の完了後にのみ移行ログで更新されます。