GitHub Enterprise Importer をインストールして構成する

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

1. personal access tokenがGitHubとAzure DevOpsの両方に対して用意されていることを確認します。 トークンをまだ作成していない場合は、 アクセスの管理 を参照してください。

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"
  

この変数は、--target-api-urlで実行するコマンドの GitHub CLI オプションと共に使用します。