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

Sobre os logs de migração

Cada vez que você executa uma migração com 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.

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

Ao executar uma migração da organização, além disso, GitHub Enterprise Importer cria um repositório nomeado 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 issues do "Migration Log" 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.

Exibindo um log de migração de repositório em GitHub

Pessoas com acesso de leitura a um repositório podem acessar o log de migração do repositório em GitHub.

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

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

   

3. Clique na questão com o título "Log de Migração".

Baixar um log de migração de um repositório com o GitHub CLI

Os proprietários da organização e os membros da organização com a função migradora podem baixar os logs de migração usando o 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.

• Baixando um log de migração de repositório com o ADO2GH extension
• Baixando um log de migração de repositório com o BBS2GH extension
• Baixando um log de migração de repositório com o GEI extension

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

Baixando um log de migração de repositório com o 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.

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

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.

• Se você estiver migrando para o GHE.com, adicione --target-api-url TARGET-API-URL, em que TARGET-API-URL é a URL da API base para o subdomínio da sua empresa. Por exemplo: https://api.octocorp.ghe.com.

Baixando um log de migração de repositório com o 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.

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

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 personal access token obter requisitos, consulte Gerenciar o acesso para uma migração do Bitbucket Server.
• Se você estiver migrando para o GHE.com, adicione --target-api-url TARGET-API-URL, em que TARGET-API-URL é a URL da API base para o subdomínio da sua empresa. Por exemplo: https://api.octocorp.ghe.com.

Baixando um log de migração de repositório com o GEI extension

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

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

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 personal access token obter requisitos, consulte Gerenciando o acesso para uma migração entre produtos GitHub.
• Se você estiver migrando para o GHE.com, adicione --target-api-url TARGET-API-URL, em que TARGET-API-URL é a URL da API base para o subdomínio da sua empresa. Por exemplo: https://api.octocorp.ghe.com.

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 saber mais, confira Sobre o GitHub Enterprise Importer.

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 de organização em 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.