Aktualisierung von Shopware ab Version 6.3

Diese Dokumentation beschreibt die notwendigen Schritte zur Aktualisierung einer Shopware-Installation (ab Version 6.3).

Die Befehle müssen in der angegebenen Reihenfolge ausgeführt werden, um eine erfolgreiche Aktualisierung sicherzustellen. Alle Befehle müssen in einer Unix-basierten Umgebung (z. B. Linux) ausgeführt werden. Es wird angenommen, dass der Webserver-Benutzer www-data verwendet wird.

1. Vorbereitung des Systemupdates

sudo -u www-data bin/console system:update:prepare

Dieser Befehl bereitet das Shopware-System auf das Update vor. Dabei werden unter anderem Systemprüfungen durchgeführt und Datenbankmigrationen für das bevorstehende Update vorbereitet.

• sudo -u www-data: Wechselt zum Benutzer www-data, der typischerweise für den Webserver (Apache, Nginx) verwendet wird.
• bin/console system:update:prepare: Führt den Konsolenbefehl aus, um das Update vorzubereiten.

2. Sichern der composer.json

sudo -u www-data cp composer.json composer.json.bak

Mit diesem Befehl wird eine Sicherung der aktuellen composer.json-Datei erstellt. Falls während der Aktualisierung ein Fehler auftritt, kann auf diese Sicherung zurückgegriffen werden.

• cp composer.json composer.json.bak: Kopiert die composer.json und benennt die Kopie in composer.json.bak um.

3. Anpassen der composer.json

sudo -u www-data vim composer.json

In diesem Schritt wird die composer.json manuell bearbeitet. Hierbei sollten die Versionsnummern der Abhängigkeiten (z. B. Shopware-Pakete) aktualisiert werden.

• vim composer.json: Öffnet die Datei composer.json im Texteditor vim. Es können auch andere Editoren wie nano verwendet werden.

4. Aktualisieren der Abhängigkeiten

sudo -u www-data composer update

Dieser Befehl aktualisiert die Abhängigkeiten gemäß der composer.json. Dabei werden auch die neuesten Versionen von Shopware und seinen Paketen heruntergeladen und installiert.

• composer update: Führt den Composer-Update-Prozess durch, basierend auf den in der composer.json definierten Paketen und deren Versionen.

5. Abschluss des Systemupdates

sudo -u www-data bin/console system:update:finish

Nachdem die neuen Versionen installiert wurden, schließt dieser Befehl das Systemupdate ab. Es werden letzte Änderungen durchgeführt, wie z. B. das Anwenden von Datenbankmigrationen und das Leeren von Caches.

• system:update:finish: Schließt den Update-Prozess ab und bringt das System in den aktuellen, aktualisierten Zustand.

6. Aktualisieren von Symfony-Recipes

sudo -u www-data composer recipes:update

Mit diesem Befehl werden die Symfony-Recipes auf den neuesten Stand gebracht. Recipes beinhalten Konfigurationen und Best Practices, die für das optimale Funktionieren von Paketen notwendig sind.

• composer recipes:update: Aktualisiert die Symfony-Recipes für die verwendeten Abhängigkeiten in der Shopware-Installation.

Hinweis:

• Backup vor dem Update: Vor jedem Update ist es empfehlenswert, ein vollständiges Backup der Datenbank und des Dateisystems zu erstellen.
• Wartungsmodus: Es ist ratsam, während des Updates den Wartungsmodus zu aktivieren, um sicherzustellen, dass Kunden während des Update-Prozesses keinen Zugriff auf den Shop haben.

Beispiel für einen Wartungsmodus:

sudo -u www-data bin/console maintenance:enable

Nach Abschluss des Updates:

sudo -u www-data bin/console maintenance:disable