# 安装和配置 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。

1. 安装 GitHub CLI。
   * 有关 GitHub CLI 的安装说明，请参阅 [GitHub CLI 存储库](https://github.com/cli/cli#installation)。
   * 如果已安装 GitHub CLI ，请运行 `gh --version` 以确保运行版本 2.4.0 或更高版本。 如果有较旧版本，请访问 [GitHub CLI 存储库](https://github.com/cli/cli#installation) 以获取升级说明。

2. 安装 ADO2GH extension。

   ```shell copy
   gh extension install github/gh-ado2gh
   ```

3. ADO2GH extension of the GitHub CLI 每周更新一次。 为了确保使用的是最新版本，请更新扩展。

   ```shell copy
   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设定为环境变量。

1. 确保你已准备好 personal access token 和 Azure DevOps 的 GitHub。 如果尚未创建令牌，请参阅 [管理访问权限](/zh/migrations/ado/manage-access?token-backtrack#create-a-personal-access-token-classic-on-github) 。

2. 为personal access token设置环境变量，将以下命令中的 TOKEN 替换为之前创建的personal access token。 将 `GH_PAT` 用于目标组织，并将 `ADO_PAT` 用于源组织。

   * 如果使用终端，请使用 `export` 命令。

     ```shell copy
     export GH_PAT="TOKEN"
     export ADO_PAT="TOKEN"
     ```

   * 如果使用 PowerShell，请使用 `$env` 命令。

     ```shell copy
     $env:GH_PAT="TOKEN"
     $env:ADO_PAT="TOKEN"
     ```

3. 如果要迁移到 带有数据驻留权的 GitHub Enterprise Cloud，为方便起见，请为企业 **的基本 API URL** 设置环境变量。

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

   * 如果使用终端，请使用 `export` 命令。

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

   * 如果使用 PowerShell，请使用 `$env` 命令。

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

   你将将此变量与在命令中运行`--target-api-url`的选项一起使用GitHub CLI。