記事のバージョン: Enterprise Server 2.17
移行データのレビュー
移行のすべてのステップの後で、移行データの状態をレビューできます。 レコードが適切にマップあるいは名称変更されること、インポートのステップの後にレコードに新しいURLが得られること、移行に失敗したレコードがリストアップされることを確認できます。
デフォルトでは、ghe-migrator audit はすべてのレコードを返します。 また、以下の条件でレコードをフィルタリングすることもできます。
- レコードのタイプ。
- レコードの状態。
レコードタイプは移行データにあるものとマッチします。
レコードタイプのフィルタ
| レコードタイプ | フィルタ名 | 
|---|---|
| ユーザ | ユーザ | 
| Organization | Organization | 
| リポジトリ | リポジトリ | 
| Team | Team | 
| マイルストーン | マイルストーン | 
| プロジェクトボード | project | 
| 問題 | Issue | 
| Issueのコメント | issue_comment | 
| プルリクエスト | pull_request | 
| プルリクエストのレビュー | pull_request_review | 
| コミットのコメント | commit_comment | 
| プルリクエストのレビューのコメント | pull_request_review_comment | 
| リリース | リリース | 
| プルリクエストあるいはIssueに対して行われたアクション | issue_event | 
| 保護されたブランチ | protected_branch | 
レコードの状態フィルタ
| レコードの状態 | 説明 | 
|---|---|
| export | レコードはエクスポートされます。 | 
| import | レコードはインポートされます。 | 
| map | レコードはマップされます。 | 
| rename | レコードの名前が変更されます。 | 
| マージ | レコードはマージされます。 | 
| exported | レコードはエクスポートに成功しました。 | 
| imported | レコードはインポートに成功しました。 | 
| mapped | レコードはマップに成功しました。 | 
| renamed | レコードの名前の変更に成功しました。 | 
| merged | レコードはマージに成功しました。 | 
| failed_export | レコードはエクスポートに失敗しました。 | 
| failed_import | レコードはインポートに失敗しました。 | 
| failed_map | レコードはマップに失敗しました。 | 
| failed_rename | レコードの名前の変更に失敗しました。 | 
| failed_merge | レコードはマージに失敗しました。 | 
監査されたレコードのフィルタリング
ghe-migrator auditでは、-mフラグを使ってレコードタイプに基づくフィルタリングができます。 同様に、-sフラグでインポートの状態に対してフィルタリングができます。 コマンドは以下のようになります。
$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION_GUIDたとえば、インポートに成功したすべてのOrganizationとチームを見るには以下のようにします。
$ ghe-migrator audit -m organization,team -s mapped,renamed -g MIGRATION_GUID
> model_name,source_url,target_url,state
> organization,https://gh.source/octo-org/,https://ghe.target/octo-org/,renamed失敗したすべてのインポートを監査することを強くおすすめします。そのためには以下のようにします。
$ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g MIGRATION_GUID
> model_name,source_url,target_url,state
> user,https://gh.source/octocat,https://gh.target/octocat,failed
> repository,https://gh.source/octo-org/octo-project,https://ghe.target/octo-org/octo-project,failed失敗したインポートに関する懸念があるなら、GitHub Enterprise Support または GitHub Premium Supportに連絡してください。