Zwischen Versionen wechseln
Patch-Releases innerhalb deiner Linie sind ein Befehl. Der Wechsel auf eine neue Minor-Linie oder von einer festgenagelten Version ist ein bewusster Schritt: Backup machen, Hinweise lesen, die neue Compose-Datei holen, dann den Tag umstellen.
Bevor du anfängst
- Mach ein Backup. Migrationen gehen nur vorwärts. Zurück über ein Release, das die Datenbank geändert hat, kommst du nur mit dem Einspielen des Backups (Backups).
- Lies die Hinweise zu jedem Release, das du überspringst, in den Upgrade-Hinweisen. Bei manchen musst du vor dem Update eine Einstellung ändern. Zum Beispiel verhindert ein
TRUSTED_PROXY_CIDRS, das breiter als ein IPv4-/24ist, jetzt den Start des Servers: Grenze es vorher auf die Adresse deines Proxys ein. - Sieh dir das Release an, in Admin > System, mit seinen Notizen.
Festgenagelt, oder eine neue Minor-Linie
Führ das im Deployment-Ordner aus. Die ersten Zeilen suchen das neueste Release heraus; setz NEW selbst, um ein anderes zu installieren.
NEW=$(curl -fsSL https://api.github.com/repos/mnema-xyz/talk/releases/latest | sed -n 's/.*"tag_name": *"v\([^"]*\)".*/\1/p')[ -n "$NEW" ] || { echo "could not read the latest version; set NEW=x.y.z yourself" >&2; false; }grep '^MNEMA_IMAGE=' .envcurl -fsS http://127.0.0.1:8080/api/healthcp docker-compose.yml docker-compose.yml.bak
base=https://raw.githubusercontent.com/mnema-xyz/talk/v$NEWcurl -fsSLo docker-compose.yml "$base/docker-compose.yml"curl -fsSLo .env.example.new "$base/.env.example"for f in backup.sh backup-common.sh backup-online.sh restore.sh upgrade-postgres.sh health-check.sh; do curl -fsSLo "scripts/$f" "$base/scripts/$f"donechmod +x scripts/*.sh
diff <(grep -o '^[A-Z_0-9]*=' .env | sort) <(grep -o '^[A-Z_0-9]*=' .env.example.new | sort)
if grep -q '^MNEMA_IMAGE=' .env; then sed -i "s|^MNEMA_IMAGE=.*|MNEMA_IMAGE=ghcr.io/mnema-xyz/mnema-talk:$NEW|" .envelse echo "MNEMA_IMAGE=ghcr.io/mnema-xyz/mnema-talk:$NEW" >> .envfidocker compose config -qdocker compose pull appdocker compose up -d
sed -i ist so für Linux geschrieben; unter macOS nimmst du sed -i ''. Nutzt du das Profil turn oder autoupdate, häng an den letzten Befehl --profile turn oder --profile autoupdate an. Prüf danach das Ergebnis.
Zurückrollen
Stoppe die App, bevor du ihr Image oder die Datenbank änderst. Hat die neue Version Migrationen angewendet (migration applied in ihrem Log), kann die alte Version auf dieser Datenbank nicht laufen: Spiel das Backup ein, das du vor dem Update gemacht hast, und starte dann das alte Image.
docker compose stop appcp docker-compose.yml.bak docker-compose.yml./scripts/restore.sh /path/to/backups/<timestamp> --verify./scripts/restore.sh /path/to/backups/<timestamp> --yes
Setz MNEMA_IMAGE in der .env wieder auf die Version, die du dir notiert hast, dann:
docker compose pull appdocker compose up -d --waitcurl -fsS http://127.0.0.1:8080/api/health
Heb das Backup und docker-compose.yml.bak auf, bis die neue Version deine eigenen Prüfungen bestanden hat. Hinweise zum Zurückrollen einzelner Versionen: Rollback.
Clients
Die Web-App aktualisiert sich mit dem Server. Desktop-Apps suchen selbst nach Updates und verbinden sich mit einer Erklärung nicht, wenn keine geprüfte App-Version zum Server passt; die Upgrade-Hinweise nennen die Desktop-Version, die jedes Release braucht.