Updates
Aktualisieren
- In der
.envdie neue Version eintragen:HIWISKI_VERSION=<neue Version>. - Das Image holen und starten:
docker compose pull app
docker compose up -d
Der Server sichert von selbst, wenn er mit einer anderen Version startet als zuletzt — bevor er die Datenbank anfasst. Bis diese Sicherung geschrieben ist, ist die App noch nicht erreichbar; im Protokoll steht „Backing up before the update to …“. Schlägt die Sicherung fehl (meist eine volle Platte), migriert der Server nichts und startet nicht; die alte Version startet weiter wie vorher.
Was eine Version mitbringt und ob beim Update etwas zu beachten ist, steht unter Neuigkeiten im Abschnitt Upgrade notes.
Zurück zur alten Version
Genauso, mit der alten Version in der .env. Schema-Änderungen sind so umgesetzt, dass der alte Server auch mit dem neuen Schema startet. Die Sicherung vor dem Update — „Vor dem Update auf …“ in der Liste — lässt sich auf der alten Version wiederherstellen und auf jeder neueren.
Eine eigene Rolle für den Server (optional)
Ein mit den aktuellen Dateien eingerichteter Server meldet sich mit einer eigenen Rolle bei Postgres an, die kein Superuser ist: Ließe ein Fehler je SQL durch, käme es nicht weiter als bis zur Datenbank. Ein früher eingerichteter Server behält seine eine Rolle und läuft unverändert weiter. Umstellen geht so:
- Erst sichern (Jetzt sichern). Die aktuelle
docker-compose.ymlaus dem Release holen, danndocker compose up -d postgresunddocker compose stop app. Hast duHIWISKI_DB_ADMIN_USERundHIWISKI_DB_ADMIN_PASSWORDaus der neuen.env.exampleschon ohne Umzug in deine.envübernommen, nimm diese beiden Zeilen zuerst wieder heraus. - Eine Datenbank-Shell öffnen:
docker compose exec postgres sh -c 'psql -U "$HIWISKI_DB_USER" -d "$POSTGRES_DB"'(bis Schritt 3 ist das deine alte Rolle, der Superuser), und das hier einfügen, mit einem neuen langen Passwort (openssl rand -hex 24) und, falls deiner anders heißt, deinemHIWISKI_DB_NAMEstatthiwiskiin der letzten Zeile:
create role hiwiski_app login password 'NEW-PASSWORD'
nosuperuser nocreatedb nocreaterole noreplication nobypassrls;
do $$
declare t record;
begin
for t in select tablename from pg_tables where schemaname = 'public' loop
execute format('alter table public.%I owner to hiwiski_app', t.tablename);
end loop;
end $$;
alter database hiwiski owner to hiwiski_app;
- In der
.env:HIWISKI_DB_USERundHIWISKI_DB_PASSWORDinHIWISKI_DB_ADMIN_USERundHIWISKI_DB_ADMIN_PASSWORDumbenennen, die Werte bleiben; dazuHIWISKI_DB_USER=hiwiski_appundHIWISKI_DB_PASSWORD=mit dem neuen Passwort. docker compose up -d.
Die Apps
Apps und Server dürfen unterschiedliche Versionen haben. Nicht jedes Gerät muss gleichzeitig aktualisiert werden.