{"meta":{"title":"Solução de problemas de migração com o GitHub Enterprise Importer","intro":"Caso ocorra uma falha na migração ou ela produza resultados inesperados, experimente as etapas comuns de solução de problemas.","product":"Migrações","breadcrumbs":[{"href":"/pt/migrations","title":"Migrações"},{"href":"/pt/migrations/troubleshooting","title":"Solução de problemas de migrações"},{"href":"/pt/migrations/troubleshooting/troubleshooting-your-migration-with-github-enterprise-importer","title":"Solução de problemas de migrações"}],"documentType":"article"},"body":"# Solução de problemas de migração com o GitHub Enterprise Importer\n\nCaso ocorra uma falha na migração ou ela produza resultados inesperados, experimente as etapas comuns de solução de problemas.\n\n## Sobre as etapas de solução de problemas para GitHub Enterprise Importer\n\nCaso ocorra uma falha na migração ou ela produza resultados inesperados, experimente as primeiras etapas da solução de problemas abaixo, que normalmente resolvem uma variedade de problemas. Se essas primeiras etapas não resolverem o problema, verifique se há mensagens de erro nos logs para a migração. Em seguida, localize a mensagem de erro neste artigo e experimente as etapas de resolução.\n\nSe você não conseguir resolver o problema depois de tentar as etapas de solução de problemas da mensagem de erro, poderá entrar em contato Suporte do GitHub.\n\n## Primeiras etapas para a solução de problemas\n\nAntes de investigar mais a fundo, experimente estas etapas de solução de problemas que normalmente resolvem uma variedade de problemas.\n\n1. Verifique se você está usando a versão mais recente da GitHub CLI extensão que está usando para migrar. Caso contrário, atualize para a última versão.\n\n2. Verifique se você atendeu a todos os requisitos de acesso. Para obter mais informações, consulte o artigo apropriado para o caminho de migração.\n\n   * [Gerenciar acesso](/pt/migrations/ado/manage-access)\n   * [Gerenciar o acesso para uma migração do Bitbucket Server](/pt/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/managing-access-for-a-migration-from-bitbucket-server)\n   * [Gerenciando o acesso para uma migração entre produtos GitHub](/pt/migrations/using-github-enterprise-importer/migrating-between-github-products/managing-access-for-a-migration-between-github-products)\n\n3. Tente executar a migração novamente. Alguns problemas de migrações são transitórios. Tentar novamente pode funcionar.\n\n4. Tente executar uma migração em outros repositórios com os dados semelhantes. Isso ajudará a determinar se o problema é exclusivo do repositório ou se representa um problema de formato de dados mais amplo.\n\nSe essas etapas não resolverem o problema, analise os logs de migração em busca de mensagens de erro. O log que precisará ser verificado varia conforme a falha ou sucesso da migração.\n\n## Solução de problemas de falhas em migrações\n\nSe a migração falhar, examine as entradas de log detalhadas produzidas por GitHub CLI para cada migração. O arquivo de log é salvo no mesmo diretório em que você executou a migração.\n\nO log contém um registro de cada comando que você emitiu e todas as solicitações de API que o GitHub CLI fez em resposta. Normalmente, as falhas e as mensagens de erro são exibidas no final do log.\n\n* [Não é possível executar a migração](#unable-to-run-migrations)\n* [O recurso está protegido pela aplicação do SAML da organização](#resource-is-protected-by-organization-saml-enforcement)\n* [Resposta `401 Unauthorized`](#401-unauthorized-response)\n* [Resposta `404 Not Found`](#404-not-found-response)\n* [Resposta `Archive generation failed`](#archive-generation-failed-response)\n* [Erro `cipher name is not supported`](#cipher-name-is-not-supported-error)\n* [Erro `Subsystem 'sftp' could not be executed`](#subsystem-sftp-could-not-be-executed-error)\n* [Erro `Source export archive... does not exist`](#source-export-archive-does-not-exist-error)\n* [Erro `Repository rule violations found`](#repository-rule-violations-found-error)\n* [Erro `Your push would publish a private email address`](#your-push-would-publish-a-private-email-address-error)\n\n### Não é possível executar migrações\n\nSe você observar um erro como `No access to createMigrationMutation` ou `Missing permissions`, sua conta pessoal não terá o acesso necessário para executar a migração. Verifique se você é um proprietário da organização ou se recebeu a função de migrador. Para obter mais informações sobre como conceder a função de migrador, confira [Sobre o GitHub Enterprise Importer](/pt/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer).\n\n> \\[!NOTE]\n> Se você estiver migrando entre GitHub produtos, verifique se você é proprietário da organização ou foi concedida a função de migrador para a organização de origem e a organização de destino.\n\n### O recurso é protegido pela aplicação do SAML da organização\n\nEsse erro indica que o personal access token fornecido ao GitHub CLI precisa ser autorizado para uso com a autenticação única SAML. Para obter mais informações, consulte [Como autorizar um token de acesso pessoal para uso com logon único](/pt/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/authorizing-a-personal-access-token-for-use-with-single-sign-on).\n\n### Resposta `401 Unauthorized`\n\nAs falhas que incluem um código de status `401` geralmente indicam que personal access token que você forneceu a GitHub CLI não tem os escopos necessários. Verifique os escopos nos personal access tokens fornecidos. Para obter mais informações sobre escopos necessários, consulte o artigo apropriado para seu caminho de migração.\n\n* [Gerenciar acesso](/pt/migrations/ado/manage-access)\n* [Gerenciar o acesso para uma migração do Bitbucket Server](/pt/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/managing-access-for-a-migration-from-bitbucket-server#required-scopes-for-personal-access-tokens)\n* [Gerenciando o acesso para uma migração entre produtos GitHub](/pt/migrations/using-github-enterprise-importer/migrating-between-github-products/managing-access-for-a-migration-between-github-products#required-scopes-for-personal-access-tokens)\n\n### Resposta `404 Not Found`\n\nAs falhas que incluem o código de status `404` geralmente indicam um erro de digitação em um dos comandos. Analise o log de migração para ver o comando exato inserido e verifique se há erros de digitação no nome do repositório de origem, da organização ou do projeto.\n\n### Resposta `Archive generation failed`\n\nSe você receber uma `Archive generation failed...` resposta ao migrar de GitHub Enterprise Server, seu repositório provavelmente será muito grande. Para obter mais informações sobre os limites de tamanho do repositório, confira [Sobre migrações entre produtos do GitHub com GitHub Enterprise Importer](/pt/migrations/using-github-enterprise-importer/migrating-between-github-products/about-migrations-between-github-products#data-that-is-migrated-from-github-enterprise-server).\n\nPrimeiro, tente excluir as liberações da migração usando a flag `--skip-releases` com o comando `migrate-repo`.\n\nSe isso não funcionar, recomendamos atualizar para GitHub Enterprise Server 3.8.0 ou posterior. Se não for possível atualizá-lo, outra opção será gerar os arquivos do repositório manualmente usando `ghe-migrator`:\n\n1. Gere um arquivo de migração para o repositório. Você só deve exportar um repositório por vez. Para obter instruções, consulte [Exportando dados de migração de sua empresa](/pt/enterprise-server@3.22/migrations/using-ghe-migrator/exporting-migration-data-from-github-enterprise-server) na GitHub Enterprise Server documentação.\n2. Carregue o arquivo de migração para o provedor de armazenamento de blobs escolhido.\n3. Gere uma URL de curta duração para o arquivo de migração que é acessível por GitHub, como uma URL pré-assinada do AWS S3 ou uma URL SAS do Armazenamento de Blobs do Azure.\n4. Chame o comando `migrate-repo` com os sinalizadores `--git-archive-url` e `--metadata-archive-url` definidos como a URL do arquivo da etapa anterior.\n\n### `cipher name is not supported` erro\n\nSe você estiver migrando do Bitbucket Server e receber um erro como `cipher name aes256-ctr for openssh key file is not supported` ao executar uma migração, sua chave privada SSH usará uma criptografia sem suporte. Para obter mais informações sobre as criptografias com suporte, confira [Gerenciar o acesso para uma migração do Bitbucket Server](/pt/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/managing-access-for-a-migration-from-bitbucket-server#required-permissions-for-bitbucket-server).\n\nPara gerar um novo par de chaves SSH compatível, execute o seguinte comando:\n\n```shell copy\nssh-keygen -t ed25519 -Z aes256-cbc -C \"your_email@example.com\"\n```\n\nAntes de poder usar a chave, depois de gerar um novo par de chaves SSH, você precisa adicionar a chave pública à instância do Bitbucket Server `authorized_keys`.\n\n### `Subsystem 'sftp' could not be executed` erro\n\nSe você estiver migrando do Bitbucket Server e receber um erro como `Subsystem 'sftp' could not be executed`, isso indicará que o SFTP não está habilitado no servidor ou a sua conta de usuário não tem acesso ao SFTP.\n\nEntre em contato com o administrador do servidor e peça para ele habilitar o acesso ao SFTP na sua conta de usuário.\n\n### `Source export archive... does not exist` erro\n\nSe você estiver migrando do Bitbucket Server e receber um erro como `Source export archive (/var/atlassian/application-data/bitbucket/shared/migration/export/Bitbucket_export_1.tar) does not exist`, o GitHub CLI está procurando seu arquivo de migração no lugar errado na instância do Bitbucket Server.\n\nPara resolve esse problema, defina o argumento `--bbs-shared-home` de `gh bbs2gh migrate-repo` como o diretório inicial compartilhado do Bitbucket Server ou do Data Center. O diretório base compartilhado padrão é `/var/atlassian/application-data/bitbucket/shared`, mas a configuração pode ser diferente.\n\nVocê pode identificar o diretório base compartilhado no Bitbucket Server.\n\n1. Navegue até a área Administração da instância do Bitbucket Server ou do Data Center.\n2. Na barra lateral, em \"Sistema\", clique em **Armazenamento**.\n3. Em \"Diretório compartilhado\", veja o local do diretório base compartilhado do servidor.\n\nSe você estiver executando o Bitbucket Data Center no modo de cluster com vários nós, o diretório compartilhado será compartilhado entre os nós do cluster e deverá ser montado no mesmo local em cada nó.\n\n### `Repository rule violations found` erro\n\nSe você receber um erro `Repository rule violations found`, como `GH013: Repository rule violations found for refs/heads/main`, isso indicará que os dados do repositório de origem entram em conflito com os conjuntos de regras configurados na organização de destino. Para obter mais informações, consulte [Sobre os conjuntos de regras](/pt/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets).\n\nVocê pode desabilitar temporariamente seus conjuntos de regras durante a migração ou usar o modo de bypass ou a lista de bypass para isentar a migração das regras configuradas. Para obter mais informações, consulte [Como gerenciar conjuntos de regras para repositórios na sua organização](/pt/enterprise-cloud@latest/organizations/managing-organization-settings/managing-rulesets-for-repositories-in-your-organization).\n\n### `Your push would publish a private email address` erro\n\nSe você receber um erro `Git source migration failed` com `GH007: Your push would publish a private email address`, a fonte do Git para a qual você está tentando migrar inclui confirmações feitas por um endereço de email que você bloqueou de ser enviado por push para GitHub. Para obter mais informações, consulte [Bloquear pushes de linha de comando que mostrem endereços de e-mail pessoais](/pt/account-and-profile/how-tos/email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address).\n\nPara resolve esse erro, você pode reescrever o histórico do Git para remover o endereço de email ou desabilitar a configuração \"Bloquear os pushes de linha de comando que expõem o email\".\n\n## Noções básicas sobre avisos de log de migração\n\nMesmo que a migração seja bem-sucedida, você ainda deve revisar o log de migração para verificar se há avisos.\n\nOs avisos no log de migração apontam para itens específicos dentro do repositório que não puderam ser migrados. Para obter mais informações, consulte [Como acessar os logs de migração do GitHub Enterprise Importer](/pt/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer).\n\n> \\[!NOTE]\n> Se o problema \"Migration Issue\" inclui \"Migration completed\" na parte inferior, isso indica que o repositório foi migrado. Avisos indicam apenas que itens específicos do repositório, como um comentário em uma solicitação de pull, podem não ter sido migrados corretamente.\n\n* [Aviso: “Metadados do repositório grandes demais para a migração”](#warning-repository-metadata-too-big-to-migrate)\n* [Aviso: \"Comentário não incluído na comparação\"](#warning-comment-not-in-diff)\n* [Aviso: \"Revisão da solicitação de pull... não pôde ser importado devido a um erro REVIEW\\_THREAD\\_MISSING\\_END\\_COMMIT\\_OID\"](#warning-pull-request-reviewcould-not-be-imported-due-to-review_thread_missing_end_commit_oid-error)\n* [As referências de equipe são desfeitas após uma migração da organização](#team-references-are-broken-after-an-organization-migration)\n\n### Aviso: “Metadados do repositório grandes demais para a migração”\n\nSe você vir \"Metadados do repositório grandes demais para migrar\" no \"Registro de Migração\" ou no GitHub CLI, isso significa que o tamanho do seu repositório excede o limite máximo de 10 GB para arquivo. Isso geralmente é causado por ativos de lançamento grandes. Tente excluir versões da migração com o sinalizador `--skip-releases` para o comando `migrate-repo`.\n\n### Aviso: \"Comentário não incluído na comparação\"\n\nSe você estiver migrando do Azure DevOps, os comentários de solicitação de pull em linhas que nunca foram alteradas na solicitação de pull não poderão ser migrados para GitHub. Você verá esse aviso para cada comentário que não pode ser migrado por esse motivo.\n\n> \\[!NOTE]\n> Somente os comentários nas linhas que não foram alteradas em um pull request são afetados por essa limitação. Os comentários nas linhas que foram alteradas em uma solicitação de pull são migrados.\n\nLembre-se de que os comentários afetados não estarão no repositório migrado, mas esses avisos não exigem outras ações da sua parte.\n\n### Aviso: \"Revisão da solicitação de pull... não pôde ser importado devido a um erro REVIEW\\_THREAD\\_MISSING\\_END\\_COMMIT\\_OID\"\n\nEsse aviso ocorre quando uma revisão de pull request não pôde ser migrada porque o commit ao qual a revisão está anexada não existe mais.\n\nIsso geralmente acontece quando as confirmações foram removidas com um push forçado ou uma ramificação foi excluída.\n\nNesse caso, os comentários não são perdidos, mas são migrados como comentários de solicitação de pull embutidos para preservar o histórico, em vez de como uma revisão anexada a uma confirmação específica.\n\n### A revisão de solicitação de pull é importada como um comentário de solicitação de pull em linha\n\nEsses avisos indicam que uma revisão de solicitação de pull não pôde ser migrada em sua forma original, mas como comentários de solicitações de pull embutidos.\n\n* `INVALID_REVIEW_THREAD`\n* `LINE_NOT_FOUND_IN_DIFF`\n* `REVIEW_THREAD_MISSING_BODY`\n\n### As referências de equipe são quebradas após a migração de uma organização.\n\nAs referências às equipes, como `@octo-org/octo-team`, **não** são atualizadas como parte de uma migração da organização. Isso pode causar problemas na organização de destino, como arquivos `CODEOWNERS` que não funcionam conforme o esperado.\n\nVocê pode atualizar essas referências após a migração ou preservar os nomes da sua equipe renomeando a organização de origem para que possa usar o nome original da organização de destino.\n\nPor exemplo, se a sua organização de origem for `@octo-org` e o arquivo `CODEOWNERS` incluir uma referência à equipe `@octo-org/octo-team`, você poderá renomear a organização de origem para `@octo-org-temp` antes da migração, permitindo que você use `@octo-org` como o nome da nova organização. Em seguida, a equipe migrada será chamada `@octo-org/octo-team`. O arquivo `CODEOWNERS` no repositório migrado funcionará conforme o esperado.\n\n## Repositórios bloqueados\n\nApós uma migração, você pode descobrir que seus repositórios de origem ou destino estão bloqueados, desabilitando o acesso ao código do repositório e a todos os seus recursos, como problemas e solicitações de pull. Para obter mais informações sobre os repositórios bloqueados, confira [Sobre repositórios bloqueados](/pt/migrations/overview/about-locked-repositories).\n\nO processo de desbloqueio de um repositório depende do GitHub produto em que o repositório é armazenado.\n\n* Se o repositório bloqueado estiver ativado GitHub Enterprise Server, um administrador do site poderá desbloquear o repositório usando o painel de administração do site. Para obter mais informações, consulte [Bloquear um repositório](/pt/enterprise-server@3.22/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/locking-a-repository) na GitHub Enterprise Server documentação.\n* Se o repositório bloqueado estiver em GitHub.com, você pode entrar em contato com nos por meio do portal  para desbloquear o repositório.\n\n> \\[!NOTE]\n> Se a migração falhou, nem todos os dados foram migrados. Se você optar por desbloquear e usar o repositório, haverá perda de dados. Excluir o repositório bloqueado e tentar novamente a migração talvez seja uma opção melhor.\n\n## Entrar em contato com Suporte do GitHub\n\nSe você ainda não conseguir resolver o problema depois de tentar as etapas de solução de problemas acima, poderá entrar em contato Suporte do GitHub por meio do [Portal de Suporte do GitHub](https://support.github.com)."}