Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Automatische Updates mit ezupdate

Was die Erweiterung ezupdate für einen Hoster tut (Prüfung auf Updates, Probeläufe, abgesicherte Composer-Updates und Installationen aus der Administration oder einer Shell), die Schalter, die sie sicher halten, und wie…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/hosting/operations/automated-updates-with-ezupdate.md

On this page

This page is a translation. Read the English original

Automatische Updates mit ezupdate

Diese Seite ist für Systemadministratoren, die viele Exponential-Installationen aktuell halten, und für Produktmanager, die entscheiden, ob Kunden ihre eigenen Websites aktualisieren dürfen. Sie beantwortet: was ezupdate tut, mit welchen Schaltern es ausgeliefert wird, wie ein Update abläuft, welche Teile sich sicher automatisieren lassen und was ein bewusster Schritt bleiben muss.

ezupdate ist der Paketmanager einer Exponential-Installation, in der Administration (Setup > Updates and packages, /update/dashboard) und auf der Kommandozeile. Der Überblick ist ezupdate: Updates und Pakete in der Administration; die eigenen Anleitungen der Erweiterung (Benutzerhandbuch, Konfiguration, Kommandozeile, Sicherheit) liegen in ihrem Ordner doc/.

Inhalt

  1. Was es tut
  2. Es installieren
  3. Schalter und Berechtigungen
  4. Wie ein Update abläuft
  5. Was Sie automatisieren, und was nicht
  6. Einstellungen, die einen Hoster betreffen
  7. Checkliste

Was es tut

FunktionWas sie einem Hoster gibt
Übersichtwo Composer liegt und welches PHP es ausführt, ob Aktualisieren und Installieren erlaubt sind, Check for updates (composer outdated, ändert nichts), ein Probelauf eines Updates, ein abgesichertes Update, die letzten Ausführungen
Installed packagescomposer.json, composer.lock, vendor/composer/installed.json und die Erweiterungsverzeichnisse nebeneinander, mit den aktiven Erweiterungen; nennt, was nicht übereinstimmt; Downloads als JSON und CSV
Pakete findenpackagist.org oder die Server in composer.json durchsuchen, zuerst mit einem Probelauf installieren
Laufende AusführungenUpdates und Installationen laufen im Hintergrund, eine nach der anderen, mit einer Sperre; die Seite folgt der Ausgabe von Composer
Kommandozeiledasselbe aus php extension/ezupdate/bin/php/ezupdate.php
Updates and packages: eine Übersicht über die installierten Pakete, die mit einem neueren Release und die Paketserver
Updates and packages: eine Übersicht über die installierten Pakete, die mit einem neueren Release und die Paketserver

Hinweis „Automatisch“ heißt hier: die Prüfungen, die Probeläufe und die Berichte. ezupdate hat keinen eigenen Zeitplan, der eine Website unbeaufsichtigt aktualisiert, und die mitgelieferten Schalter halten Aktualisieren und Installieren aus, bis ein Administrator sie einschaltet.

Es installieren

Die composer.json im Wurzelverzeichnis von Exponential verlangt se7enxweb/ezupdate. Auf einer Installation, die es noch nicht hat:

composer require se7enxweb/ezupdate
# settings/override/site.ini.append.php:
#   [ExtensionSettings]
#   ActiveExtensions[]=ezupdate
php bin/php/ezpgenerateautoloads.php --extension
php bin/php/ezcache.php --clear-all

Führen Sie Composer als der Benutzer aus, dem die Dateien der Installation gehören, damit das, was es schreibt, dem richtigen Konto gehört.

Schalter und Berechtigungen

Aktualisieren und Installieren sind aus, bis Sie sie einschalten, in settings/override/ezupdate.ini.append.php:

Updates and packages, Paketserver: die Server, die Composer liest, etwa packagist.org
Updates and packages, Paketserver: die Server, die Composer liest, etwa packagist.org
[UpdateSettings]
AllowUpdate=enabled
AllowInstall=enabled

Composer schreibt vendor/ und jedes Paket, das es verwaltet, neu; schalten Sie diese also nur dort ein, wo das gewollt ist, mit einem Backup. Probeläufe funktionieren immer.

RichtlinieErlaubt
update/ezupdateansehen, auf Updates prüfen, Probelauf
update/manageaktualisieren, installieren, abrufen, Paketserver ändern

Administratoren haben beide. Ein Hoster entscheidet pro Tarif, ob die eigenen Administratoren des Kunden update/manage erhalten oder ob Updates ein Dienst sind, den der Hoster ausführt.

Wie ein Update abläuft

  1. Check for updates (composer outdated): ändert nichts.
  2. Vorschau (Probelauf): zeigt, was Composer ändern würde; jedes Paket ist als Can be installed oder Blocked by composer.json (constraint) gekennzeichnet.
  3. Bestätigen Sie, dass ein Backup existiert, dann Install updates für die angehakten Pakete. Es läuft im Hintergrund.
  4. Nach einer erfolgreichen Ausführung laufen die [JobSettings] AfterRunCommands[]: standardmäßig bin/php/ezpgenerateautoloads.php --extension und bin/php/ezcache.php --clear-tag=ini,template,content.
  5. Die Seite zeigt das Ergebnis: aktuell, eine Zusammenfassung der Änderungen oder den Exit-Code einer gescheiterten Ausführung.
Die installierten Pakete mit ihrer Version und dem neuesten verfügbaren Release
Die installierten Pakete mit ihrer Version und dem neuesten verfügbaren Release

Auf einer Website, die von PHP-FPM oder Velocity ausgeliefert wird, halten die laufenden Prozesse die alten Klassen im Speicher, bis sie neu geladen werden. Schließen Sie ein Update mit einem Ausrollen ab, das PHP-FPM neu lädt oder darauf wartet, Velocity neu startet und die Caches in der richtigen Reihenfolge leert (Änderungen ausrollen).

Was Sie automatisieren, und was nicht

Sicher zu automatisierenBewusst halten
ezupdate.php status und outdated auf jeder Website, in einem Bericht gesammeltupdate und require auf einer Live-Website
ezupdate.php installed --issues, um Websites zu finden, deren Lock-Datei und vendor/ nicht übereinstimmenAllowUpdate oder AllowInstall einschalten
Probeläufe eines Updates, um zu sehen, welche Pakete sich ändern würdenUpdates ohne frisches Backup
fund --direct --json für eine Liste, wovon die installierten Pakete finanziert werden möchtenUpdates ohne Test auf einer Staging-Kopie bei angepassten Websites

Die Aktionen auf der Kommandozeile:

php extension/ezupdate/bin/php/ezupdate.php status
php extension/ezupdate/bin/php/ezupdate.php installed --issues
php extension/ezupdate/bin/php/ezupdate.php outdated
php extension/ezupdate/bin/php/ezupdate.php jobs

Die vollständige Liste ist status, installed [--issues] [--json], outdated, search, show, servers, server-add, server-remove, packagist on|off, packages, fetch, require, update, jobs und fund. Auf der Kommandozeile gestartete Ausführungen erscheinen auch unter Letzte Ausführungen in der Administration. Die Anleitung der Erweiterung zur Kommandozeile dokumentiert ihre Exit-Codes für die Nutzung in Skripten.

Tipp Ein nächtlicher Job pro Installation, der outdated als Benutzer der Website ausführt und das Ergebnis per Mail an Ihr Team schickt oder dort veröffentlicht, macht aus der Frage, ob alles aktuell ist, einen Bericht, ohne eine einzige Datei zu ändern. Spielen Sie die Updates in einem Wartungsfenster ein, nach einem Backup, mit dem Probelauf, den Sie bereits durchgesehen haben.

Einstellungen, die einen Hoster betreffen

Alle in ezupdate.ini, überschrieben in settings/override/ezupdate.ini.append.php:

Updates and packages, Pakete finden: die Paketserver nach einer hinzuzufügenden Erweiterung durchsuchen
Updates and packages, Pakete finden: die Paketserver nach einer hinzuzufügenden Erweiterung durchsuchen
SchlüsselMitgeliefertWarum es einen Hoster betrifft
[ComposerSettings] SearchPath[]var/ezupdate/, bin/, ./, vendor/bin/, dann /usr/local/bin/, /usr/bin/, /opt/cpanel/composer/bin/relative Einträge kommen zuerst, weil open_basedir (Standard bei Plesk) die Systemordner verbirgt
[ComposerSettings] PHPBinaryleerdas PHP, das Composer und die Hintergrundjobs ausführt; setzen Sie es auf Hosts mit mehreren PHP-Versionen
[ComposerSettings] ComposerHomevar/ezupdate/composerCOMPOSER_HOME, wenn der Webserver keines übergibt, ein Ordner pro Systemkonto
[ComposerSettings] Timeout900Sekunden, die eine Ausführung von Composer dauern darf
[UpdateSettings] PreferredInstallautodist, source oder auto
[JobSettings] KeepJobs20aufbewahrte abgeschlossene Jobs

Get Composer in der Übersicht kann ein per SHA-256 geprüftes composer.phar nach var/ezupdate/ herunterladen, wo kein Composer installiert ist. Composer wird ohne Shell gestartet, im Wurzelverzeichnis der Installation, mit einer Zeitgrenze und ohne Rückfragen.

Checkliste

  • To do: ezupdate ist auf jeder Installation aktiv, die Sie aktualisieren, mit gesetztem PHPBinary, wo es mehrere PHP-Versionen gibt.
  • To do: AllowUpdate und AllowInstall sind nur dort an, wo Updates aus der Administration zum Tarif gehören.
  • To do: update/manage wird bewusst vergeben.
  • To do: Prüfungen auf Updates laufen nach Zeitplan und berichten an das Team; nichts wird unbeaufsichtigt aktualisiert.
  • To do: Vor jedem Update steht ein Backup, danach ein Ausrollen und ein Rauchtest.

Verwandte Seiten

Werden Sie Exponential-Partner

Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x