Migratieondersteuning

De kernmodule Migrate Drupal in Drupal biedt API-ondersteuning voor migratie van Drupal naar Drupal, en Migrate Drupal UI biedt een eenvoudige gebruikersinterface om te upgraden vanaf oudere versies van Drupal.

Upgrades van Drupal 6 naar Drupal 8 en van Drupal 7 naar Drupal 8 zijn stabiel voor eentalige sites. Het upgradepad voor meertalige sites is nog niet afgerond. Zie de sectie Upgraden van meertalig Drupal 6 naar Drupal 8 voor een kort overzicht van meertalige upgrades van Drupal 6 naar Drupal 8 en de meta-issue van meertalige migraties voor een lijst van meertalige migratieproblemen. Er zijn verschillende manieren om de stabiliteit van de upgradepaden D6-D8 en D7-D8 te verbeteren.

Test de upgrade van je site grondig en rapporteer je bevindingen

Wanneer je je Drupal 6- of Drupal 7-site naar Drupal 8 upgrade, zorg er dan voor dat je grondig test en je resultaten verifieert. Het is goed mogelijk dat je iets vindt dat niet is bijgewerkt zoals je verwachtte. Als dat gebeurt:

• Kijk eerst of de bekende problemen bij het upgraden van Drupal 6 of 7 naar Drupal 8 het probleem al vermelden.
• Als jouw probleem niet in de lijst staat, zoek dan tussen de openstaande migratie-issues voor Drupal 6 - Drupal 8 of de migratie-issues voor Drupal 7 - Drupal 8.
• Als je geen bestaand issue vindt voor jouw probleem, maak dan een nieuw issue in de issuequeue van het kern migratiesysteem. Een nieuw migratiebugrapport is al een zeer waardevolle bijdrage en helpt de stabiliteit van migraties te verbeteren!

Nieuwe issues worden toegewezen aan de component “migratiesysteem”. Het is van groot belang dat je zoveel mogelijk en zo gedetailleerd mogelijke informatie geeft.

• Voorzie indien mogelijk screenshots van vóór (Drupal 6/7) en na (Drupal 8).
• Beschrijf het probleem zo specifiek mogelijk.
• Vermeld aanvullende informatie over je site die volgens jou relevant kan zijn.
• Voorbeeld van een goed bugrapport: https://www.drupal.org/node/2853872

      - Een korte beschrijving, screenshot en annotaties bij de screenshot werden in het originele bugrapport toegevoegd.
      - De samenvatting van het probleem werd later meerdere keren bijgewerkt naarmate er tijdens de analyse meer informatie werd gevonden.
      - Het bijwerken van de samenvatting van het probleem is een uiterst belangrijk onderdeel van het correctieproces. Soms kan het oplossen van migratiebugs erg complex zijn, en een actuele probleemomschrijving helpt migratie-onderhouders en andere bijdragers enorm!
      - Wees niet verlegen – probeer een zo gedetailleerd mogelijk bugrapport te schrijven!

Help bij het testen van patches

Als je wilt helpen bij het testen van migratiepatches, moet je een testomgeving instellen. Pas patches altijd toe op de laatste ontwikkelversie van Drupal 8.

• Zie Git patch handleiding voor ontwikkelaars voor informatie over het toepassen van patches met git.
• Zie de sectie “Patches” van de Getting Started handleiding voor meer algemene informatie over patches.

Help bij het vinden van de oorzaken van migratieproblemen

Als je wat meer ervaring hebt met Drupal en zijn datamodel, kun je waarschijnlijk helpen de kernoorzaken van migratiefouten te begrijpen. Omdat we over datamigratie spreken, is het belangrijkste om te begrijpen:

• Waar de brondata in Drupal 6/7 vandaan komen
• En waar deze naartoe moeten in Drupal 8

Enkele hulpmiddelen die je kunnen helpen om te begrijpen waar de data vandaan komen:

• Devel-module – een uitstekend hulpmiddel om brondata in Drupal 6/7 te controleren.
• phpMyAdmin of een andere databasebrowser om de databron in Drupal 6/7 te vinden.
• Als je een Drupal 6/7-formulier kunt identificeren waarin de data worden opgeslagen maar de databasegegevens niet kunt vinden, kun je altijd het API-pad volgen. Open het Drupal 6/7-formulier, kopieer en plak een veld, en zoek daarna via Google.

site:api.drupal.org <voer hier je zoekterm in>

Migratieconfiguraties kunnen in Drupal 8 als volgt worden bekeken:

• admin/config/development/configuration/single/export
• Kies “migratie” als “Configuratietype”
• Selecteer de migratie die je wilt controleren

Een paar woorden over geautomatiseerde migratietests

Alle bugfixes in Drupal 8 core moeten voorzien zijn van geautomatiseerde testdekking. Het is toegestaan om patches zonder tests in te dienen als je niet bekend bent met geautomatiseerd testen. Dit hoofdstuk is bedoeld voor gevorderde bijdragers die aan tests willen meewerken.

Migraties moeten getest worden zodat de testbot de migratie daadwerkelijk uitvoert. Bij het schrijven van tests voor je D6/D7 naar D8 kernmigraties worden database-fixtures gebruikt die in Drupal 8 core zijn inbegrepen:

• core/modules/migrate_drupal/tests/fixtures/drupal6.php
• core/modules/migrate_drupal/tests/fixtures/drupal7.php
• Meer informatie over het genereren van database-fixtures voor D8-migratietests

De daadwerkelijke tests worden meestal gedefinieerd in de kernmodule-tests, bijvoorbeeld in core/modules/comment/tests/src/Kernel/Migrate/d7.