Skip to main content

访问 GitHub Enterprise Importer 的迁移日志

若要查看存储库迁移期间发生的事件和错误的记录,可以在 GitHub 上或使用 GitHub CLI 访问迁移日志。

关于迁移日志

每次使用 GitHub Enterprise Importer 运行迁移时,都会创建一个迁移日志。 迁移日志列出了在迁移过程中完成的步骤,并包含其他信息。

  • 迁移的运行者
  • 迁移的源
  • 迁移需要多长时间
  • 未按预期迁移的任何资源

可以通过多种方式访问存储库迁移的迁移日志。

  • 在 GitHub 上,通过查看已迁移存储库中的“迁移日志”问题。 可以利用此问题与团队讨论任何警告并记录任何决策。
  • 使用 GitHub CLI 下载日志文件。

当你运行组织迁移时,GitHub Enterprise Importer 还会在目标组织中创建一个名为 gei-migration-results 的存储库。 此存储库包含有关组织级数据迁移的信息,并复制每个迁移存储库的“迁移日志”问题中的信息。

若要详细了解如何解释迁移日志中的错误消息,请参阅“使用 GitHub Enterprise Importer 排查迁移问题”。

在 GitHub 上查看存储库迁移日志

对存储库具有读取访问权限的人员可以访问 GitHub 上的存储库的迁移日志。

  1. 导航到目标组织中的已迁移存储库。

  2. 在存储库名称下,单击 “问题”。

    存储库的主页的屏幕截图。 在水平导航栏中,标记有“问题”的选项卡以深橙色标出。

  3. 单击标题为“迁移日志”的问题。

使用 GitHub CLI

下载存储库迁移日志

组织所有者和具有迁移者角色的人员可以使用 GitHub CLI 下载迁移日志。 有关迁移者角色的详细信息,请参阅“为 GitHub Enterprise Importer 授予迁移者角色”。

可以使用 download-logs 命令下载单个存储库的最新迁移日志。 具体的命令取决于迁移源。

在迁移完成后的 24 小时内,可以下载迁移日志。

使用 ADO2GH extension

下载存储库迁移日志

如果迁移源是 Azure DevOps,则可以使用 gh ado2gh download-logs 命令下载单个存储库的最新迁移日志。 将 DESTINATION 替换为目标组织,将 REPOSITORY 替换为存储库名称,并将 FILENAME 替换为下载的文件的文件名。

Shell
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 要求的信息,请参阅“管理 GitHub Enterprise Importer 的访问权限”。

使用 BBS2GH extension

下载存储库迁移日志

如果迁移源是 Bitbucket Server,则可以使用 gh bbs2gh download-logs 命令下载单个存储库的最新迁移日志。 将 DESTINATION 替换为目标组织,将 REPOSITORY 替换为存储库名称,并将 FILENAME 替换为下载的文件的文件名。

Shell
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 要求的信息,请参阅“管理 GitHub Enterprise Importer 的访问权限”。

使用 GEI extension

下载存储库迁移日志

如果迁移源是 GitHub,则可以使用 gh gei download-logs 命令下载单个存储库的最新迁移日志。 将 DESTINATION 替换为目标组织,将 REPOSITORY 替换为存储库名称,并将 FILENAME 替换为下载的文件的文件名。

Shell
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 Enterprise Importer 的访问权限”。

下载迁移脚本的所有存储库迁移日志

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