Mise à jour via le navigateur web

Avant de commencer

Avant de commencer la mise à jour, assurez-vous d'avoir lu les pages précédentes de ce guide :

• Mise à jour de Drupal 6 ou 7 vers Drupal 8
• Préparation à la mise à jour
• Choix de la méthode de mise à jour

Assurez-vous d’utiliser la dernière version de Drupal 8. Vous pouvez vérifier votre version sur la page de rapport d’état de votre site Drupal 8 (/admin/reports/status). Les outils de migration sont en cours de développement, donc pour disposer des dernières mises à jour de migration, surveillez les mises à jour du cœur Drupal.

Assurez-vous que les modules principaux suivants sont activés sur votre site Drupal 8 :

• Migrate
• Migrate Drupal
• Migrate Drupal UI

Installez et activez les modules supplémentaires sur votre site Drupal 8, pour lesquels vous souhaitez migrer la configuration et le contenu depuis le site source.

Définir le site source

• Vous pouvez démarrer le processus de mise à jour en visitant le chemin /upgrade de votre site Drupal 8. Si vous obtenez une page « Page non trouvée », assurez-vous que le module « Migrate Drupal UI » est activé.
• Définissez les détails de connexion à la base de données pour votre site source Drupal 6/7. Si votre site source utilise un préfixe de base de données, n’oubliez pas de déplier les options avancées et de fournir ce préfixe.
• Indiquez les répertoires des fichiers publics et privés de votre site source afin que les fichiers puissent être copiés vers votre site Drupal 8.
• Voir la capture d’écran ci-dessous.

Examinez l’analyse avant mise à jour

Si les informations d’accès à la base source sont correctes, la page de revue de mise à jour apparaîtra, comme montré dans la capture d’écran ci-dessous. Cette page affiche un résumé de l’état de mise à jour pour tous les modules installés sur l’ancien site.

En tant que créateur du site, vous devez examiner attentivement les modules qui ne seront pas mis à jour. Pour chaque module, évaluez si votre site Drupal 8 peut fonctionner sans ce module. Utilisons quelques modules de la capture d’écran ci-dessus comme exemples.

• Address Field fournit un type de champ pour stocker des données d’adresse.

                             - Si vous poursuivez la mise à jour, les nœuds avec des adresses sur le site source seront migrés dans Drupal 8 sans adresses, ce qui donnera probablement un résultat insatisfaisant.
                             - Ce problème peut être résolu en installant et activant le module Address pour Drupal 8.
                             - En d’autres termes, vous ne lancerez pas la mise à jour réelle tout de suite, mais installerez d’abord le module Drupal 8 manquant, puis relancerez la mise à jour. Vous verrez alors le champ adresse inclus dans la liste des modules à migrer.

• Color - module cœur de Drupal 7 qui permet de modifier facilement le schéma de couleurs des thèmes compatibles.

                              - Il n’existe actuellement aucun chemin de mise à jour pour transférer la configuration du module Color de Drupal 7 vers Drupal 8.
                              - Toutefois, vous pouvez configurer manuellement la configuration du module sur votre site Drupal 8 après la mise à jour.
                              - Vous pouvez procéder en toute sécurité à la mise à jour en sachant que les paramètres du module Color de Drupal 7 ne seront pas migrés automatiquement.

• Views permet de créer différents types de listes de contenu pour votre site.

                              - Même si Views est activé dans Drupal 8 (maintenant dans le cœur), Views apparaîtra toujours comme « Non migré ». Cela est dû à l’absence de mécanisme de migration automatique qui transférerait vos configurations Views de Drupal 6/7 vers Drupal 8.
                              - La mise à jour est sécurisée, mais vous devrez recréer manuellement vos vues sur votre site Drupal 8 après la mise à jour.

La liste des modules à migrer est réduite par défaut. En l’ouvrant, vous pouvez voir ce qui sera finalement sur le nouveau site. Par exemple, cela montre que le module Block du site source a été divisé en deux modules dans Drupal 8. Il n’y a rien à faire à ce sujet, la liste est uniquement informative.

Avertissements de conflit d’ID

Comme expliqué dans la section « Préparation à la mise à jour », la mise à jour de Drupal 6 ou Drupal 7 vers Drupal 8 doit être réalisée de manière à ce que le site Drupal 8 soit entièrement vide. Par exemple, si vous créez manuellement un nœud sur le site Drupal 8 avant la mise à jour, et que le site source Drupal 6/7 contient un nœud avec le même identifiant, le système de migration écrasera ce nœud créé manuellement dans Drupal 8.

Si des identifiants en conflit sont détectés, un avertissement s’affichera, comme montré ci-dessous. Vous pouvez ignorer cet avertissement et risquer de perdre des données, ou bien l’arrêter et utiliser une autre méthode comme décrit dans la documentation sur les problèmes connus.

Effectuer la mise à jour

Le résumé de l’analyse avant mise à jour est la dernière page avant l’exécution réelle de la mise à jour, c’est donc la dernière chance d’annuler. Dès que vous cliquez sur « Effectuer la mise à jour », le processus démarre.

Selon la taille et les types de contenu / configuration sur le site source, la mise à jour peut prendre beaucoup de temps (peut-être des heures pour un grand volume de données). En raison du chiffrement des mots de passe, l’import des comptes utilisateurs est particulièrement long. Un retour continu est fourni tout au long du processus, avec des informations de progression et des erreurs :

Les nouveaux messages apparaissent en haut de la page, tandis que les anciens disparaissent en bas au fur et à mesure de l’avancement.

Consulter les journaux de migration

Tous ces messages affichés pendant la mise à jour peuvent être consultés ultérieurement. Après la fin du processus, vous arrivez sur la page d’accueil du site avec un résumé des messages :

Vous pouvez consulter les messages enregistrés et vérifier toutes les erreurs détectées. Le module utilise le système de journalisation intégré de Drupal, donc avec une configuration par défaut, vous pouvez simplement consulter les journaux stockés dans la base de données, accessibles via le lien :

Vous pouvez filtrer la liste des messages pour afficher les notifications (utilisées pour les retours positifs) ou les erreurs (utilisées pour signaler des problèmes détectés lors de la migration). Si quelque chose ne fonctionne pas, soit vous avez trouvé un bug (dans ce cas, consultez la file des problèmes ou demandez à l’équipe de migration), soit votre jeu de données est trop volumineux (dans ce cas, essayez de lancer la mise à jour via Drush).