访问 GitHub Enterprise Importer 的迁移日志

关于迁移日志

每次使用 GitHub Enterprise Importer 运行迁移时，都会生成迁移日志。每次迁移后都应检查迁移日志，以审阅任何迁移警告。

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

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

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

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

当您运行组织迁移时，GitHub Enterprise Importer 还会在目标组织中创建一个名为 gei-migration-results 的仓库。该仓库包含组织级数据迁移的信息，并对每个已迁移仓库的 “Migration Log” 议题中的信息进行复制。

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

在 GitHub 上查看仓库迁移日志

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

1. 前往目标组织中已迁移的仓库。

2. 在仓库名称下，点击 议题。

   

3. 点击标题为 “Migration Log” 的议题。

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

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

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

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

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

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

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

• 如果尚未为拥有目标组织访问权限的个人访问令牌设置 GH_PAT 环境变量，请添加 --github-target-pat TOKEN，将 TOKEN 替换为个人访问令牌。有关个人访问令牌的要求，请参阅 管理访问。
• 如果您迁移到 GHE.com，请添加 --target-api-url TARGET-API-URL，其中 TARGET-API-URL 是您企业子域的基础 API URL。例如：https://api.octocorp.ghe.com。

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

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

• 如果尚未为拥有目标组织访问权限的个人访问令牌设置 GH_PAT 环境变量，请添加 --github-target-pat TOKEN，将 TOKEN 替换为个人访问令牌。有关个人访问令牌的要求，请参阅 管理 Bitbucket Server 迁移的访问。
• 如果您迁移到 GHE.com，请添加 --target-api-url TARGET-API-URL，其中 TARGET-API-URL 是您企业子域的基础 API URL。例如：https://api.octocorp.ghe.com。

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

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

• 如果尚未为拥有目标组织访问权限的个人访问令牌设置 GH_PAT 环境变量，请添加 --github-target-pat TOKEN，将 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。

访问组织迁移日志

目标组织的所有者可以在 GitHub 上访问组织迁移的迁移日志。

要访问组织迁移的迁移日志，请前往目标组织中名为 gei-migration-results 的仓库。

仓库根目录下的 README.md 文件包含以下关于组织迁移的信息

• 任何与组织级数据迁移相关的警告或错误，例如设置和团队
• 成功迁移的仓库数量以及迁移失败的仓库数量

The/success and /failure directories contain one file for each repository that was successfully migrated or that failed to migrate, respectively. These files follow the naming convention REPO_NAME.md.