フェーズ 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 をインストールする必要があります。

  1. GitHub CLI をインストールします。

    • GitHub CLI のインストール手順については、GitHub CLI リポジトリを参照してください。
    • GitHub CLI が既にインストールされている場合は、 gh --version を実行して、バージョン 2.4.0 以降を実行していることを確認します。 以前のバージョンをお持ちの場合は、 GitHub CLI リポジトリ にアクセスしてアップグレード手順を確認してください。

  2. ADO2GH extension をインストールします。

    Shell
    gh extension install github/gh-ado2gh

  3. ADO2GH extension of the GitHub CLI は毎週更新されます。 最新バージョンを確実に使うため、拡張機能を更新してください。

    Shell
    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 に移行するには、その前に、移行元と移行先の Organization にアクセスできる personal access token を作成してから、personal access token を環境変数として設定する必要があります。

  1. GitHub と Azure DevOps の両方に対する personal access token が準備されていることを確認してください。 「フェーズ 2： アクセスを管理する」を参照してください。

  2. personal access tokenの環境変数を設定します。以下のコマンドにおいて、TOKENを以前に作成したpersonal access tokenに置き換えてください。 移行先の Organization には GH_PAT を使い、移行元の Organization には ADO_PAT を使います。

    • ターミナルを使っている場合は、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`されます。

    • ターミナルを使っている場合は、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 オプションと共に使用します。

次のステップ

次のフェーズでは、GitHub Enterprise Cloud を使用して移行の準備をします。 「フェーズ 4. Azure DevOps から GitHub への移行を準備する」を参照してください。