关于迁移日志
每次使用 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 迁移的访问权限”。
使用 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 迁移的访问权限”。
使用 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 产品之间迁移的访问权限”。
下载迁移脚本的所有存储库迁移日志
为确保可以访问所有已迁移存储库的迁移日志,可在为存储库迁移生成迁移脚本时使用 --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
存储库是在迁移过程开始时创建的,但仅在迁移完成后才用迁移日志进行更新。