Skip to main content

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

GL2GH extension of the GitHub CLIをインストールし、移行用に環境を構成します。

手順 1: GL2GH extension of the GitHub CLIをインストールしてください。

GitHub Enterprise Importer は、 GitHub CLIの拡張機能のコレクションです。 これが最初の移行である場合は、 GitHub CLI と GL2GH extensionをインストールする必要があります。

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

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

    Shell
    gh extension install github/gh-gl2gh
    
  3. GL2GH extension of the GitHub CLIは頻繁に更新されます。 最新バージョンを確実に使うため、拡張機能を更新してください。

    Shell
    gh extension upgrade github/gh-gl2gh
    

手順 2: 環境変数を設定する

GL2GH extensionを使用してGitHub Enterprise Cloudに移行するには、ソースと宛先にアクセスできるpersonal access tokenを作成してから、personal access tokenを環境変数として設定する必要があります。

  1. personal access tokenと GitLab の両方のGitHubが準備されていることを確認します。 トークンをまだ作成していない場合は、 GitLab から GitHub への移行のアクセスを管理する を参照してください。

  2. personal access tokenの環境変数を設定します。次のコマンドの TOKEN は、前に作成したpersonal access tokenに置き換えます。 移行先の組織に GH_PAT を使用し、ソース GitLab インスタンスの GITLAB_PAT を使用します。

    • ターミナルを使っている場合は、export コマンドを使います。

      Shell
      export GH_PAT="TOKEN"
      export GITLAB_PAT="TOKEN"
      
    • PowerShell を使っている場合は、$env コマンドを使います。

      Shell
      $env:GH_PAT="TOKEN"
      $env:GITLAB_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 オプションと共に使用します。