Apoyo a la migración

El módulo central de 8 núcleos «Migrate Drupal» en Drupal proporciona soporte API para la migración de Drupal a Drupal, y «Migrate Drupal UI» ofrece una interfaz de usuario sencilla para actualizar desde versiones anteriores de Drupal.

Las actualizaciones de Drupal 6 a Drupal 8 y de Drupal 7 a Drupal 8 son estables para sitios monolingües. La ruta de actualización para sitios multilingües aún no está completa. Consulte la sección Actualización multilingüe de Drupal 6 a Drupal 8 para información resumida sobre actualizaciones multilingües de Drupal 6 a Drupal 8 y la meta-incidencia sobre problemas multilingües de migración para la lista de problemas de migración multilingüe. Existen varias formas de asegurar la estabilidad de las rutas de actualización D6-D8 y D7-D8.

Pruebe exhaustivamente la actualización de su sitio y reporte sus hallazgos

Cuando actualice su sitio Drupal 6 o Drupal 7 a Drupal 8, asegúrese de probar exhaustivamente y revisar sus resultados. Es muy posible que encuentre algo que no se haya actualizado como esperaba. Cuando esto ocurra:

• Primero, revise si el problema está listado en Problemas conocidos al actualizar de Drupal 6 o 7 a Drupal 8.
• Si no encuentra su problema en la lista, busque incidencias abiertas de migración Drupal 6 - Drupal 8 o incidencias de migración Drupal 7 - Drupal 8.
• Si no encuentra una incidencia existente para el problema que enfrenta, por favor cree una nueva incidencia en la cola de problemas del sistema principal de migración. Reportar un nuevo error de migración ya es una contribución muy valiosa y ayuda a estabilizar la migración.

Cuando reporte nuevos problemas, estos serán asignados al componente “sistema de migración”. Es extremadamente importante que proporcione tanta información y detalle como sea posible.

• Por favor, incluya capturas de pantalla antes (de Drupal 6/7) y después (Drupal 8), donde sea aplicable.
• Describa el problema lo más específicamente posible.
• Mencione cualquier información adicional en su sitio que considere relevante para el problema.
• Un ejemplo de un buen reporte de problema: https://www.drupal.org/node/2853872

               - La descripción breve, la captura de pantalla y las anotaciones bajo la imagen fueron creadas en el reporte original.
               - El resumen del problema fue actualizado varias veces después, a medida que se encontró más información durante el análisis.
               - Actualizar el resumen del problema es una parte extremadamente importante del proceso de corrección. A veces, reproducir errores puede ser muy complejo, y mantener actualizados los resúmenes ayuda mucho a migradores y otros colaboradores.
               - No dude en hacerlo — intentaremos escribir reportes de error lo más detallados posible.

Ayude a probar parches

Si desea ayudar a probar correcciones de migración, debe configurar un entorno de prueba. Siempre aplique parches a la última versión dev de Drupal 8.

• Para información sobre cómo usar git para aplicar parches, consulte la guía para desarrolladores git patch.
• Para información general sobre parches, vea la sección “Parches” de la Guía de Inicio Rápido.

Ayude a encontrar las causas raíz de los problemas de migración

Si tiene un poco más de experiencia con Drupal y su modelo de datos, probablemente pueda ayudar a comprender las causas principales de errores de migración. Dado que hablamos de migración de datos, lo más importante es entender,

• De dónde provienen los datos en Drupal 6/7
• Y a dónde deben ir en Drupal 8

Algunas herramientas que le ayudarán a entender el origen de los datos:

• El módulo Devel es una excelente herramienta para inspeccionar los datos fuente en Drupal 6/7.
• phpMyAdmin u otro navegador de base de datos le ayudará a localizar la fuente de datos en Drupal 6/7.
• Si puede identificar el formulario de Drupal 6/7 donde se almacenan los datos, pero no puede encontrarlos en la base de datos, siempre puede seguir la pista leyendo la API. Abra el formulario Drupal 6/7 donde se almacenan los datos, copie y pegue el campo y búsquelo en Google con:

site:api.drupal.org <ingrese aquí lo que desea encontrar>

Las configuraciones de migración pueden leerse en Drupal 8 así:

• admin/config/development/configuration/single/export
• Seleccione “migración” como “Tipo de configuración”
• Seleccione la migración que desea inspeccionar

Unas palabras sobre pruebas automáticas de migración

Todos los errores corregidos relacionados con el núcleo de Drupal 8 deben contar con pruebas automáticas. Se pueden hacer correcciones sin pruebas si no está familiarizado con la automatización de pruebas. Este capítulo está destinado a colaboradores avanzados que deseen participar en las pruebas.

Las migraciones deben probarse para que el bot de pruebas realmente ejecute la migración. Al escribir pruebas para sus migraciones núcleo con D6/D7 a D8 como datos fuente, se usan fixtures de base de datos incluidos en el núcleo de Drupal 8:

• core/modules/migrate_drupal/tests/fixtures/drupal6.php
• core/modules/migrate_drupal/tests/fixtures/drupal7.php
• Más información sobre fixtures de base de datos para migraciones en D8

Las pruebas reales suelen definirse en las pruebas de núcleo del módulo correspondiente, por ejemplo, en core/modules/comment/tests/src/Kernel/Migrate/d7