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-/24 ist, 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.

Release nachschlagen und festhalten, was jetzt läuft
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
Compose-Datei und Skripte des neuen Releases holen
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
Neue oder geänderte Variablen seit dem Anlegen deiner .env ansehen
diff <(grep -o '^[A-Z_0-9]*=' .env | sort) <(grep -o '^[A-Z_0-9]*=' .env.example.new | sort)
App aufs neue Image umstellen, prüfen, ziehen und starten
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.

Stimmt etwas auf dieser Seite nicht? Sag es uns.