Migratie Mythes: Waarom Drupal Sites Niet Gewoon Kopiëren

Na onze vorige avonturen met Drupal 11.2.2 updates, dachten we: "Laten we gewoon die oude sproets.nl site migreren naar de nieuwe server. Hoe moeilijk kan dat zijn?"

Spoiler alert: harder dan verwacht. Maar niet om de redenen die je zou denken.

De Mythe van de "Simpele" Migratie

In theorie is een Drupal migratie straightforward:

1. Database exporteren
2. Database importeren
3. Bestanden kopiëren
4. Cache legen

30 minuten werk, toch?

De Realiteit: Technische Schuld Komt Altijd Boven

Wat begon als een simpele migratie, werd een detective verhaal. Elke "fix" onthulde een nieuwe laag van problemen die zich jarenlang hadden opgehoopt:

• Database schema issues: De batch tabel miste een auto-increment primary key. Hoe lang was dat al zo?
• Taal configuratie chaos: Nederlands en Engels door elkaar, URL prefixes die nergens op sloegen
• Permission problemen: Gebruikersrollen zonder media rechten
• Pad alias conflicten: Duplicaten en inconsistente formaten

Dit waren geen migratie problemen. Dit was onderhoudsschuld die jarenlang was genegeerd.

AI als Debugging Partner

Het fascinerende aan deze sessie was de samenwerking met AI. Ik gaf high-level doelen aan ("migreer het menu", "fix de media library"), terwijl de AI de technische implementatie uitdacht. Het was alsof ik een zeer capabele maar iets te enthousiaste junior developer aan het werk had.

De AI wilde alles via SQL oplossen. Ik moest regelmatig bijsturen: "Nee, gebruik Drupal's entity API". Het resultaat was een interessante dans tussen strategische beslissingen en tactische implementatie.

Wat Wél Goed Ging

Niet alles was ellende. Sommige onderdelen waren verrassend smooth:

• Custom fonts: GAP fonts kopiëren en gin-custom.css aanmaken werkte perfect
• Content migratie: Eenmaal de rechten gefixed, werkten media references prima
• Views en menu's: Drupal's API deed gewoon wat het moest doen

Deze onderdelen werkten omdat ze proper geïmplementeerd waren in de eerste plaats.

De Echte Les

Drupal migraties zijn niet inherent moeilijk. Maar ze zijn meedogenloze detectoren van technische schuld. Elke shortcut die je ooit genomen hebt, elke "tijdelijke" fix, elke inconsistente configuratie - alles komt boven tijdens een migratie.

We waren niet echt aan het migreren. We waren aan het debuggen van jaren aan kleine configuratie problemen terwijl we probeerden te migreren.

Volgende Keer

Voor toekomstige migraties: investeer in een schone uitgangspositie. Fix schema problemen voor je migreert. Clean up configuratie inconsistenties voor je migreert. Test permissions voor je migreert.

Of accepteer dat je migratie eigenlijk een grote schoonmaakbeurt wordt. Beide zijn valide strategieën, zolang je maar weet waar je aan begint.

Nu, terug naar het eigenlijke probleem: die media library widget die nog steeds niet werkt...