Skip to main content
Skip to content

Install and configure GitHub Enterprise Importer

Install the ADO2GH extension of the GitHub CLI and configure your environment for the migration.

Step 1: Install the ADO2GH extension of the GitHub CLI

GitHub Enterprise Importer is a collection of extensions for GitHub CLI. If this is your first migration, you'll need to install GitHub CLI and the 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 команды.

Step 2: Set environment variables

Before you can use the ADO2GH extension to migrate to GitHub Enterprise Cloud, you must create personal access tokens that can access the source and destination organizations, then set the personal access tokens as environment variables.

  1. Make sure you have your personal access tokens for both GitHub and Azure DevOps ready. See Manage access if you haven't already created a token.

  2. Set environment variables for the personal access tokens, replacing TOKEN in the commands below with the personal access tokens you previously created. Use GH_PAT for the destination organization and ADO_PAT for the source organization.

    • If you're using Terminal, use the export command.

      Shell
      export GH_PAT="TOKEN"
      export ADO_PAT="TOKEN"
      
    • If you're using PowerShell, use the $env command.

      Shell
      $env:GH_PAT="TOKEN"
      $env:ADO_PAT="TOKEN"
      
  3. Если вы переходите на GitHub Enterprise Cloud с размещением данных, для удобства, установите переменную среды для базового URL API для вашего предприятия.

    Убедитесь, что вы заменили 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.