访问 GitHub Enterprise Importer 的迁移日志

运行迁移后，您应该查看迁移日志以检查未按预期迁移的数据。

本文内容

关于迁移日志

每次使用 GitHub Enterprise Importer 运行迁移时，都会创建一个迁移日志。您应该在每次迁移后检查迁移日志，以查看任何迁移警告。

迁移日志列出了作为迁移的一部分完成的步骤，并包含其他信息。

  • 迁移警告，表示未按预期迁移的数据（例如问题、拉取请求或评论）
  • 谁运行了迁移
  • 迁移的来源
  • 迁移花费的时间

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

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

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

有关解释迁移日志中警告的更多信息，请参阅“使用 GitHub Enterprise Importer 排查迁移问题”。

在 GitHub 上查看仓库迁移日志

拥有仓库读取权限的用户可以在 GitHub 上访问仓库的迁移日志。

  1. 导航到目标组织中的迁移仓库。

  2. 在仓库名称下方，单击 问题.

    Screenshot of the main page of a repository. In the horizontal navigation bar, a tab, labeled "Issues," is outlined in dark orange.

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

使用 GitHub CLI 下载仓库迁移日志

组织所有者和拥有迁移者角色的组织成员可以使用 GitHub CLI 下载迁移日志。

您可以使用 download-logs 命令下载单个仓库的最新迁移日志。确切的命令取决于您的迁移源。

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

使用 ADO2GH 扩展下载仓库迁移日志

如果您的迁移源是 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

如果您还没有为具有目标组织访问权限的个人访问令牌设置 GH_PAT 环境变量，请添加 --github-target-pat TOKEN，将 TOKEN 替换为个人访问令牌。有关个人访问令牌要求，请参阅“管理从 Azure DevOps 迁移的访问权限”。

使用 BBS2GH 扩展下载仓库迁移日志

如果您的迁移源是 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

如果您还没有为具有目标组织访问权限的个人访问令牌设置 GH_PAT 环境变量，请添加 --github-target-pat TOKEN，将 TOKEN 替换为个人访问令牌。有关个人访问令牌要求，请参阅“管理从 Bitbucket Server 迁移的访问权限”。

使用 GEI 扩展下载仓库迁移日志

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

Shell
gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

如果您还没有为具有目标组织访问权限的个人访问令牌设置 GH_PAT 环境变量，请添加 --github-target-pat TOKEN，将 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 仓库是在迁移过程开始时创建的，但只有在迁移完成后才会使用您的迁移日志进行更新。