Unterstützung der Migration

Das 8-Kern-Modul „Migrate Drupal“ in Drupal stellt eine API-Unterstützung für Migrationen von Drupal zu Drupal bereit, während „Migrate Drupal UI“ eine einfache Benutzeroberfläche für Upgrades von älteren Drupal-Versionen bietet.

Upgrades von Drupal 6 zu Drupal 8 und von Drupal 7 zu Drupal 8 sind für einsprachige Seiten stabil. Der Upgrade-Pfad für mehrsprachige Seiten ist noch nicht abgeschlossen. Siehe den Abschnitt Upgrade von mehrsprachigem Drupal 6 zu Drupal 8 für eine Übersicht zu mehrsprachigen Upgrades von Drupal 6 zu Drupal 8 und die Meta-Issue für mehrsprachige Migrationen für eine Liste der mehrsprachigen Migrationsprobleme. Es gibt mehrere Wege, um die Upgrade-Pfade D6-D8 und D7-D8 stabil zu halten.

Testen Sie Ihr Upgrade gründlich und berichten Sie Ihre Ergebnisse

Wenn Sie Ihre Drupal 6- oder Drupal 7-Seite auf Drupal 8 upgraden, testen und überprüfen Sie die Ergebnisse gründlich. Es ist gut möglich, dass Sie etwas finden, das nicht wie erwartet aktualisiert wurde. Wenn das passiert:

• Prüfen Sie zuerst, ob das Problem in den bekannten Problemen beim Upgrade von Drupal 6 oder 7 zu Drupal 8 dokumentiert ist.
• Wenn Ihr Problem nicht in der Liste steht, suchen Sie nach offenen Migrationsproblemen Drupal 6 - Drupal 8 oder Migrationsproblemen Drupal 7 - Drupal 8.
• Wenn Sie kein existierendes Issue zu Ihrem Problem finden, erstellen Sie bitte ein neues Issue im Core-Migrationssystem. Das Melden eines neuen Migrationsfehlers ist schon ein sehr wertvoller Beitrag und hilft, die Migration stabiler zu machen!

Neue Issues werden der Komponente „Migrationssystem“ zugeordnet. Es ist äußerst wichtig, so viele und so detaillierte Informationen wie möglich bereitzustellen.

• Bitte fügen Sie nach Möglichkeit Screenshots vor (aus Drupal 6/7) und nach (Drupal 8) dem Upgrade bei.
• Beschreiben Sie das Problem so konkret wie möglich.
• Geben Sie zusätzliche Informationen zu Ihrer Seite an, die relevant sein könnten.
• Ein gutes Beispiel für einen Issue-Report ist https://www.drupal.org/node/2853872

               - Die kurze Beschreibung, der Screenshot und die Beschriftungen unter dem Screenshot wurden im Original-Problembericht erstellt.
               - Die Zusammenfassung des Problems wurde später mehrfach aktualisiert, als während der Analyse immer mehr Informationen gefunden wurden.
               - Die Aktualisierung der Problemzusammenfassung ist ein extrem wichtiger Teil des Bugfix-Prozesses. Manchmal kann das Beheben von Fehlern sehr komplex sein, und eine aktuelle Zusammenfassung hilft den begleitenden Migranten und anderen Beteiligten sehr!
               - Scheuen Sie sich nicht, wir versuchen, so detailliert wie möglich zu schreiben!

Helfen Sie beim Testen von Patches

Wenn Sie beim Testen von Migrationsfixes helfen wollen, müssen Sie eine Testumgebung einrichten. Wenden Sie immer Patches auf die neueste Drupal-8-Dev-Version an.

• Informationen zur Verwendung von Git zum Anwenden von Patches finden Sie unter Git Patch Guide.
• Für allgemeinere Informationen zu Patches siehe den Abschnitt „Patches“ im Einstiegshandbuch.

Helfen Sie, die Ursachen von Migrationsproblemen zu finden

Wenn Sie mehr Erfahrung mit Drupal und seinem Datenmodell haben, können Sie wahrscheinlich helfen, die Kernursachen von Migrationsfehlern zu verstehen. Da es sich um Datenmigration handelt, ist es besonders wichtig zu verstehen,

• Woher die Quelldaten in Drupal 6/7 stammen
• Und wohin sie in Drupal 8 gehen sollen

Einige Werkzeuge, die Ihnen helfen, die Herkunft der Daten zu verstehen:

• Das Modul Devel ist ein ausgezeichnetes Werkzeug, um die Quelldaten in Drupal 6/7 zu inspizieren.
• phpMyAdmin oder andere Datenbankbrowser helfen Ihnen, die Datenquelle in Drupal 6/7 zu finden.
• Wenn Sie das Drupal-Formular kennen, in dem Daten gespeichert werden, aber die Datenbankdaten nicht finden können, können Sie immer den API-Quelltext durchsuchen. Öffnen Sie das Drupal-Formular in Drupal 6/7, kopieren Sie das Feld und suchen Sie danach in Google mit

site:api.drupal.org <Geben Sie hier Ihren Suchbegriff ein>

Migrationskonfigurationen können in Drupal 8 wie folgt eingesehen werden:

• admin/config/development/configuration/single/export
• Wählen Sie „Migration“ als „Konfigurationstyp“
• Wählen Sie die Migration, die Sie überprüfen möchten

Ein paar Worte zu automatisierten Migrationstests

Alle Core-Bugfixes im Zusammenhang mit Drupal-8-Migrationen sollten automatisierte Testabdeckung haben. Sie können Fixes auch ohne Tests einreichen, wenn Sie mit automatisierten Tests nicht vertraut sind. Dieses Kapitel richtet sich an fortgeschrittene Mitwirkende, die an Tests teilnehmen möchten.

Migrations müssen getestet werden, damit der Test-Bot die Migration tatsächlich durchführt. Beim Schreiben von Tests für Core-Migrationen von D6/D7 zu D8 werden Datenbank-Fixures verwendet, die im Drupal-8-Core enthalten sind:

• core/modules/migrate_drupal/tests/fixtures/drupal6.php
• core/modules/migrate_drupal/tests/fixtures/drupal7.php
• Mehr zu Migrations-Datenbank-Fixures

Die eigentlichen Tests sind meist in den Kernel-Tests des jeweiligen Moduls definiert, z. B. in core/modules/comment/tests/src/Kernel/Migrate/d7