Skip to main content

Como acessar os logs de migração do GitHub Enterprise Importer

Depois de executar uma migração, você deve revisar o log de migração para verificar se há dados que não migraram conforme o esperado.

Sobre os logs de migração

Sempre que você executa uma migração com o GitHub Enterprise Importer, um log de migração é criado. Você deve verificar o log de migração após cada migração para revisar quaisquer avisos de migração.

O log de migração lista as etapas que foram concluídas como parte da migração e inclui informações adicionais.

  • Avisos de migração, representando dados (como problemas, solicitações de pull ou comentários) que não migraram conforme o esperado
  • Quem executou a migração
  • A origem da migração
  • O tempo que a migração levou

Você pode acessar o log de migração de uma migração de repositório de várias maneiras.

  • No GitHub, visualizando o problema do "Log de Migração" no repositório migrado. Use esse problema para discutir os avisos com a sua equipe e registrar as decisões.
  • Baixando um arquivo de log usando a GitHub CLI.

Quando você executa uma migração de organização, o GitHub Enterprise Importer também cria um repositório chamado gei-migration-results na organização de destino. Esse repositório contém informações sobre a migração de dados no nível da organização e duplica as informações nos problemas do "Log de Migração" para cada repositório migrado.

Para obter mais informações sobre como interpretar os avisos do log de migração, confira "Solução de problemas de migração com o GitHub Enterprise Importer".

Como exibir um log de migração do repositório no GitHub

As pessoas com acesso de leitura em um repositório podem acessar o log de migração do repositório no GitHub.

  1. Navegue até o repositório migrado na organização de destino.

  2. No nome do seu repositório, clique em Problemas.

    Captura de tela da página principal de um repositório. Na barra de navegação horizontal, uma guia, rotulada como "Problemas", é destacada em laranja escuro.

  3. Clique no problema com o título "Log de Migração".

Como baixar um log de migração do repositório com a GitHub CLI

Os proprietários da organização e os membros da organização com a função de migrador podem baixar os logs de migração usando a GitHub CLI.

Baixe o log de migração mais recente de um repositório individual com o comando download-logs. O comando exato depende da origem da migração.

Os logs de migração ficam disponíveis para download durante 24 horas após a conclusão da migração.

Como baixar um log de migração do repositório com a ADO2GH extension

Se a origem da migração for o Azure DevOps, baixe o log de migração mais recente de um repositório individual com o comando gh ado2gh download-logs. Substitua DESTINATION pela organização de destino, REPOSITORY pelo nome do repositório e FILENAME pelo nome do arquivo baixado.

Shell
gh ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

Se você ainda não tiver uma variável de ambiente GH_PAT definida para um personal access token com acesso à organização de destino, adicione --github-target-pat TOKEN, substituindo TOKEN pelo personal access token. Para requisitos de personal access token, consulte "Gerenciando o acesso para uma migração do Azure DevOps".

Como baixar um log de migração do repositório com a BBS2GH extension

Se a origem da migração for o Bitbucket Server, baixe o log de migração mais recente de um repositório individual com o comando gh bbs2gh download-logs. Substitua DESTINATION pela organização de destino, REPOSITORY pelo nome do repositório e FILENAME pelo nome do arquivo baixado.

Shell
gh bbs2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

Se você ainda não tiver uma variável de ambiente GH_PAT definida para um personal access token com acesso à organização de destino, adicione --github-target-pat TOKEN, substituindo TOKEN pelo personal access token. Para requisitos de personal access token, consulte "Gerenciar o acesso para uma migração do Bitbucket Server".

Como baixar um log de migração do repositório com a GEI extension

Se a origem de migração for um produto do GitHub, baixe o log de migração mais recente de um repositório individual com o comando gh gei download-logs. Substitua DESTINATION pela organização de destino, REPOSITORY pelo nome do repositório e FILENAME pelo nome do arquivo baixado.

Shell
gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

Se você ainda não tiver uma variável de ambiente GH_PAT definida para um personal access token com acesso à organização de destino, adicione --github-target-pat TOKEN, substituindo TOKEN pelo personal access token. Para requisitos de personal access token, consulte "Gerenciando o acesso para uma migração entre produtos GitHub".

Como baixar todos os logs de migração do repositório para um script de migração

Para garantir que você tenha acesso aos logs de migração de todos os repositórios migrados, use o sinalizador --download-migration-logs ao gerar um script de migração para as migrações de repositório. Quando você usar esse sinalizador, o script incluirá o comando download-logs para cada repositório migrado no script. Para obter mais informações, confira "Sobre o GitHub Enterprise Importer".

Observação: você só pode usar o sinalizador --download-migration-logs com migrações de repositório, não com migrações de organização.

Como acessar o log de migração de uma organização

Os proprietários da organização de destino podem acessar o log de migração de uma migração da organização no GitHub.

Para acessar o log de migração da migração de uma organização, navegue até o repositório chamado gei-migration-results na organização de destino.

O arquivo README.md na raiz do repositório inclui as seguintes informações sobre a migração da organização:

  • Todos os avisos ou erros relacionados à migração de dados no nível da organização, como configurações e equipes
  • O número de repositórios que foram migrados com sucesso e o número de repositórios que não foram migrados

Os diretórios /success e /failure contêm um arquivo para cada repositório que foi migrado com sucesso ou que não foi migrado, respectivamente. Esses arquivos seguem a convenção de nomenclatura REPO_NAME.md.

Observação: o repositório gei-migration-results é criado no início do processo de migração, mas só é atualizado com os logs de migração após a conclusão da migração.