访问 GitHub Enterprise Importer 的迁移日志

关于迁移日志

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

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

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

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

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

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

有关解释迁移日志中警告的更多信息，请参阅“GitHub Enterprise Importer 的迁移疑难解答”。

在 GitHub 上查看仓库迁移日志

具有仓库读取权限的人员可以在 GitHub 上访问该仓库的迁移日志。

导航到目标组织中的已迁移仓库。
在您的仓库名称下，单击问题.
单击标题为“迁移日志”的问题。

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

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

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

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

迁移完成后的 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 ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

如果您尚未为具有目标组织访问权限的个人访问令牌设置GH_PAT环境变量，请添加--github-target-pat TOKEN，并将TOKEN替换为个人访问令牌。有关个人访问令牌要求，请参阅“从 Azure DevOps 迁移的访问管理”。
如果您迁移到 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 替换为下载文件的名称。

Shell

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 替换为下载文件的名称。

Shell

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”。

注意

您只能将--download-migration-logs标志用于仓库迁移，不能用于组织迁移。

访问组织迁移日志

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

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

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

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

/success和/failure目录分别包含每个成功迁移或迁移失败的仓库的一个文件。这些文件遵循命名约定REPO_NAME.md。

注意

gei-migration-results仓库在迁移过程开始时创建，但仅在迁移完成后才会更新您的迁移日志。

本文内容