Community-Lösung

Migration älterer CasaOS-Apps: Warum sich der Neuerstellungsprozess geändert hat

IceWhale documented a CasaOS 0.4.4-era legacy app rebuild process; later users found the old migration buttons were no longer present.

Der Beitrag zur „Migration älterer Apps“ aus dem Jahr 2023 beschreibt einen Übergang in CasaOS 0.4.4 und keinen aktuellen, universellen Migrationsablauf. IceWhale wies Nutzer von 0.4.4 an, ältere Apps manuell neu zu erstellen, und Nutzer älterer Versionen sollten zunächst auf 0.4.4-1 aktualisieren.

Da sich die Paketierung von CasaOS-/ZimaOS-Apps seitdem grundlegend geändert hat, sollte der historische Aktualisierungsbefehl nicht einfach in ein modernes System kopiert werden, nur um eine App zu migrieren.

Was die alte Migrationsfunktion bewirkte

CasaOS-Menü für ältere Apps mit „Neu erstellen“ und „Als Compose exportieren“
CasaOS 0.4.4 führte einen Bereich für ältere Apps mit den Aktionen „Neu erstellen“ und „Als Compose exportieren“ ein. Quelle: IceWhale-Community-Forum.

Die Benutzeroberfläche trennte ältere Anwendungsdefinitionen vom neueren Compose-basierten Modell und bot Aktionen wie „Neu erstellen“ und „Als Compose exportieren“. Ziel war es, die Anwendungseinstellungen beizubehalten und gleichzeitig die App-Definition umzuwandeln.

Der alte Aktualisierungsbefehl für 0.4.4-1 ist historisch

Der ursprüngliche Beitrag enthielt für Nutzer von CasaOS 0.4.3 und älteren Versionen einen einmaligen Aktualisierungsweg mit curl ... | sudo bash. Dabei handelte es sich um eine versionsspezifische Übergangslösung aus dem Jahr 2023, nicht um einen dauerhaft sicheren Befehl.

Eine Antwort aus dem Jahr 2024 zeigte bereits das Problem: Ein Nutzer mit einer neueren CasaOS-Version sah die gleichen Schaltflächen nicht mehr.

Moderne App-Stores verwenden neuere Metadatenverträge

Der aktuelle Leitfaden zur Migration von App Store v1 zu v2 dokumentiert ein neueres Store-Protokoll mit store.json, index.json, store-config.json und erforderlichen App-IDs.

Diese Seite richtet sich an Maintainer von App-Stores, zeigt aber, warum die alte Benutzeroberfläche für „ältere Apps“ als historische Migrationsebene betrachtet werden sollte.

Bei einer Benutzermigration zuerst die App-Daten schützen

Bevor Sie eine alte App-Definition ersetzen, notieren Sie das Image, die Ports, die Umgebungsvariablen und die Pfade der Volumes auf dem Host. Sichern Sie dauerhafte Konfigurations- und Nutzdaten und erstellen Sie die App anschließend mit dem aktuellen Store-Paket oder einer geprüften Compose-Datei neu.

Die Grundlagen der Docker-App-Migration behandelt die Container-Bestandteile, die tatsächlich erhalten bleiben müssen.

Fazit

Die alte Schaltfläche „Neu erstellen“ war ein Kompatibilitätswerkzeug aus der Ära von CasaOS 0.4.4. Führen Sie kein Downgrade durch und verwenden Sie kein historisches Aktualisierungsskript, um genau dieses Menü wiederherzustellen. Bewahren Sie die App-Daten, exportieren oder rekonstruieren Sie die Compose-Einstellungen und migrieren Sie anschließend in das aktuelle App-Modell.