Preparazione del sito per l’aggiornamento a Drupal 8

Prima di aggiornare un sito Drupal 6 o Drupal 7 a Drupal 8, è consigliabile intraprendere alcuni passaggi per assicurarsi che il processo sia fluido e porti ai risultati desiderati.

A differenza dei precedenti aggiornamenti principali del core di Drupal, il processo di aggiornamento a Drupal 8 non aggiorna il sito sorgente in loco. Invece, le entità di configurazione e contenuto vengono migrate dal sito sorgente a un nuovo sito Drupal 8 pulito. Consulta la pagina Aggiornare da Drupal 6 o 7 a Drupal 8 per una panoramica del processo e delle principali differenze.

Anche se l’aggiornamento non modifica il sito sorgente, si consiglia di non eseguirlo sul sito live. È preferibile utilizzare un backup del sito di produzione per garantire uno stato coerente del database (nessuna scrittura nel database durante la migrazione) ed evitare impatti sulle prestazioni del sito attivo.

Modulo di inventario del sito sorgente

È importante comprendere come è costruito il tuo sito Drupal 6 o 7 esistente prima di avviare l’aggiornamento a Drupal 8.

Individua i moduli core e contribuiti abilitati sul sito sorgente. Puoi visualizzare i moduli abilitati nella pagina di amministrazione dei moduli (“Amministrazione” > “Costruzione del sito” > “Moduli”) oppure utilizzare la pagina “Aggiornamenti disponibili” in admin/reports/updates.

Annota l’elenco completo dei moduli abilitati e usalo come checklist per pianificare l’aggiornamento. Per ciascun modulo poniti queste domande:

• Ho ancora bisogno di questo modulo in Drupal 8?
• Il modulo è stato incluso nel core di Drupal 8? Ad esempio, Views ora fa parte del core di Drupal 8.
• Esiste una versione del modulo per Drupal 8? Se no, mi serve ancora? Esistono alternative per ottenere la stessa funzionalità?
• Nota che i moduli di Drupal 6/7 non corrispondono sempre 1:1 ai moduli di Drupal 8. Ad esempio, il modulo Block in Drupal 6 e 7 è stato suddiviso nei moduli Block e Custom Block in Drupal 8.

L’interfaccia web di aggiornamento di Drupal 8 mostra quali moduli possono essere aggiornati automaticamente e quali no. Consulta la sezione Aggiornamento tramite browser web per maggiori dettagli. Puoi anche provare il modulo Upgrade Check, che usa un servizio esterno per stimare i tempi di aggiornamento.

Controlla la pagina dei problemi noti

Il percorso di aggiornamento da Drupal 6/7 a Drupal 8 è ancora sperimentale e alcuni moduli core potrebbero non avere un percorso di aggiornamento completo. È consigliato leggere la pagina Problemi noti durante la preparazione.

Aggiorna il tuo sito Drupal 6/7 alle ultime versioni di core e moduli contribuiti

Il processo di aggiornamento presume che tu aggiorni prima il tuo vecchio sito all’ultima versione minore. Ad esempio, se il sito usa Drupal core 6.35, dovrai aggiornarlo a 6.38.

Se intendi migrare automaticamente configurazioni o contenuti da moduli contribuiti, devi utilizzare le loro versioni più recenti.

Utilizza la pagina “Aggiornamenti disponibili” del tuo sito Drupal 6/7 (admin/reports/updates) per verificare se ci sono aggiornamenti.

Prerequisiti per l’aggiornamento da Drupal 6/7 a Drupal 8

• Una nuova installazione di Drupal 8 con i moduli core “Migrate” e “Migrate Drupal” abilitati. Se utilizzi l’interfaccia browser per l’aggiornamento, devi abilitare anche il modulo core “Migrate Drupal UI”.
• Per tutte le migrazioni delle traduzioni dal modulo i18n di Drupal 6 o 7, è richiesto che sul sito Drupal 8 sia installato il modulo multilingua “Migrate Drupal Multilingual (migrate_drupal_multilingual)”.
• Accesso al database Drupal 6 o 7 dall’host in cui risiede il nuovo sito Drupal 8.
• Accesso ai file del sito sorgente.

- Se sono utilizzati solo file pubblici, saranno accessibili tramite l’URL del sito.
- Se devono essere migrati file privati, la cartella dei file deve essere direttamente accessibile dal nuovo sito Drupal 8, e devi impostare il percorso file_private_path in settings.php prima di avviare l’aggiornamento.

• Se usi Drush per l’aggiornamento, ti serviranno Drush 8 o 9 e tre moduli aggiuntivi.

- Le istruzioni di installazione per Drush sono disponibili nella pagina indicata sopra.
- Installa Migrate Tools
- Installa Migrate Upgrade
- Installa Migrate Plus
- Per ulteriori informazioni su questi moduli, consulta la lista dei moduli di aggiornamento.
- IMPORTANTE: fai attenzione alla compatibilità tra le versioni dei moduli e la versione di core di Drupal 8 che stai utilizzando. Le pagine dei tre moduli sopra elencati specificano chiaramente quale versione utilizzare.

Abilitare i moduli core e contribuiti necessari in Drupal 8

Il processo di migrazione non installa automaticamente i moduli nel sito di destinazione Drupal 8. Verranno eseguite solo le migrazioni relative ai moduli installati sia sul sito sorgente che su quello di destinazione. Pertanto, devi abilitare in anticipo tutti i moduli core e contribuiti su Drupal 8 per i quali desideri migrare configurazioni e contenuti dal sito sorgente.

Alcuni esempi:

• Se hai abilitato il modulo Addressfield sul sito Drupal 7 sorgente e desideri migrare i dati degli indirizzi, devi abilitare il modulo Address sul sito Drupal 8 prima di avviare l’aggiornamento. Questo è un buon esempio di moduli che non corrispondono 1:1 tra Drupal 7 e 8. Tuttavia, il modulo Address di D8 fornisce i plugin di migrazione necessari per importare i dati dal campo Address di Drupal 7.
• Se il sito sorgente ha il modulo core Forum di Drupal 7 abilitato, devi abilitare il modulo core Forum sul sito Drupal 8 prima di avviare l’aggiornamento.

Non configurare il sito Drupal 8

Ricorda che il processo di aggiornamento sovrascriverà la configurazione nel sito Drupal 8, quindi non effettuare configurazioni sul sito Drupal 8 prima che l’aggiornamento sia completato. Ciò significa che non è necessario creare manualmente tipi di contenuto o campi prima dell’aggiornamento: il modulo Migrate li creerà durante il processo. In effetti, la pratica più comune è installare Drupal 8 utilizzando il profilo di installazione minimo, poiché il profilo standard imposta configurazioni che potresti non voler utilizzare. Questo differisce dal funzionamento di Migrate in Drupal 7 e versioni precedenti, dove era necessario preparare manualmente tipi di contenuto e campi.

Non creare contenuti nel sito Drupal 8

Il processo di aggiornamento mantiene gli ID univoci dal sito sorgente. Ad esempio, se un account utente aveva ID 2 nel sito sorgente (e quindi era raggiungibile a /user/2), dopo l’aggiornamento lo stesso account sarà a /user/2 nel sito Drupal 8. Se crei un nuovo utente in Drupal 8 (oltre all’admin predefinito), esso riceverà ID 2, e durante la migrazione l’utente con ID 2 del sito sorgente lo sovrascriverà. Questo vale per utenti, termini di tassonomia, nodi e quasi tutti i contenuti con ID numerici dal sito sorgente.

Per evitare perdite di dati, non creare manualmente alcun contenuto in Drupal 8 finché tutto il contenuto sorgente non è stato completamente importato.

Eseguire l’aggiornamento

Hai due opzioni per eseguire la migrazione:

• Utilizzando l’interfaccia browser. È l’approccio più semplice e può essere eseguito direttamente dall’interfaccia del sito Drupal 8, ma offre meno controllo sulla migrazione.
• Utilizzando Drush. È più affidabile e veloce, consente migrazioni selettive, ma richiede moduli aggiuntivi ed è eseguito da riga di comando.