Prerrequisitos
- Debe haber completado todas las fases anteriores de esta guía.
- Asegúrate de comprender los datos que se migrarán y las limitaciones de compatibilidad conocidas del importador. Para obtener más información, consulte Fase 1. Descripción de las migraciones de Azure DevOps a GitHub.
- Aunque no es necesario, se recomienda detener el trabajo durante la migración de producción. Importer no admite migraciones diferenciales, por lo que los cambios que se produzcan durante la migración no se migrarán. Si decides no detener el trabajo durante la migración de producción, tendrás que migrar manualmente estos cambios.
Generación de un script de migración
Si quieres migrar varios repositorios a GitHub Enterprise Cloud a la vez, usa la GitHub CLI para generar un script de migración. El script resultante contendrá una lista de comandos de migración, uno por cada repositorio.
Nota:
La generación de un script da como resultado un script de PowerShell. Si usas Terminal, tendrás que generar el script con la extensión de archivo .ps1 e instalar PowerShell para Mac o Linux para ejecutarlo.
Para generar un script de migración, ejecuta el comando gh ado2gh generate-script.
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME
gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME
Reemplaza los marcadores de posición del comando anterior por los valores siguientes.
| Marcador de posición | Value |
|---|---|
| SOURCE | Nombre de la organización de origen |
| DESTINATION | Nombre de la organización de destino |
| FILENAME | Nombre de archivo para el script de migración resultante Si usas Terminal, utiliza una extensión de archivo .ps1, ya que el script generado necesita que se ejecute PowerShell. Puedes instalar PowerShell para Mac o Linux. |
Argumentos adicionales
| Argument | Description |
|---|---|
--target-api-url TARGET-API-URL | 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. |
--all | Agregue funcionalidad adicional al script, como las canalizaciones de reintento, la creación de equipos y la configuración de integraciones Azure Boards. |
--download-migration-logs | Descargue el registro de migración para cada repositorio migrado. Para más información sobre los registros de migración, consulta Acceso a los registros de migración para GitHub Enterprise Importer. |
Revisión del script de migración
Después de generar el script, revisa el archivo y, opcionalmente, edita el script.
- Si hay repositorios que no quieras migrar, elimina o comenta las líneas correspondientes.
- Si quieres que los repositorios tengan otro nombre en la organización de destino, actualiza el valor de la marca
--target-repocorrespondiente. - Si desea cambiar la visibilidad de un nuevo repositorio, actualice el valor de la marca correspondiente
--target-repo-visibility. De manera predeterminada, el script establece la misma visibilidad que el repositorio de origen.
Realizar una prueba
Para ayudar a descubrir problemas que podrían ser únicos para su empresa, se recomienda encarecidamente realizar una ejecución de prueba de la migración. Con una ejecución de prueba, aprenderá lo siguiente:
- Si la migración de un repositorio determinado se puede completar correctamente.
- Si puede restaurar el repositorio migrado a un estado operativo.
- Cuánto tiempo tardará una migración en ejecutarse.
Las ejecuciones de prueba se pueden realizar en cualquier momento y no es necesario detener el trabajo durante la migración. A fin de reducir el tiempo necesario para completar las migraciones de prueba, puedes programar los lotes de las ejecuciones de prueba de manera consecutiva. Después, los usuarios de esos repositorios pueden validar los resultados por su cuenta.
-
Configura una organización organizativa de prueba para tus migraciones de prueba.
Puedes usar una sola organización para todas las ejecuciones de prueba, o bien puedes crear una organización de prueba para cada organización de destino prevista. Considera la posibilidad de incluir
-sandboxal final de los nombres de la organización, para aclarar que las organizaciones solo están pensadas para la validación de la migración y no para producción. Puedes eliminar las organizaciones de prueba cuando hayas terminado. -
Ejecuta las migraciones de prueba.
-
Confirme que puede completar las tareas de seguimiento en Fase 6. Tareas de seguimiento.
-
Pide a los usuarios que validen los resultados de las migraciones.
-
Resuelve las incidencias detectadas por las migraciones de prueba.
-
Opcionalmente, elimina la organización de prueba.
Migración de repositorios
Si la ejecución de prueba se realizó correctamente y pudo completar las tareas de seguimiento, puede continuar con la migración real.
Advertencia
Recomendamos detener cualquier trabajo en los repositorios que esté migrando. Los cambios realizados durante o después de la migración deberán migrarse manualmente.
Para migrar varios repositorios, ejecute el script que generó. Reemplaza FILENAME en los comandos siguientes por el nombre de archivo que has proporcionado al generar el script.
-
Si usas Terminal, utiliza
./.Shell ./FILENAME
./FILENAME -
Si usas PowerShell, utiliza
.\.Shell .\FILENAME
.\FILENAME
Pasos siguientes
En la fase siguiente y final, realizará tareas de seguimiento, comprobará los registros y preparará los repositorios para su uso. Consulta Fase 6. Tareas de seguimiento.