{"meta":{"title":"Solución de problemas de la migración con GitHub Enterprise Importer","intro":"Si se produce un error en la migración o se producen resultados inesperados, puedes probar los pasos comunes de solución de problemas.","product":"Migraciones","breadcrumbs":[{"href":"/es/migrations","title":"Migraciones"},{"href":"/es/migrations/troubleshooting","title":"Solución de problemas de migraciones"},{"href":"/es/migrations/troubleshooting/troubleshooting-your-migration-with-github-enterprise-importer","title":"Solución de problemas de migraciones"}],"documentType":"article"},"body":"# Solución de problemas de la migración con GitHub Enterprise Importer\n\nSi se produce un error en la migración o se producen resultados inesperados, puedes probar los pasos comunes de solución de problemas.\n\n## Acerca de los pasos de solución de problemas para GitHub Enterprise Importer\n\nSi se produce un error en la migración o genera resultados inesperados, prueba los primeros pasos de solución de problemas siguientes, que normalmente resuelven una variedad de incidencias. Si estos primeros pasos no resuelven la incidencia, comprueba si hay mensajes de error en los registros de la migración. Después, busca el mensaje de error en este artículo y prueba los pasos para la resolución.\n\nSi no puede resolver el problema después de probar los pasos de solución de problemas del mensaje de error, puede ponerse en contacto con Soporte de GitHub.\n\n## Primeros pasos de solución de problemas\n\nAntes de investigar más, prueba estos pasos de solución de problemas que suelen resolver una variedad de incidencias.\n\n1. Compruebe que usa la versión más reciente de la GitHub CLI extensión que usa para migrar. En caso contrario, actualiza a la versión más reciente.\n\n2. Comprueba que cumples todos los requisitos de acceso. Para obtener más información, consulte el artículo correspondiente para la ruta de migración.\n\n   * [Administración del acceso](/es/migrations/ado/manage-access)\n   * [Administración del acceso para una migración desde Bitbucket Server](/es/migrations/using-github-enterprise-importer/migrating-from-bitbucket-server-to-github-enterprise-cloud/managing-access-for-a-migration-from-bitbucket-server)\n   * [Administración del acceso para una migración entre productos de GitHub](/es/migrations/using-github-enterprise-importer/migrating-between-github-products/managing-access-for-a-migration-between-github-products)\n\n3. Intenta volver a ejecutar la migración. Algunas incidencias de migración son transitorias y un segundo intento puede funcionar.\n\n4. Prueba a ejecutar una migración en otro repositorio con datos similares. Esto ayudará a determinar si la incidencia es única para el repositorio o si representa un problema de forma de datos más amplio.\n\nSi estos pasos no resuelven la incidencia, revisa los mensajes de error en los registros de migración. El registro que necesitas comprobar dependerá de si se ha producido un error en la migración o si se ha realizado correctamente.\n\n## Solución de problemas de migraciones con errores\n\nSi se produce un error en la migración, revise las entradas de registro detalladas generadas por GitHub CLI para cada migración. El archivo de registro se guarda en el mismo directorio donde has ejecutado la migración.\n\nEl log contiene un registro de cada comando que ejecutó y todas las solicitudes de API realizadas por el GitHub CLI en respuesta. Normalmente, los errores y los mensajes de error aparecen al final del registro.\n\n* [No se puede ejecutar la migración](#unable-to-run-migrations)\n* [El recurso está protegido por la aplicación de políticas SAML de la organización](#resource-is-protected-by-organization-saml-enforcement)\n* [Respuesta `401 Unauthorized`](#401-unauthorized-response)\n* [Respuesta `404 Not Found`](#404-not-found-response)\n* [Respuesta `Archive generation failed`](#archive-generation-failed-response)\n* [\n  `cipher name is not supported` error](#cipher-name-is-not-supported-error)\n* [\n  `Subsystem 'sftp' could not be executed` error](#subsystem-sftp-could-not-be-executed-error)\n* [\n  `Source export archive... does not exist` error](#source-export-archive-does-not-exist-error)\n* [\n  `Repository rule violations found` error](#repository-rule-violations-found-error)\n* [\n  `Your push would publish a private email address` error](#your-push-would-publish-a-private-email-address-error)\n\n### No se pueden ejecutar migraciones\n\nSi ves un error como `No access to createMigrationMutation` o `Missing permissions`, la cuenta personal no tiene el acceso necesario para ejecutar la migración. Asegúrate de que eres propietario de la organización o que se te ha concedido el rol de migrador. Para obtener más información sobre cómo conceder el rol de migrador, consulte [Acerca de GitHub Enterprise Importer](/es/migrations/using-github-enterprise-importer/understanding-github-enterprise-importer/about-github-enterprise-importer).\n\n> \\[!NOTE]\n> Si migra entre GitHub productos, asegúrese de que es propietario de la organización o se le ha concedido el rol de migrador tanto para la organización de origen como para la de destino.\n\n### El recurso está protegido por la aplicación de SAML de la organización\n\nEste error indica que el personal access token que proporcionaste al GitHub CLI necesita ser autorizado para su uso con el inicio de sesión único de SAML. Para obtener más información, vea [Autorización de un token de acceso personal para su uso con el inicio de sesión único](/es/enterprise-cloud@latest/authentication/authenticating-with-single-sign-on/authorizing-a-personal-access-token-for-use-with-single-sign-on).\n\n### Respuesta `401 Unauthorized`\n\nLos fallos que incluyen un `401` código de estado suelen indicar que el personal access token que proporcionaste GitHub CLI no tiene los telescopios requeridos. Verifica los telescopios en los personal access tokens que has proporcionado. Para obtener más información sobre los ámbitos necesarios, consulte el artículo correspondiente para la ruta de migración.\n\n* [Administración del acceso](/es/migrations/ado/manage-access)\n* [Administración del acceso para una migración desde Bitbucket Server](/es/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* [Administración del acceso para una migración entre productos de GitHub](/es/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### Respuesta `404 Not Found`\n\nLos errores que incluyen un código de estado `404` suelen indicar un error tipográfico en uno de los comandos. Revisa el registro de migración para ver el comando exacto que has escrito y comprueba si hay errores tipográficos en el repositorio de origen, la organización o el proyecto.\n\n### Respuesta `Archive generation failed`\n\nSi recibe una `Archive generation failed...` respuesta al migrar desde GitHub Enterprise Server, es probable que el repositorio sea demasiado grande. Para más información sobre los límites de tamaño de un repositorio, consulta [Acerca de las migraciones entre productos de GitHub con GitHub Enterprise Importer](/es/migrations/using-github-enterprise-importer/migrating-between-github-products/about-migrations-between-github-products#data-that-is-migrated-from-github-enterprise-server).\n\nEn primer lugar, intenta excluir versiones de la migración mediante la marca `--skip-releases` con el comando `migrate-repo`.\n\nSi eso no funciona, se recomienda actualizar a GitHub Enterprise Server la versión 3.8.0 o posterior. Si no puedes realizar la actualización, otra opción consiste en generar manualmente los archivos del repositorio mediante `ghe-migrator`:\n\n1. Genera un archivo de migración para el repositorio. Solo debes exportar un repositorio a la vez. Para obtener instrucciones, consulte [Exportación de datos de migración desde su empresa](/es/enterprise-server@3.22/migrations/using-ghe-migrator/exporting-migration-data-from-github-enterprise-server) en la GitHub Enterprise Server documentación.\n2. Carga el archivo de migración en el proveedor de almacenamiento de blobs que prefieras.\n3. Genere una URL de corta duración para el archivo de migración que sea accesible para GitHub, como una URL prefirmada de AWS S3 o una URL SAS de Azure Blob Storage.\n4. Llama al comando `migrate-repo` con las marcas `--git-archive-url` y `--metadata-archive-url` establecidas en la URL del archivo del paso anterior.\n\n### Error `cipher name is not supported`\n\nSi vas a realizar la migración desde Bitbucket Server y se produce un error como `cipher name aes256-ctr for openssh key file is not supported` al ejecutarla, la clave privada SSH usa un cifrado no compatible. Para más información sobre los cifrados admitidos, consulta [Administración del acceso para una migración desde Bitbucket Server](/es/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 generar una nueva clave SSH compatible, ejecuta el comando siguiente:\n\n```shell copy\nssh-keygen -t ed25519 -Z aes256-cbc -C \"your_email@example.com\"\n```\n\nDespués de generar una nueva clave SSH, para poder usarla, debes agregar la clave pública a `authorized_keys` en la instancia de Bitbucket Server.\n\n### Error `Subsystem 'sftp' could not be executed`\n\nSi vas a migrar desde Bitbucket Server y recibes un error como `Subsystem 'sftp' could not be executed`, SFTP no está habilitado en el servidor o la cuenta de usuario no tiene acceso SFTP.\n\nDebes ponerte en contacto con el administrador del servidor y pedirle que habilite el acceso SFTP para tu cuenta de usuario.\n\n### Error `Source export archive... does not exist`\n\nSi va a migrar desde Bitbucket Server y recibe un error como `Source export archive (/var/atlassian/application-data/bitbucket/shared/migration/export/Bitbucket_export_1.tar) does not exist`, el GitHub CLI está buscando el archivo de migración en el lugar incorrecto en su instancia de Bitbucket Server.\n\nPara resolver este problema, establece el argumento `--bbs-shared-home` para `gh bbs2gh migrate-repo` en el directorio principal compartido de Bitbucket Server o del Centro de datos. El directorio principal compartido predeterminado es `/var/atlassian/application-data/bitbucket/shared`, pero tu configuración puede ser diferente.\n\nPuedes identificar el directorio principal compartido en Bitbucket Server.\n\n1. Desplázate al área de Administración de la instancia de Bitbucket Server o del Centro de Datos.\n2. En la barra lateral, en \"Sistema\", haz clic en **Almacenamiento**.\n3. En \"Directorio compartido\", consulta la ubicación del directorio principal compartido del servidor.\n\nSi ejecutas Bitbucket Data Center en modo de clúster con varias notas, el directorio compartido se compartirá entre los nodos del clúster y se debe montar en la misma ubicación de cada nodo.\n\n### Error `Repository rule violations found`\n\nSi recibes un error `Repository rule violations found`, como `GH013: Repository rule violations found for refs/heads/main`, los datos del repositorio de origen entran en conflicto con los conjuntos de reglas configurados en la organización de destino. Para obtener más información, vea [Acerca de los conjuntos de reglas](/es/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets).\n\nPuedes deshabilitar temporalmente los conjuntos de reglas durante la migración, o puedes usar el modo de omisión o la lista de omisión para excluir la migración de las reglas configuradas. Para obtener más información, vea [Administración de conjuntos de reglas para repositorios en su organización](/es/enterprise-cloud@latest/organizations/managing-organization-settings/managing-rulesets-for-repositories-in-your-organization).\n\n### Error `Your push would publish a private email address`\n\nSi recibes un `Git source migration failed` error con `GH007: Your push would publish a private email address`, el código fuente de Git que intentas migrar incluye commits creados por una dirección de correo electrónico que has bloqueado para que no se envíen a GitHub. Para obtener más información, consulte [Bloquear las inserciones de la línea de comando que muestran tu dirección de correo electrónico personal](/es/account-and-profile/how-tos/email-preferences/blocking-command-line-pushes-that-expose-your-personal-email-address).\n\nPara resolver este error, puedes volver a escribir el historial de Git para quitar la dirección de correo electrónico o deshabilitar la configuración \"Bloquear inserciones de la línea de comandos que exponen mi correo electrónico\".\n\n## Entender advertencias del registro de migración\n\nIncluso si la migración se realiza correctamente, debe revisar el registro de migración para comprobar si hay advertencias.\n\nAdvertencias en el registro de migración señalan elementos específicos dentro del repositorio que no se pudieron migrar. Para obtener más información, vea [Acceso a los registros de migración para GitHub Enterprise Importer](/es/migrations/using-github-enterprise-importer/completing-your-migration-with-github-enterprise-importer/accessing-your-migration-logs-for-github-enterprise-importer).\n\n> \\[!NOTE]\n> Si la propuesta \"Migration Log\" incluye \"Migration completed\" en la parte inferior, significa que el repositorio se ha migrado. Las advertencias solo indican que es posible que elementos específicos del repositorio, como un comentario en una solicitud de cambios, no se hayan migrado correctamente.\n\n* [Advertencia: \"Metadatos de repositorio demasiado grandes para la migración\"](#warning-repository-metadata-too-big-to-migrate)\n* [Advertencia: \"Comentario no en diferencias\"](#warning-comment-not-in-diff)\n* [Advertencia: \"Revisión de solicitud de cambios... no se pudo importar debido a un error REVIEW\\_THREAD\\_MISSING\\_END\\_COMMIT\\_OID\"](#warning-pull-request-reviewcould-not-be-imported-due-to-review_thread_missing_end_commit_oid-error)\n* [Las referencias de grupo se rompen tras una migración en la organización](#team-references-are-broken-after-an-organization-migration)\n\n### Advertencia: \"Metadatos de repositorio demasiado grandes para la migración\"\n\nSi ve \"Metadatos de repositorio demasiado grandes para migrar\" en el problema del \"Registro de migración\" o en el GitHub CLI, su repositorio supera el tamaño máximo de almacenamiento de 10 GB. Esto se suele deber a activos de lanzamiento de gran tamaño. Intenta excluir las versiones de la migración con la marca `--skip-releases` del comando `migrate-repo`.\n\n### Advertencia: \"Comentario no en diferencias\"\n\nSi estás migrando desde Azure DevOps, los comentarios de pull request en líneas que nunca se cambiaron en la solicitud pull no pueden migrarse a GitHub. Verás esta advertencia para cada comentario que no se pueda migrar por este motivo.\n\n> \\[!NOTE]\n> Esta limitación solo afecta a los comentarios de las líneas que no se han cambiado en una solicitud de incorporación de cambios. Los comentarios de las líneas que se han cambiado en una solicitud de incorporación de cambios se migran.\n\nDebes tener en cuenta que los comentarios afectados no estarán en el repositorio migrado, pero estas advertencias no necesitan ninguna otra acción por tu parte.\n\n### Advertencia: \"Revisión de solicitud de cambios... no se pudo importar debido a un error REVIEW\\_THREAD\\_MISSING\\_END\\_COMMIT\\_OID\"\n\nEsta advertencia se produce cuando no se pudo migrar una revisión de la solicitud de cambios porque la confirmación a la que la revisión está adjunta ya no existe.\n\nEsto suele ocurrir cuando se han quitado confirmaciones con un envío de cambios forzado o se ha eliminado una rama.\n\nEn este caso, los comentarios no se pierden, pero se migran como comentarios de solicitud de cambios insertados para conservar el historial, en lugar de como una revisión adjunta a una confirmación específica.\n\n### La revisión de pull request se importa como un comentario en línea de pull request\n\nEstas advertencias indican que una revisión de pull request no pudo migrarse en su forma original, sino como comentarios de pull request en línea:\n\n* `INVALID_REVIEW_THREAD`\n* `LINE_NOT_FOUND_IN_DIFF`\n* `REVIEW_THREAD_MISSING_BODY`\n\n### Las referencias de equipos se rompen tras una migración de organización\n\nLas referencias a equipos, como `@octo-org/octo-team`, **no** se actualizan como parte de una migración de la organización. Esto podría causar problemas en la organización de destino, como que los archivos `CODEOWNERS` no funcionen según lo previsto.\n\nPuedes actualizar estas referencias después de la migración, o bien puedes conservar los nombres del equipo si cambias el nombre de la organización de origen para que puedas usar el nombre original de la organización de destino.\n\nPor ejemplo, si la organización de origen es `@octo-org` y el archivo `CODEOWNERS` incluye una referencia al equipo `@octo-org/octo-team`, podrías cambiar el nombre de la organización de origen a `@octo-org-temp` antes de la migración, lo que te permite usar `@octo-org` como nombre de la nueva organización. Después, el equipo migrado se llamaría `@octo-org/octo-team` y el archivo `CODEOWNERS` del repositorio migrado funcionará según lo previsto.\n\n## Repositorios bloqueados\n\nDespués de una migración, es posible que encuentres que los repositorios de origen o de destino están bloqueados, deshabilitando el acceso al código del repositorio y a todos sus recursos, como incidencias y solicitudes de incorporación de cambios. Para más información sobre los repositorios bloqueados, consulta [Acerca de los repositorios bloqueados](/es/migrations/overview/about-locked-repositories).\n\nEl proceso para desbloquear un repositorio depende del GitHub producto donde se almacena el repositorio.\n\n* Si el repositorio bloqueado está en GitHub Enterprise Server, un administrador de sitio puede desbloquear el repositorio mediante el panel de administración del sitio. Para obtener más información, consulte [Bloqueo de un repositorio](/es/enterprise-server@3.22/admin/managing-accounts-and-repositories/managing-repositories-in-your-enterprise/locking-a-repository) en la GitHub Enterprise Server documentación.\n* Si el repositorio bloqueado está en GitHub.com, puede ponerse en contacto con nosotros a través del portal  para desbloquear el repositorio.\n\n> \\[!NOTE]\n> Si se ha producido un error en la migración, no todos los datos se han migrado. Si decides desbloquear y usar el repositorio, habrá pérdida de datos. Eliminar el repositorio bloqueado y volver a intentar la migración puede ser una mejor opción.\n\n## Contactar con Soporte de GitHub\n\nSi sigue sin poder resolver el problema después de probar los pasos de solución de problemas anteriores, puede ponerse en contacto con Soporte de GitHub a través de [Portal de soporte de GitHub](https://support.github.com)."}