Recentment ha sortit publicada la data del final de suport a Drupal 7: 5/01/2025. Aquesta vegada sense més pròrrogues, de manera que ara sí o sí és el moment de passar els nostres drupals 7 a 10. Encara que el procés no és tan simple com voldríem, el canvi val la pena.
La migració de Drupal 7 a Drupal 10 implica un procés de diverses etapes. A Digrup les cataloguem en 4:
Verifica que el teu lloc de Drupal 7 estigui actualitzat a la darrera versió disponible de Drupal 7.
Verifica que els mòduls que utilitzes a Drupal 7 tinguin versions compatibles amb Drupal 10. Alguns mòduls poden haver estat reemplaçats o ja no ser necessaris a Drupal 10.
És possible que alguns mòduls utilitzats a Drupal 7 no existeixin a Drupal 10, per exemple el Field_collection en aquest cas estudiar les alternatives que ofereix drupal, en aquest cas serà migrat com a Paragraphs.
Pot ser útil aquest mòdul per comprovar l'estat de compatibilitat: https://www.drupal.org/project/upgrade_status
Actualitza tots els mòduls i temes del teu lloc Drupal 7 a les últimes versions estables disponibles.
Realitza una còpia de seguretat completa del teu lloc Drupal 7 existent (arxius i base de dades).
Instal·lar i configurar un lloc nou Drupal 10 seguint el procés d'instal·lació estàndard.
Instal·lar i activar els mòduls de migració que proporciona el core Migrate, Migrate drupal, Migrate drupal UI i alguns externs com el Migrate Plus, Migrate Tools, Migrate Upgrade, que ens facilitaran el treball en migrar el contingut.
Configura les connexions de base de dades al teu fitxer 'settings.php' perquè Drupal 10 pugui accedir a la base de dades de Drupal 7.
<?php
$databases['migrate']['default'] = [
'database' => 'db_name',
'driver' => 'mysql',
'host' => 'host',
'namespace' => 'Drupal\\Core\\Database\\Driver\\mysql',
'password' => 'db_pass',
'port' => 3306,
'prefix' => '',
'username' => 'db_user',
];
?>
Executa les migracions i verifica els resultats.
Per executar una actualització completa del vostre lloc Drupal heretat al lloc Drupal actual utilitza les ordres drush facilitades pel mòdul Migrate Upgrade:
$ drush migrate-upgrade --legacy-db-url=mysql://user:pass@12.34.56.78/d6db --legacy-root=http://myd7site.com
Afegint --configure-only només generarà els fitxers de migració sense importar-ne el contingut. Les ordres més utilitzades per drush són:
També podeu fer-ho per interfície normalment des de '/admin/structure/migrate'.
És possible que els fitxers dins del <default/files> no s'estiguin migrant bé, en aquest cas s'haurà de modificar l'arxiu **.yml **de migració corresponent. (migrate_plus.migration.upgrade_d7_file.yml) i tornar a importar aquest component
Exemple de l-arxiu .yml modificat:
...
langcode: ca
status: true
dependències: { }
id: upgrade_d7_file
class: Drupal\migrate\Plugin\Migration
field_plugin_method: null
cck_plugin_method: null
migration_tags:
- 'Drupal 7'
- Content
migration_group: migrate_drupal_7
label: 'Public files'
source:
plugin: d7_file
scheme: public
constants:
source_base_path: 'http://host/'
process:
fid:
-
plugin: get
source: fid
...
Un cop completada la migració, revisa i verifica el lloc migrat a Drupal 10. Assegureu-vos que tots els continguts, configuracions i funcionalitats s'hagin migrat correctament.
Soluciona qualsevol problema o error que trobis durant la migració. Podeu consultar els registres d'errors, la documentació i la comunitat de Drupal per obtenir ajuda en cas de dificultats.
Actualitza qualsevol mòdul o tema personalitzat que hagis fet servit al teu lloc de Drupal 7 perquè siguin compatibles amb Drupal 10.
És possible que hàgiu de refer Views ja que no solen migrar bé o directament algunes no es migren.
El sistema de 'templating' canvia respecte a Drupal 7, de les velles .tpl passaràs al sistema .twig, de manera que et tocarà refer el teu tema.
És possible que executis més d'una vegada el pas 3, però una primera migració reeixida et servirà per anar completant l'etapa final d'adaptació.
Recordeu que cada projecte de migració a Drupal pot ser únic, per això és important adaptar aquesta guia a les vostres necessitats específiques pel procés de migració i els seus resultats.
Toni Caballero
Toni Caballero
Quim Parnau