访问 GitHub Enterprise Importer 的迁移日志

运行迁移后应查看迁移日志，检查是否存在未按预期迁移的数据。

本文内容

关于迁移日志

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

迁移日志列出了在迁移过程中完成的步骤，并包含其他信息。

  • 迁移警告表示存在未按预期迁移的数据（例如问题、拉取请求或注释）
  • 迁移的运行者
  • 迁移的源
  • 迁移需要多长时间

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

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

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

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

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

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

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

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

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

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

使用 GitHub CLI

下载存储库迁移日志

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

可以使用 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 要求，请参阅“管理从 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 替换为下载的文件的文件名。

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 要求，请参阅“管理从 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 替换为下载的文件的文件名。

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 产品之间迁移的访问权限”。
  • 如果要迁移到 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 存储库是在迁移过程开始时创建的，但仅在迁移完成后才用迁移日志进行更新。