Skip to main content

Instalar e configurar o GitHub Enterprise Importer

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

Etapa 1: Instalar o GL2GH 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 GL2GH extension.

  1. Instale os GitHub CLI.

    • Para obter instruções de instalação para GitHub CLI, veja o repositório GitHub CLI.
    • 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 para obter instruções de atualização.
  2. Instale os GL2GH extension.

    Shell
    gh extension install github/gh-gl2gh
    
  3. A GL2GH extension of the GitHub CLI atualização é atualizada com frequência. Para garantir que você esteja usando a última versão, atualize a extensão.

    Shell
    gh extension upgrade github/gh-gl2gh
    

Etapa 2: Definir variáveis de ambiente

Antes de poder usar o GL2GH extension para migrar GitHub Enterprise Cloud, você deve criar personal access tokens que possam acessar a origem e o destino e, em seguida, definir os personal access tokens como variáveis de ambiente.

  1. Verifique se você tem seus personal access tokens para ambos GitHub e GitLab prontos. Consulte Gerenciar o acesso para uma migração do GitLab para o 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 GITLAB_PAT para a instância do GitLab de origem.

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

      Shell
      export GH_PAT="TOKEN"
      export GITLAB_PAT="TOKEN"
      
    • Se você estiver usando o PowerShell, use o comando $env.

      Shell
      $env:GH_PAT="TOKEN"
      $env:GITLAB_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
      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 o GitHub CLI.