{"meta":{"title":"Instalar e configurar o GitHub Enterprise Importer","intro":"Instale o ADO2GH extension of the GitHub CLI, e configure seu ambiente para a migração.","product":"Migrações","breadcrumbs":[{"href":"/pt/enterprise-cloud@latest/migrations","title":"Migrações"},{"href":"/pt/enterprise-cloud@latest/migrations/ado","title":"Migrar de Azure DevOps"},{"href":"/pt/enterprise-cloud@latest/migrations/ado/install-and-configure-github-enterprise-importer","title":"3. Configure o GitHub Enterprise Importer"}],"documentType":"article"},"body":"# Instalar e configurar o GitHub Enterprise Importer\n\nInstale o ADO2GH extension of the GitHub CLI, e configure seu ambiente para a migração.\n\n## Etapa 1: Instalar o ADO2GH extension of the GitHub CLI\n\nGitHub 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.\n\n1. Instale os GitHub CLI.\n   * Para obter instruções de instalação para GitHub CLI, veja o [repositório GitHub CLI](https://github.com/cli/cli#installation).\n   * 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.\n\n2. Instale os ADO2GH extension.\n\n   ```shell copy\n   gh extension install github/gh-ado2gh\n   ```\n\n3. O ADO2GH extension of the GitHub CLI é atualizado semanalmente. Para garantir que você esteja usando a última versão, atualize a extensão.\n\n   ```shell copy\n   gh extension upgrade github/gh-ado2gh\n   ```\n\nSempre 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`.\n\n## Etapa 2: Definir variáveis de ambiente\n\nAntes 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.\n\n1. 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.\n\n2. 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.\n\n   * Se você estiver usando o Terminal, use o comando `export`.\n\n     ```shell copy\n     export GH_PAT=\"TOKEN\"\n     export ADO_PAT=\"TOKEN\"\n     ```\n\n   * Se você estiver usando o PowerShell, use o comando `$env`.\n\n     ```shell copy\n     $env:GH_PAT=\"TOKEN\"\n     $env:ADO_PAT=\"TOKEN\"\n     ```\n\n3. 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.\n\n   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`.\n\n   * Se você estiver usando o Terminal, use o comando `export`.\n\n     ```shell copy\n     export TARGET_API_URL=\"https://api.SUBDOMAIN.ghe.com\"\n     ```\n\n   * Se você estiver usando o PowerShell, use o comando `$env`.\n\n     ```shell copy\n     $env:TARGET_API_URL=\"https://api.SUBDOMAIN.ghe.com\"\n     ```\n\n   Você usará essa variável com a opção `--target-api-url` em comandos executados com o GitHub CLI."}