Drupal Core-Aktualisierung über Drush

Diese Dokumentation ist veraltet. Helfen Sie mit, sie aktuell zu halten.

Bevor Sie beginnen

Es wird empfohlen, Composer zur Verwaltung der Drupal-Abhängigkeiten zu verwenden; lesen Sie „Composer mit Drupal verwenden“ für weitere Informationen. Drush 9 unterstützt das Aktualisieren von Drupal nicht mehr und überlässt diese Aufgabe Composer. Daher wird empfohlen, Composer zum Aktualisieren von Drupal zu verwenden. Wenn Sie jedoch lange Zeit Drush genutzt haben, können Sie weiterhin Drush 8 (8.14 oder neuer) zum Aktualisieren von Drupal 8 verwenden.

P.S.: Eine Übersicht über alle verfügbaren Aktualisierungsmöglichkeiten finden Sie in der Einführung zu dieser Anleitung.

Führen Sie stets eine Sicherung durch, wenn während des Updates ein fataler Fehler auftritt.

Drupal 8 Core aktualisieren

Schritte zur Aktualisierung des Drupal 8 Core mit Drush 8.x. Drush ist eine Kommandozeilenschnittstelle für Drupal.

1. Erstellen Sie ein Backup Ihrer Dateien und Datenbank. Mit Drush geben Sie folgenden Befehl ein und führen ihn aus:

drush archive-dump

Hinweise:

• Es ist wichtig, vor dem Update Backups anzulegen. So können Sie unerwartete Probleme während oder nach dem Update schnell rückgängig machen.
• Der Befehl „drush archive-dump“ erzeugt ein .tar.gz-Archiv der Dateien und der Datenbank. Dieser Drush-Befehl ist veraltet und soll in Drush entfernt werden. Er umfasst nur die Dateien im Verzeichnis /web.

 

2. Prüfen Sie auf verfügbare Updates:

drush pm-updatestatus

• Hinweis: Alias für den Befehl ups
• Hinweis: Dieser Befehl wird für Composer-basierte Installationen nicht empfohlen; nutzen Sie bitte composer show.

 

3. Wartungsmodus aktivieren:

drush state-set system.maintenance_mode 1

Hinweis: Alias für den Befehl sset

4. Cache leeren:

drush cache-rebuild

Hinweise:

• Alias für den Befehl cr
• Dieser Befehl leert die cache_*-Tabellen in der Drupal-Datenbank und baut den Site-Container neu auf.

 

5. Wählen Sie eine oder mehrere der folgenden Optionen für Updates aus. Welche Option(en) Sie wählen, hängt vom benötigten Update-Typ ab. pm-update (Alias: up) aktualisiert den Code und wendet ausstehende Datenbank-Updates an, ähnlich wie pm-updatecode + updatedb.

Option: Drupal 8 Core aktualisieren

drush pm-update drupal

Option: Drupal 8 Core auf die Entwicklungszweig-Version aktualisieren, nur für Tests und Patch-Erstellung (nicht für Produktion)

drush pm-update drupal-8.5.x-dev

Option: Ein einzelnes Modul aktualisieren

drush pm-update modul_name

Option: Nur Sicherheitsupdates anwenden

drush pm-update --security-only

 

6. Falls nötig, wenden Sie manuell vorgenommene Änderungen an Dateien wie .htaccess, composer.json oder robots.txt erneut an. Drush erledigt dies nicht automatisch.

7. Wenden Sie alle wichtigen Patches, die Sie vor dem Update verwendet haben, erneut an (vorausgesetzt, sie sind noch nicht in den Core eingearbeitet).

   1. Diese lassen sich leicht mit guten Commit-Meldungen finden.

% git log --oneline --reverse core

ee2bf8dd Issue #18: Updated Drupal core from 8.3.4 to 8.3.5.

267e3ad0 Issue #27: Applied patch from https://www.drupal.org/project/drupal/issues/2174633#comment-12291691.

718ecba5 Issue #9: Applied patch from https://www.drupal.org/project/drupal/issues/2906229#comment-12496488.

 

   2. Für jeden Patch, der seit dem letzten Core-Update angewendet wurde, nutzen Sie den Befehl git cherry-pick (oder lösen Konflikte manuell), in chronologischer Reihenfolge:

% git cherry-pick 267e3ad0

% git cherry-pick 718ecba5

 

8. Wenn Sie Composer zur Verwaltung von PHP-Bibliotheken verwenden (z. B. weil einige zusätzliche Module es benötigen), aktualisieren Sie das Verzeichnis /vendor mit folgendem Befehl:

composer update drupal/core --with-dependencies

9. Aktualisieren Sie die Datenbank, falls erforderliche Datenbank-Updates vorhanden sind:

drush updatedb

Hinweis: Alias für den Befehl updb

10. Stellen Sie sicher, dass Ihre Website in Ordnung ist:

• Prüfen Sie den Statusbericht in Drupal
• Testen Sie Ihre Website mit einem Browser, indem Sie wichtige Seiten besuchen

 

11. Wartungsmodus deaktivieren:

drush state-set system.maintenance_mode 0

12. Cache erneut leeren:

drush cache-rebuild

13. Fertig. Sie haben Drupal 8 erfolgreich mit Drush aktualisiert :)