移行ログについて
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 上のリポジトリの移行ログにアクセスできます。
-
移行先 Organization の移行済みリポジトリに移動します。
-
リポジトリ名の下にある [イシュー] をクリックします。
-
"移行ログ" というタイトルの issue をクリックします。
GitHub CLI
を使ったリポジトリ移行ログのダウンロード
Organization の所有者と移行者ロールを持つ Organization のメンバーは、GitHub CLI を使って移行ログをダウンロードできます。
download-logs
コマンドを使って、個々のリポジトリの最新の移行ログをダウンロードできます。 正確なコマンドは、移行元によって異なります。
- ADO2GH extension を使ったリポジトリ移行ログのダウンロード
- BBS2GH extension を使ったリポジトリ移行ログのダウンロード
- GEI extension を使ったリポジトリ移行ログのダウンロード
移行ログをダウンロードできるのは、移行が完了してから 24 時間です。
ADO2GH extension
を使ったリポジトリ移行ログのダウンロード
移行元が Azure DevOps の場合は、gh ado2gh download-logs
コマンドを使って個々のリポジトリの最新の移行ログをダウンロードできます。 DESTINATION を移行先の Organization に、REPOSITORY をリポジトリ名に、FILENAME をダウンロードしたファイルのファイル名に、それぞれ置き換えます。
gh ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
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 をダウンロードしたファイルのファイル名に、それぞれ置き換えます。
gh bbs2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
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 をダウンロードしたファイルのファイル名に、それぞれ置き換えます。
gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
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
リポジトリは移行プロセスの開始時に作成されますが、移行の完了後にのみ移行ログで更新されます。