Skip to main content

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 リポジトリ](https://github.com/cli/cli#installation) にアクセスしてアップグレード手順を確認してください。
      
  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の両方に対して用意されていることを確認します。 トークンをまだ作成していない場合は、 アクセスの管理 を参照してください。 1. 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"
    
  1.        データ所在地付き 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 オプションと共に使用します。