Acceso a los registros de migración para GitHub Enterprise Importer

Después de ejecutar una migración, debes revisar el registro de migración para comprobar si hay datos que no se migraron según lo previsto.

En este artículo

Acerca de los registros de migración

Cada vez que ejecutes una migración con GitHub Enterprise Importer, se crea un registro de migración. Debes comprobar el registro de migración después de cada migración para revisar las advertencias de migración.

En el registro de migración se enumeran los pasos que se han completado como parte de la migración y se incluye información adicional.

  • Advertencias de migración, que representan datos (como problemas, solicitudes de cambios o comentarios) que no se migraron según lo esperado
  • Quién ha ejecutado la migración
  • El origen de la migración
  • Cuánto tiempo ha tardado la migración

Puedes acceder al registro de migración de una migración de repositorio de varias maneras.

  • En GitHub, puedes ver la incidencia "Registro de migración" en el repositorio migrado. Puedes usar esta incidencia para analizar las advertencias con el equipo y registrar las decisiones.
  • Mediante la descarga de un archivo de registro con la GitHub CLI.

Al ejecutar una migración de la organización, en GitHub Enterprise Importer se crea además un repositorio denominado gei-migration-results en la organización de destino. Este repositorio contiene información sobre la migración de datos de nivel de la organización y duplica la información de las incidencias del "Registro de migración" para cada repositorio migrado.

Para obtener más información sobre cómo interpretar advertencias en el registro de migración, consulta "Solución de problemas de la migración con GitHub Enterprise Importer".

Visualización de un registro de migración de repositorio en GitHub

Los usuarios con acceso de lectura a un repositorio pueden acceder al registro de migración del repositorio en GitHub.

  1. Navega al repositorio migrado en la organización de destino.

  2. Debajo del nombre del repositorio, haga clic en Problemas.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, una pestaña, con la etiqueta "Problemas", se destaca en naranja oscuro.

  3. Haz clic en la incidencia con el título "Registro de migración".

Descarga de un registro de migración de repositorio con la GitHub CLI

Los propietarios de la organización y sus miembros con el rol de migración pueden descargar registros de migración mediante la GitHub CLI.

Puedes descargar el registro de migración más reciente para un repositorio individual con el comando download-logs. El comando exacto depende del origen de la migración.

Los registros de migración están disponibles para descargarse durante 24 horas después de completar la migración.

Descarga de un registro de migración de repositorio con la ADO2GH extension

Si el origen de la migración es Azure DevOps, puedes descargar el registro de migración más reciente para un repositorio individual con el comando gh ado2gh download-logs. Reemplaza DESTINATION por la organización de destino, REPOSITORY por el nombre del repositorio y FILENAME por un nombre de archivo para el archivo descargado.

Shell
gh ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
  • Si todavía no has establecido una variable de entorno GH_PAT para una instancia de personal access token con acceso a la organización de destino, agrega --github-target-pat TOKENy reemplaza TOKEN por el valor personal access token. Para ver los requisitos de personal access token, consulta "Administración del acceso para una migración desde Azure DevOps".
  • Si vas a migrar a GHE.com, agrega --target-api-url TARGET-API-URL, donde TARGET-API-URL es la dirección URL de la API base para el subdominio de la empresa. Por ejemplo: https://api.octocorp.ghe.com.

Descarga de un registro de migración de repositorio con la BBS2GH extension

Si el origen de la migración es Bitbucket Server, puedes descargar el registro de migración más reciente para un repositorio individual con el comando gh bbs2gh download-logs. Reemplaza DESTINATION por la organización de destino, REPOSITORY por el nombre del repositorio y FILENAME por un nombre de archivo para el archivo descargado.

Shell
gh bbs2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
  • Si todavía no has establecido una variable de entorno GH_PAT para una instancia de personal access token con acceso a la organización de destino, agrega --github-target-pat TOKENy reemplaza TOKEN por el valor personal access token. Para ver los requisitos de personal access token, consulta "Administración del acceso para una migración desde Bitbucket Server".
  • Si vas a migrar a GHE.com, agrega --target-api-url TARGET-API-URL, donde TARGET-API-URL es la dirección URL de la API base para el subdominio de la empresa. Por ejemplo: https://api.octocorp.ghe.com.

Descarga de un registro de migración de repositorio con la GEI extension

Si el origen de la migración es un producto de GitHub, puedes descargar el registro de migración más reciente para un repositorio individual con el comando gh gei download-logs. Reemplaza DESTINATION por la organización de destino, REPOSITORY por el nombre del repositorio y FILENAME por un nombre de archivo para el archivo descargado.

Shell
gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
  • Si todavía no has establecido una variable de entorno GH_PAT para una instancia de personal access token con acceso a la organización de destino, agrega --github-target-pat TOKENy reemplaza TOKEN por el valor personal access token. Para ver los requisitos de personal access token, consulta "Administración del acceso para una migración entre productos de GitHub".
  • Si vas a migrar a GHE.com, agrega --target-api-url TARGET-API-URL, donde TARGET-API-URL es la dirección URL de la API base para el subdominio de la empresa. Por ejemplo: https://api.octocorp.ghe.com.

Descarga de todos los registros de migración de repositorio para un script de migración

Para asegurarte de que tienes acceso a los registros de migración de todos los repositorios migrados, puedes usar la marca --download-migration-logs al generar un script de migración para las migraciones de repositorio. Al usar esta marca, el script incluirá el comando download-logs para cada repositorio migrado. Para obtener más información, vea «Acerca de GitHub Enterprise Importer».

Nota: Solo puedes usar la marca --download-migration-logs con migraciones de repositorio, no con migraciones de la organización.

Acceso a un registro de migración de la organización

Los propietarios de la organización de destino pueden acceder al registro de migración de una migración de la organización en GitHub.

Para acceder al registro de migración de una migración de la organización, navega al repositorio denominado gei-migration-results en la organización de destino.

El archivo README.md de la raíz del repositorio incluye la información siguiente sobre la migración de la organización:

  • Cualquier advertencia o error relacionado con la migración de datos de nivel de la organización, como la configuración y los equipos
  • El número de repositorios que se han migrado correctamente y el número de los que no se han podido migrar

Los directorios /success y /failure contienen un archivo para cada repositorio que se ha migrado correctamente o que no se ha podido migrar, respectivamente. Estos archivos deben seguir la convención de nomenclatura REPO_NAME.md.

Nota: El repositorio gei-migration-results se crea al principio del proceso de migración, pero solo se actualiza con los registros de migración una vez que finaliza la migración.