alan/docs/update-strategy.md

Update-Strategie

Dieses Repo trennt bewusst zwischen Pinning, Upgrade, Health-Pruefung und Rollback.

Prinzip

• .env enthaelt den gewuenschten HERMES_TAG
• pin-hermes <tag> aendert nur den Ziel-Tag
• update-hermes [tag] sichert zuerst den State und fuehrt dann das Upgrade aus
• rollback-hermes rollt auf den zuletzt als gesund gespeicherten Stand zurueck

Empfohlener Ablauf

Vor einem groesseren Update:

./scripts/alanctl doctor
./scripts/alanctl backup
./scripts/alanctl update-hermes v0.9.3

Wenn der neue Stand nicht sauber hochkommt:

./scripts/alanctl rollback-hermes

Wenn das Problem in einer State-Migration liegt:

./scripts/alanctl restore ./backups/hermes/hermes-YYYYMMDD-HHMMSS.tar.gz

Warum nicht dauerhaft latest

latest ist bequem, aber fuer einen reproduzierbaren Desktop- oder Homeserver-Betrieb unnoetig riskant. Ein fixer Tag macht Updates nachvollziehbar und Rollbacks deutlich einfacher.