diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml index 856b53c..1e7aa75 100644 --- a/.gitea/workflows/ci.yml +++ b/.gitea/workflows/ci.yml @@ -23,6 +23,9 @@ jobs: POSTGRES_DB: anubis POSTGRES_USER: anubis POSTGRES_PASSWORD: anubis-ci + # A throwaway server on a slow disk: without syncs to disk, the checkpoint that every DROP DATABASE of the + # tests forces takes milliseconds instead of up to 37 seconds (ADR 0015). Never for a real database. + POSTGRES_INITDB_ARGS: "--no-sync -c fsync=off -c synchronous_commit=off -c full_page_writes=off" # --init and a pg_isready that gives up before Docker does (ADR 0015, issue #98). Without them a health # check that outlives its timeout leaves pg_isready to PostgreSQL as PID 1, and its exit restarts the server. options: >- diff --git a/docs/adr/0015-postgresql-con-init-nei-container.md b/docs/adr/0015-postgresql-con-init-nei-container.md index 2a0b2ca..90f6c89 100644 --- a/docs/adr/0015-postgresql-con-init-nei-container.md +++ b/docs/adr/0015-postgresql-con-init-nei-container.md @@ -1,4 +1,4 @@ -# 0015 — PostgreSQL nei container con un processo init e un controllo di salute che non si interrompe a metà +# 0015 — PostgreSQL nei container con un processo init; nella CI, senza sincronizzazioni su disco Data: 2026-11-15 · Stato: accettata · Precisa la CI (SPEC 15.5, ADR 0007) e il `docker-compose.yml` di sviluppo, issue #98, senza componenti esterni nuovi @@ -29,18 +29,32 @@ Spiega anche gli altri indizi: - si vede da quando la suite è cresciuta con il commit della raccolta dei dati (issue #95), cioè più database creati e cancellati; - in locale non capita, perché il disco è veloce. -Non c'entrano la memoria, `/dev/shm` (64 MiB, il server ne usa poco), `pg_database_size` del campionatore e il `CREATE`/`DROP DATABASE` dei test in sé: quelli rendono il server lento, non lo fanno ripartire. +Non c'entrano la memoria, `/dev/shm` (64 MiB, il server ne usa poco) e `pg_database_size` del campionatore. Il `CREATE`/`DROP DATABASE` dei test rende il server lento, ma da solo non lo fa ripartire. + +**Seconda causa, vista dopo la prima correzione.** In un'esecuzione con la correzione il server non è più ripartito, ma 7 test sono falliti lo stesso: +- `Timeout during reading attempt` dopo circa 1 minuto e 18 secondi; +- `/primo-avvio?errore=database` nel test del primo avvio desktop, lo stesso errore visto il 14 novembre nell'esecuzione 304. + +Il registro del server mostra il motivo: +- ogni `DROP DATABASE` forza un checkpoint immediato, e i checkpoint passano uno alla volta; +- sul disco dell'esecutore la sola sincronizzazione su disco ha richiesto fino a 37 secondi (`sync=36.849 s`); +- i `DROP DATABASE` in coda hanno superato i 30 secondi di attesa del client (`canceling statement due to user request`); +- il test desktop non ha avuto la connessione nei 5 secondi dell'applicazione. + +Il server era vivo, ma fermo ad aspettare il disco. ## Decisione 1. **Un processo init davanti a PostgreSQL.** Il servizio `postgres` della CI parte con `--init`, e quello di `docker-compose.yml` con `init: true`. Il processo 1 diventa il piccolo init di Docker: raccoglie lui i processi rimasti senza genitore, e PostgreSQL non li vede più. 2. **`pg_isready` si arrende prima di Docker.** Il controllo è `pg_isready -U anubis -d anubis -t 5` con `--health-timeout 15s`. Così Docker non chiude mai la shell mentre `pg_isready` sta ancora aspettando. L'intervallo resta di 3 secondi, quindi l'avvio non rallenta. -3. **Il registro del server resta nella CI.** Il passo `PostgreSQL log` gira sempre a fine lavoro `test (postgres)`. Mostra anche se l'init è attivo e com'è il controllo di salute. Il prossimo problema del server si legge lì, senza rilanciare alla cieca. +3. **Nella CI il PostgreSQL dei test non sincronizza su disco.** Il servizio nasce con `POSTGRES_INITDB_ARGS: "--no-sync -c fsync=off -c synchronous_commit=off -c full_page_writes=off"` (l'opzione `-c` di `initdb` esiste da PostgreSQL 16). Così il checkpoint forzato da ogni `DROP DATABASE` scrive solo nella memoria del sistema e dura millisecondi. È ammesso solo perché quel server vive per un lavoro e poi si butta. Non vale per `docker-compose.yml` né per nessun database vero: lì un'interruzione di corrente senza `fsync` può rovinare i dati. +4. **Il registro del server resta nella CI.** Il passo `PostgreSQL log` gira sempre a fine lavoro `test (postgres)`. Mostra anche se l'init è attivo e com'è il controllo di salute. Il prossimo problema del server si legge lì, senza rilanciare alla cieca. -Le due misure si coprono a vicenda: ognuna da sola basta a togliere la causa. +Le misure 1 e 2 si coprono a vicenda: ognuna da sola basta a togliere la prima causa. La 3 toglie la seconda, e rende anche più raro un controllo di salute lento. ## Conseguenze - Il lavoro `test (postgres)` non perde più il server a metà. Rilanciarlo per farlo passare nascondeva la causa, e ora non serve più. - Nessun test e nessuna parte di Anubis cambia: il difetto era nel modo in cui gira il contenitore, non nel bot. +- I test su PostgreSQL nella CI non provano la durata dei dati dopo un'interruzione. Non lo facevano neanche prima: quella è una proprietà di PostgreSQL, non di Anubis. - **Per l'installazione su Unraid:** se il PostgreSQL che usa Anubis gira in un container con un controllo di salute basato su `pg_isready` e senza init, ha lo stesso rischio sotto carico. Il rimedio è lo stesso: l'opzione `--init` (in Unraid, "Extra Parameters") oppure un controllo con `-t` più breve del suo tempo massimo. Il template `deploy/unraid/anubis.xml` non installa PostgreSQL, quindi lì non cambia niente.