Ein schlankes Symfony-Bundle zum Pr\u00fcfen und Ausf\u00fchren von Updates in bestehenden Symfony-Projekten.<\/p>\n\n\n\n
composer.json<\/code> deines Zielprojekts hinzuf\u00fcgen:<\/li>\n<\/ol>\n\n\n\n \"repositories\": [\n {\n \"type\": \"vcs\",\n \"url\": \"https:\/\/github.com\/Odido\/programname.git\"\n }\n ],<\/code><\/pre>\n\n\n\n\n- Vorab-Konfiguration anlegen (Wichtig!):<\/strong>
Damit die Installation ohne Fehler durchl\u00e4uft (wegen des automatischen cache:clear<\/code>), erstelle zuerst<\/strong> die Datei config\/packages\/adlib_updater.yaml<\/code> in deinem Projekt:<\/li>\n<\/ol>\n\n\n\n adlib_updater:\n # MANDATORY: Die URL zu deinem GitHub Repository\n update_url: 'https:\/\/github.com\/Odido\/project-url' \n\n # OPTIONAL: GitHub Token f\u00fcr private Repositories\n github_token: '%env(GITHUB_TOKEN)%' \n\n # OPTIONAL: Pfade (Standardwerte werden hier gezeigt)\n target_dir: '%kernel.project_dir%'\n temp_dir: '%kernel.project_dir%\/var\/updater'<\/code><\/pre>\n\nDie update_url<\/code> ist die URL zu dem Projekt, das upgedated werden soll.<\/p>\n\n\n- Bundle installieren:<\/li>\n<\/ol>\n\n\n\n
composer require adlib\/updater-bundle<\/code><\/pre>\n\n\n\n\n- Bundle registrieren (falls keine Auto-Discovery\/Flex):<\/li>\n<\/ol>\n\n\n\n
\/\/ config\/bundles.php\n return [\n Adlib\\UpdaterBundle\\AdlibUpdaterBundle::class => ['all' => true],\n ];<\/code><\/pre>\n\n\n\nTwig in deinem Template nutzen (Beispiel Header\/Banner):<\/h2>\n\n\n\n {% if updater_has_update() %}\n <div class=\"alert alert-warning\">\n Es ist eine neue Version {{ updater_remote_version() }} verf\u00fcgbar.\n <form action=\"{{ path('adlib_updater_run') }}\" method=\"post\" style=\"display:inline;\">\n <button class=\"btn btn-sm btn-primary\">Update jetzt ausf\u00fchren<\/button>\n <\/form>\n <\/div>\n {% endif %}<\/code><\/pre>\n\n\n\nFunktionsweise (GitHub-Integration)<\/h2>\n\n\n\n\n- Version-Check:<\/strong> Das Bundle fragt die GitHub API (
api.github.com\/repos\/...\/tags<\/code>) ab und vergleicht den neuesten Tag (z.B. v1.2.3<\/code>) mit deiner VERSION<\/code> in der .env<\/code>.<\/li>\n\n\n\n- Download:<\/strong> Bei einem Update wird das ZIP-Archiv des Tags von GitHub heruntergeladen (
\/archive\/refs\/tags\/v{version}.zip<\/code>).<\/li>\n\n\n\n- Backup:<\/strong> Vor der Installation werden die Ordner
src<\/code>, templates<\/code>, config<\/code>, public<\/code>, translations<\/code> und assets<\/code> sowie die .env<\/code> in einen Zeitstempel-Ordner unter var\/updater\/backup_...<\/code> gesichert.<\/li>\n\n\n\n- Installation:<\/strong> Das ZIP wird entpackt und der Inhalt (Source-Code) \u00fcber deine bestehenden Dateien dr\u00fcberkopiert.<\/li>\n\n\n\n
- Rollback:<\/strong> Tritt beim Entpacken oder Kopieren ein Fehler auf, wird automatisch der Zustand aus dem Backup wiederhergestellt. Bei einem totalen Systemausfall kann das Rollback auch manuell \u00fcber die Konsole gestartet werden:
php bin\/console adlib:updater:rollback<\/code>.<\/li>\n<\/ul>\n\n\n\nWie funktioniert’s?<\/h2>\n\n\n\n\n- Beim erfolgreichen Login l\u00f6st
UpdateCheckSubscriber<\/code> eine Abfrage der Remote-Version aus (via GitHub API \/tags<\/code>).<\/li>\n\n\n\n- Ist die Remote-Version (der neueste Tag) gr\u00f6\u00dfer als
VERSION<\/code> aus deiner .env<\/code>, wird in der Session ein Flag gesetzt.<\/li>\n\n\n\n- \u00dcber die Twig-Extension kannst du den Status abfragen und einen Button anzeigen.<\/li>\n\n\n\n
- Der
UpdateController<\/code> startet den Update-Prozess (UpdateManager<\/code>). Bei Fehlern wird automatisch ein Rollback versucht und alles geloggt.<\/li>\n<\/ul>\n\n\n\nConsole-Befehle<\/h2>\n\n\n\nRollback (Manuell)<\/h3>\n\n\n\n
Sollte die Anwendung nach einem Update nicht mehr erreichbar sein, kann ein Rollback \u00fcber die Kommandozeile durchgef\u00fchrt werden.<\/p>\n\n\n\n
php bin\/console adlib:updater:rollback<\/code><\/pre>\n\n\n\nVerhalten:<\/strong><\/p>\n\n\n\n\n- Ohne weitere Optionen sucht der Befehl automatisch nach dem aktuellsten Backup im konfigurierten
temp_dir<\/code> (Standard: var\/updater\/backup_...<\/code>).<\/li>\n\n\n\n- Es wird eine Sicherheitsabfrage angezeigt, bevor die Dateien wiederhergestellt werden.<\/li>\n<\/ul>\n\n\n\n
Optionen:<\/strong><\/p>\n\n\n\n\n--backup-dir=\/pfad\/zum\/backup<\/code>: Erm\u00f6glicht die Angabe eines spezifischen Backup-Ordners, falls nicht das aktuellste Backup verwendet werden soll.<\/li>\n<\/ul>\n\n\n\nLogging<\/h2>\n\n\n\n
Das Bundle nutzt den Standard-Logger von Symfony und verwendet einen eigenen Kanal namens updater<\/code>. Dieser Kanal wird vom Bundle automatisch registriert.<\/p>\n\n\n\nDas symfony\/monolog-bundle<\/code> ist als Abh\u00e4ngigkeit definiert und wird automatisch mitinstalliert.<\/p>\n\n\n\nKonfiguration (Beispiel)<\/h3>\n\n\n\n
Um alle Meldungen des Updaters in eine separate Datei zu schreiben, kannst du in deiner config\/packages\/monolog.yaml<\/code> einen neuen Handler hinzuf\u00fcgen. Achte hierbei auf den when@level:<\/p>\n\n\n\nmonolog:\n handlers:\n updater:\n type: stream\n path: \"%kernel.logs_dir%\/updater.log\"\n level: info\n channels: [\"updater\"]<\/code><\/pre>\n\n\n\nFalls du keine separate Datei m\u00f6chtest, stelle sicher, dass deine Standard-Handler den Kanal updater<\/code> nicht ausschlie\u00dfen und das Log-Level auf info<\/code> (oder niedriger) steht, besonders in der prod<\/code>-Umgebung. Die Logdateien finden sich, wenn die Standardeinstellungen in config\/packages\/monolog.yaml nicht ge\u00e4ndert wurden, unter var\/log.<\/p>\n\n\n\nTODO \/ Erweiterungen<\/h2>\n\n\n\n\n- Implementierung des echten Download\/Backup\/Rollback-Flows (Tar\/Zip), Checksummen, Wartungsmodus.<\/li>\n\n\n\n
- Ratenbegrenzung der Update-Pr\u00fcfung (z.B. 1x pro Prozessstart o. Session).<\/li>\n\n\n\n
- Ausgelagerter Update-Status (Cache\/DB) anstatt Session, wenn gew\u00fcnscht.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
Adlib Updater Bundle Ein schlankes Symfony-Bundle zum Pr\u00fcfen und Ausf\u00fchren von Updates in bestehenden Symfony-Projekten. Installation (manuell, ohne Flex-Recipe) Die update_url ist die URL zu dem Projekt, das upgedated werden soll. Twig in deinem Template nutzen (Beispiel Header\/Banner): Funktionsweise (GitHub-Integration) Wie funktioniert’s? Console-Befehle Rollback (Manuell) Sollte die Anwendung nach einem Update nicht mehr erreichbar sein, […]<\/p>\n","protected":false},"author":3,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1825","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/wiki.ad-libitum.info\/index.php?rest_route=\/wp\/v2\/pages\/1825","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wiki.ad-libitum.info\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/wiki.ad-libitum.info\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/wiki.ad-libitum.info\/index.php?rest_route=\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/wiki.ad-libitum.info\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1825"}],"version-history":[{"count":4,"href":"https:\/\/wiki.ad-libitum.info\/index.php?rest_route=\/wp\/v2\/pages\/1825\/revisions"}],"predecessor-version":[{"id":1829,"href":"https:\/\/wiki.ad-libitum.info\/index.php?rest_route=\/wp\/v2\/pages\/1825\/revisions\/1829"}],"wp:attachment":[{"href":"https:\/\/wiki.ad-libitum.info\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1825"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}