阶段 3。安装和配置 GitHub Enterprise Importer

安装 ADO2GH extension of the GitHub CLI 并配置环境以进行迁移。

在本文中

步骤 1：安装 ADO2GH extension of the GitHub CLI

GitHub Enterprise Importer 是 GitHub CLI 的扩展集合。如果这是您首次进行迁移，则需要安装 GitHub CLI 和 ADO2GH extension。

安装 GitHub CLI。
- 有关 GitHub CLI 的安装说明，请参阅 GitHub CLI 存储库。
- 如果您已经安装了GitHub CLI，请运行gh --version以确保所运行的版本为2.4.0或更新版本。如果你有较旧版本，请访问 GitHub CLI 存储库以获取升级说明。

安装 ADO2GH extension。

Shell

gh extension install github/gh-ado2gh

gh extension install github/gh-ado2gh

ADO2GH extension of the GitHub CLI 每周更新一次。为了确保使用的是最新版本，请更新扩展。
Shell
```
gh extension upgrade github/gh-ado2gh
```
```
gh extension upgrade github/gh-ado2gh
```

每当需要有关 ADO2GH extension 的帮助时，都可以将 --help 标志与命令一起使用。例如，gh ado2gh --help 会列出所有可用命令，gh ado2gh migrate-repo --help 会列出 migrate-repo 命令的所有可用选项。

步骤 2：设置环境变量

在使用 ADO2GH extension 迁移到 GitHub Enterprise Cloud 之前，必须创建可以访问源和目标组织的 personal access token，然后将 personal access token 设置为环境变量。

请确保你为 GitHub 和 Azure DevOps 准备好了 personal access token。请参阅“阶段 2。管理访问权限”。
为 personal access token 设置环境变量，将以下命令中的 TOKEN 替换为之前创建的 personal access token。将 GH_PAT 用于目标组织，并将 ADO_PAT 用于源组织。
- 如果使用终端，请使用 export 命令。
  Shell
```
export GH_PAT="TOKEN"
export ADO_PAT="TOKEN"
```
```
export GH_PAT="TOKEN"
export ADO_PAT="TOKEN"
```
- 如果使用 PowerShell，请使用 $env 命令。
  Shell
```
$env:GH_PAT="TOKEN"
$env:ADO_PAT="TOKEN"
```
```
$env:GH_PAT="TOKEN"
$env:ADO_PAT="TOKEN"
```
如果要迁移到具有数据驻留的 GitHub Enterprise Cloud，为方便起见，请为企业的基 API URL 设置环境变量。****

确保将 SUBDOMAIN 替换为您企业的子域。例如，如果企业的子域为 acme，则 TARGET_API_URL 值为 https://api.acme.ghe.com。
- 如果使用终端，请使用 export 命令。
  Shell
```
export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
```
```
export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
```
- 如果使用 PowerShell，请使用 $env 命令。
  Shell
```
$env:TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
```
```
$env:TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
```
在使用 GitHub CLI 运行的命令中，将此变量与 --target-api-url 选项一起使用。

后续步骤

在下一阶段，您将使用 GitHub Enterprise Cloud 来准备迁移。请参阅“阶段 4. 准备从 Azure DevOps 迁移到 GitHub”。