关于迁移日志
每次使用 GitHub Enterprise Importer 运行迁移时，都会创建一个迁移日志。 每次迁移后都应检查迁移日志，查看是否存在任何迁移警告。
迁移日志列出了在迁移过程中完成的步骤，并包含其他信息。
- 迁移警告表示存在未按预期迁移的数据（例如问题、拉取请求或注释）
- 迁移的运行者
- 迁移的源
- 迁移需要多长时间
可以通过多种方式访问存储库迁移的迁移日志。
- 在 GitHub 上，通过查看已迁移存储库中的“迁移日志”问题。 可以利用此问题与团队讨论任何警告并记录任何决策。
- 使用 GitHub CLI 下载日志文件。
当你运行组织迁移时，GitHub Enterprise Importer 还会在目标组织中创建一个名为 gei-migration-results 的存储库。 此存储库包含有关组织级数据迁移的信息，并复制每个迁移存储库的“迁移日志”问题中的信息。
有关如何解释迁移日志中警告的详细信息，请参阅“使用 GitHub Enterprise Importer 排查迁移问题”。
在 GitHub 上查看存储库迁移日志
对存储库具有读取访问权限的人员可以访问 GitHub 上的存储库的迁移日志。
-
导航到目标组织中的已迁移存储库。
-
在存储库名称下，单击 “问题”。
-
单击标题为“迁移日志”的问题。
使用 GitHub CLI
下载存储库迁移日志
组织所有者和具有迁移者角色的组织成员可以使用 GitHub CLI 下载迁移日志。
可以使用 download-logs 命令下载单个存储库的最新迁移日志。 具体的命令取决于迁移源。
在迁移完成后的 24 小时内，可以下载迁移日志。
使用 ADO2GH extension
下载存储库迁移日志
如果迁移源是 Azure DevOps，则可以使用 gh ado2gh download-logs 命令下载单个存储库的最新迁移日志。 将 DESTINATION 替换为目标组织，将 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
- 如果尚未为具有目标组织访问权限的 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 是企业的子域的基本 API URL。 例如：https://api.octocorp.ghe.com。
使用 BBS2GH extension
下载存储库迁移日志
如果迁移源是 Bitbucket Server，则可以使用 gh bbs2gh download-logs 命令下载单个存储库的最新迁移日志。 将 DESTINATION 替换为目标组织，将 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
- 如果尚未为具有目标组织访问权限的 personal access token 设置
GH_PAT环境变量，请添加--github-target-pat TOKEN，将TOKEN替换为 personal access token。 有关 personal access token 要求，请参阅“管理从 Bitbucket Server 迁移的访问权限”。 - 如果要迁移到 GHE.com，请添加
--target-api-url TARGET-API-URL，其中 TARGET-API-URL 是企业的子域的基本 API URL。 例如：https://api.octocorp.ghe.com。
使用 GEI extension
下载存储库迁移日志
如果迁移源是 GitHub，则可以使用 gh gei download-logs 命令下载单个存储库的最新迁移日志。 将 DESTINATION 替换为目标组织，将 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
- 如果尚未为具有目标组织访问权限的 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 是企业的子域的基本 API URL。 例如：https://api.octocorp.ghe.com。
下载迁移脚本的所有存储库迁移日志
为确保可以访问所有已迁移存储库的迁移日志，可在为存储库迁移生成迁移脚本时使用 --download-migration-logs 标志。 使用此标志时，脚本将为脚本中迁移的每个存储库包含 download-logs 命令。 有关详细信息，请参阅“关于 GitHub Enterprise Importer”。
注意：只能将 --download-migration-logs 标志用于存储库迁移，而不能用于组织迁移。
访问组织迁移日志
目标组织的所有者可以访问 GitHub 上组织迁移的迁移日志。
若要访问组织迁移的迁移日志，请导航到目标组织中名为 gei-migration-results 的存储库。
存储库根目录中的 README.md 文件包含以下有关组织迁移的信息：
- 与组织级数据迁移相关的任何警告或错误，例如设置和团队
- 成功迁移的存储库数和迁移失败的存储库数
/success 和 /failure 目录分别包含一个文件，对应于迁移成功或迁移失败的每个存储库。 这些文件遵循命名约定 REPO_NAME.md。
注意：gei-migration-results 存储库是在迁移过程开始时创建的，但仅在迁移完成后才用迁移日志进行更新。