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.
-
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 --versionpara 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.
-
Instale os GL2GH extension.
Shell gh extension install github/gh-gl2gh
gh extension install github/gh-gl2gh -
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
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.
-
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.
-
Defina variáveis de ambiente para os personal access tokens, substituindo TOKEN nos comandos abaixo pelos personal access tokens criados anteriormente. Use
GH_PATpara a organização de destino eGITLAB_PATpara 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"
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"
$env:GH_PAT="TOKEN" $env:GITLAB_PAT="TOKEN"
-
-
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
SUBDOMAINpelo subdomínio da sua empresa. Por exemplo, se o subdomínio da sua empresa foracme, oTARGET_API_URLvalor 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"
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"
$env:TARGET_API_URL="https://api.SUBDOMAIN.ghe.com"
Você usará essa variável com a opção
--target-api-urlem comandos executados com o GitHub CLI. -