安装和配置 GitHub Enterprise Importer

步骤 1：安装 GitHub CLI 的 ADO2GH 扩展

GitHub Enterprise Importer 是 GitHub CLI 的一组扩展。如果这是您第一次迁移，您需要安装 GitHub CLI 和 ADO2GH 扩展。

1. 安装 GitHub CLI。

   • 有关 GitHub CLI 的安装说明，请参阅 GitHub CLI 仓库。
   • 如果您已经安装了 GitHub CLI，请运行 gh --version 以确保您使用的版本是 2.4.0 或更高。如果您使用的是旧版本，请访问 GitHub CLI 仓库 获取升级指南。

2. 安装 ADO2GH 扩展。

   Shell

   gh extension install github/gh-ado2gh
   

3. GitHub CLI 的 ADO2GH 扩展每周更新。为确保使用最新版本，请更新该扩展。

   Shell

   gh extension upgrade github/gh-ado2gh
   

任何时候需要 ADO2GH 扩展的帮助，都可以在命令中使用 --help 标志。例如，gh ado2gh --help 将列出所有可用的命令，gh ado2gh migrate-repo --help 将列出 migrate-repo 命令的所有选项。

步骤 2：设置环境变量

在使用 ADO2GH 扩展迁移到 GitHub Enterprise Cloud 之前，您必须创建能够访问源组织和目标组织的个人访问令牌，然后将这些个人访问令牌设置为环境变量。

1. 确保您已经准备好 GitHub 和 Azure DevOps 的个人访问令牌。如果尚未创建令牌，请参阅 管理访问。

2. 为个人访问令牌设置环境变量，在下面的命令中将 TOKEN 替换为您之前创建的个人访问令牌。目标组织使用 GH_PAT，源组织使用 ADO_PAT。

   • 如果您使用 Terminal，请使用 export 命令。

     Shell

     export GH_PAT="TOKEN"
     export ADO_PAT="TOKEN"
     

   • 如果您使用 PowerShell，请使用 $env 命令。

     Shell

     $env:GH_PAT="TOKEN"
     $env:ADO_PAT="TOKEN"
     

3. 如果您正在迁移到具有数据驻留的 GitHub Enterprise Cloud，为方便起见，请为您企业的 基础 API URL 设置环境变量。

   确保将 SUBDOMAIN 替换为您企业的子域。例如，如果企业子域为 acme，则 TARGET_API_URL 的值应为 https://api.acme.ghe.com。

   • 如果您使用 Terminal，请使用 export 命令。

     Shell

     export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     

   • 如果您使用 PowerShell，请使用 $env 命令。

     Shell

     $env:TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     

   您将在使用 GitHub CLI 运行的命令中，通过 --target-api-url 选项使用此变量。