Fase 3. Instalar e configurar o GitHub Enterprise Importer

Instale o ADO2GH extension of the GitHub CLI e configure seu ambiente para a migração.

Neste artigo

Etapa 1: instalar o ADO2GH extension of the GitHub CLI

O GitHub Enterprise Importer é um conjunto de extensões para GitHub CLI. Se essa for sua primeira migração, você precisará instalar GitHub CLI e o ADO2GH extension.

  1. Instale o GitHub CLI.

    • Para obter instruções de instalação para GitHub CLI, veja o repositório GitHub CLI.
    • Se você já tiver GitHub CLI instalados, execute gh --version para garantir que você esteja executando a versão 2.4.0 ou mais recente. Se você tiver uma versão mais antiga, visite o repositório GitHub CLI para obter instruções de atualização.

  2. Instalar o ADO2GH extension.

    Shell
    gh extension install github/gh-ado2gh

  3. O ADO2GH extension of the GitHub CLI é atualizado semanalmente.

    Shell
    gh extension upgrade github/gh-ado2gh

Sempre que precisar de ajuda com a ADO2GH extension, use o sinalizador --help com um comando. Por exemplo, gh ado2gh --help listará todos os comandos disponíveis, e gh ado2gh migrate-repo --help listará todas as opções disponíveis para o comando migrate-repo.

Etapa 2: Definir variáveis de ambiente

Para usar o ADO2GH extension para migrar para o GitHub Enterprise Cloud, você precisará criar personal access tokens que possam acessar as organizações de origem e de destino e definir os personal access tokens como variáveis de ambiente.

  1. Verifique se seus personal access token para GitHub e Azure DevOps estão prontos. Confira Fase 2. Gerenciar acesso.

  2. Defina variáveis de ambiente para os personal access tokens, substituindo TOKEN nos comandos abaixo pelos personal access tokens criados anteriormente. Use GH_PAT para a organização de destino e ADO_PAT para a organização de origem.

    • Se você estiver usando o Terminal, use o comando export.

      Shell
      export GH_PAT="TOKEN"
export ADO_PAT="TOKEN"

    • Se você estiver usando o PowerShell, use o comando $env.

      Shell
      $env:GH_PAT="TOKEN"
$env:ADO_PAT="TOKEN"

  3. Se você estiver migrando para o GitHub Enterprise Cloud com residência de dados, por questões de conveniência, defina uma variável de ambiente para a URL de API base da sua empresa.

    Certifique-se de substituir SUBDOMAIN pelo subdomínio da sua empresa. Por exemplo, se o subdomínio da sua empresa for acme, o TARGET_API_URL valor será https://api.acme.ghe.com.

    • Se você estiver usando o Terminal, use o comando export.

      Shell
      export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"

    • Se você estiver usando o PowerShell, use o comando $env.

      Shell
      $env:TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"

    Você usará essa variável com a opção --target-api-url em comandos executados com a GitHub CLI.

Próximas etapas

Na próxima fase, você usará GitHub Enterprise Cloud para se preparar para a migração. Confira Fase 4. Preparar sua migração do Azure DevOps para o GitHub.