# Instalar e configurar o GitHub Enterprise Importer

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

## Etapa 1: Instalar o ADO2GH extension of the GitHub CLI

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

1. Instale os GitHub CLI.
   * Para obter instruções de instalação para GitHub CLI, veja o [repositório GitHub CLI](https://github.com/cli/cli#installation).
   * Se você já tiver GitHub CLI instalado, execute `gh --version` para garantir que esteja executando a versão 2.4.0 ou mais recente. Se você tiver uma versão mais antiga, visite o [GitHub CLI repositório](https://github.com/cli/cli#installation) para obter instruções de atualização.

2. Instale os ADO2GH extension.

   ```shell copy
   gh extension install github/gh-ado2gh
   ```

3. O ADO2GH extension of the GitHub CLI é atualizado semanalmente. Para garantir que você esteja usando a última versão, atualize a extensão.

   ```shell copy
   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

Antes de poder usar o ADO2GH extension para migrar para o GitHub Enterprise Cloud, você deve 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 tokenpara GitHub e Azure DevOps estão prontos. Consulte [Gerenciar acesso](/pt/enterprise-cloud@latest/migrations/ado/manage-access?token-backtrack#create-a-personal-access-token-classic-on-github) se você ainda não criou um token.

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 copy
     export GH_PAT="TOKEN"
     export ADO_PAT="TOKEN"
     ```

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

     ```shell copy
     $env:GH_PAT="TOKEN"
     $env:ADO_PAT="TOKEN"
     ```

3. Se você estiver migrando para GitHub Enterprise Cloud com residência de dados, por conveniência, defina uma variável de ambiente para a **URL de API base** para 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 copy
     export TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
     ```

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

     ```shell copy
     $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 o GitHub CLI.