Neos Upgrades - warum, wann und wie - 2024 Edition

Auf der Neos-Konferenz 2024 habe ich (wieder) einen Vortrag über die Aktualisierung von Neos gehalten. Ich habe versucht, vier Fragen zu beantworten:

1. Warum solltet du upgraden?
2. Wann sollte man upgraden?
3. Wie macht man Upgrades?
4. Was ist mit dem Umstieg auf Neos 9?

Das Video

Die Konferenz wurde wieder gestreamt und aufgezeichnet, so dass du dir meinen Vortrag unten ansehen kannst - und alle Vorträge sind in dieser Neos 2024 YouTube Playlist verfügbar.

Die Folien

Dies sind die Folien für den Vortrag:

Zusammenfassung

Die sehr kurze Version des Vortrags lautet:

• Warum?
  Weil du neue Funktionen und Fehlerbehebungen erhältst.
• Wann?
  Wann immer eine neue Version veröffentlicht wird.
• Wie?
  Anweisungen lesen und befolgen, testen und einsetzen.
• Was ist mit Neos 9?
  Schwierige Frage, es kommt darauf an. Aber im Allgemeinen ja. 😎

Weitere Lektüre

Wie versprochen, findest du hier Hinweise auf weitere Hintergrundinformationen. Ich habe versucht, sie nach Themen zu gruppieren.

Aufbruch zu Neos 9

Dieses Thema ist noch nicht abgeschlossen, also komme später nochmal wieder ...

• https://docs.neos.io/api/upgrade-instructions/9
• https://docs.neos.io/guide/content-repository/configuration
• https://docs.neos.io/guide/advanced/site-configuration
• https://docs.neos.io/guide/advanced/routing

Dokumentation

• Neos-Versionszyklus und Hintergrundinformationen: https://www.neos.io/features/release-process.html
• Versionshinweise sind zu finden unter: https://neos.readthedocs.io/en/stable/Appendixes/ReleaseNotes/index.html
• Update-Anweisungen sind in den Versionsankündigungen verlinkt und gesammelt unter: https://docs.neos.io/cms/references/upgrade-instructions
• Changelogs für jeden Zweig von befinden sich in der entsprechenden Online-Dokumentation: https: //flowframework.readthedocs.io/en/stable/TheDefinitiveGuide/PartV/ChangeLogs/index.html oder https://neos.readthedocs.io/en/stable/Appendixes/ChangeLogs/index.html - benutze die Versions-Auswahl unten links!

Auf dem Laufenden bleiben

• Neos-Ankündigungen: https://discuss.neos.io/c/announcements/28
• Neos-Blog: https://www.neos.io/blog.html
• PHP-Versionen: https://www.php.net/supported-versions.php
• Termine für das Ende der Produktlebensdauer:
  • https://www.elastic.co/support/eol
  • https://endoflife.date/

Sicherheit

• https://github.com/FriendsOfPHP/security-advisories/tree/master/neos
• https://packagist.org/packages/roave/security-advisories

Werkzeuge

• https://packagist.org/
• https://semver.madewithlove.com/
• Composer-Befehle:
  • https://getcomposer.org/doc/03-cli.md#outdated
  • https://getcomposer.org/doc/03-cli.md#depends-why
  • https://getcomposer.org/doc/03-cli.md#prohibits-why-not
• https://getrector.com/
• https://phpstan.org/

Beispiele für Codeanpassungen

Glücklicherweise sind die meisten Änderungen, die manuell vorgenommen werden müssen, projektübergreifend sehr ähnlich. Die folgenden Änderungen, die an den Seiten des Neos-Projekts vorgenommen wurden, können daher als Beispiele dienen!

Das Update von Neos 4.3 auf 5.3 für www.neos.io hat eine Weile gedauert... Das lag vor allem an den vielen Änderungen rund um das Marketplace-Paket. Schau dir den PR auf https://github.com/neos/Neos.NeosIo/pull/373 und den folgenden auf https://github.com/neos/Neos.NeosIo/pull/470 für das Update auf Neos 8.1 an.

Auf der Website docs.neos.io gab es ein Update von Neos 5.3 auf 7.1(https://github.com/neos/Neos.DocsNeosIo/pull/59) und kleinere Upgrades für die folgenden kleineren Versionen:

• auf 7.2: https://github.com/neos/Neos.DocsNeosIo/pull/63
• auf 7.3: https://github.com/neos/Neos.DocsNeosIo/pull/66
• auf 8.2: https://github.com/neos/Neos.DocsNeosIo/pull/100

Aktualisierungen für Neos 9 werden hoffentlich bald verfügbar sein. Ich werde sie hier einfügen, sobald sie erstellt sind.

Für den Moment verlinke ich dieses Issues, da es die Anzahl der Pakete zeigt, auf die (einige) noch warten müssen: https://github.com/neos/Neos.DocsNeosIo/issues/124

Neos aktualisieren - Warum, Wann und Wie © 2024 von Karsten Dambekalns ist lizenziert unter CC BY-NC-SA 4.0

Das Cover basiert auf einem Foto von Clint Patterson auf Unsplash