# 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がGitHubとAzure DevOpsの両方に対して用意されていることを確認します。 トークンをまだ作成していない場合は、 [アクセスの管理](/ja/enterprise-cloud@latest/migrations/ado/manage-access?token-backtrack#create-a-personal-access-token-classic-on-github) を参照してください。

2. personal access tokenの環境変数を設定します。次のコマンドの TOKEN は、前に作成したpersonal access tokenに置き換えます。 移行先の Organization には `GH_PAT` を使い、移行元の Organization には `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 オプションと共に使用します。