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.
-
Navegue até o repositório migrado na organização de destino.
-
No nome do seu repositório, clique em Problemas.
-
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.
- Como baixar um log de migração do repositório com a ADO2GH extension
- Como baixar um log de migração do repositório com a BBS2GH extension
- Como baixar um log de migração do repositório com a GEI extension
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.
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
, substituindoTOKEN
pelo personal access token. Para requisitos de personal access token, consulte "Gerenciando o acesso para uma migração do Azure DevOps". - 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 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.
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
, substituindoTOKEN
pelo personal access token. Para requisitos de personal access token, 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
.
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.
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
, substituindoTOKEN
pelo personal access token. Para requisitos de personal access token, 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 obter mais informações, confira "Sobre o GitHub Enterprise Importer".
Note
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
.
Note
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.