Wie migriere ich brandbox?

Ablauf einer Migration

Vorbereitung der Datenmigration

  • Composer.json und Entities anpassen

  • Patches löschen oder ausschalten (“enable-patching: false” in composer.json)

  • Images in docker.compose.yml anpassen (Cron auskommentieren)

  • Pim Tabellen löschen temp\plugin löschen

  • php composer.phar update ausführen

Best Practices

  • Für jede Version einen eigenen Branch anlegen

  • Gegebenenfalls für jede Version ein eigenes System aufsetzen

Datenmigration

  • Personenbezogene Daten löschen oder Anonymisieren, falls nötig

  • Datenbank einspielen

  • CryptoKey prüfen

  • Domain ändern

  • Log öffnen

  • Brandbox Install ausführen

Nach der Datenmigration

  • Spoolen der E-Mails aktivieren und SMTP einrichten

  • Styleguide neu generieren (Domain → Theme erzeugen)

  • Navigationen neu generieren

Code Migration

Mit der eigentlichen Code Migration kann begonnen werden, sobald man seine Zielversion erreicht hat.

  • Mit “Inspect Code” die offensichtliche Fehler beheben.

  • Deprecations auflösen, mithilfe der Migrationshinweise oder Deprecation Notices im Code

  • Eventuell Code refaktorisieren, falls praktikabel (ODM zu Extend, PIM Tabellen zu echten Tabellen usw.)

  • Die Features testen und gegebenenfalls korrigieren

Best Practices

  • PHPStorm auf die jeweilige PHP Version stellen

  • Die Json Schema Mappings mit den Schema Dateien aus framework\resources konfigurieren (PHPStorm → Settings → Languages & Frameworks → Schemas and DTDs → JSON Schema Mappings)