F1 · Dockerfile definitivo con entrypoint (PUID/PGID, cartella dati, healthcheck) #16

Closed
opened 2026-11-09 11:53:36 +01:00 by Alby96 · 1 comment
Owner

Fase 1 — Fondamenta · Specifica: docs/SPEC.md §15.2, 15.1

Obiettivo

L'immagine che sarà pubblicata, già con le regole di 15.2.

Passi

  • Multi-stage: dotnet publish su sdk:10.0, esecuzione su aspnet:10.0 con libgomp1; verifica che si carichino le librerie native di LightGBM e ONNX Runtime
  • Entrypoint: da root crea /data e la assegna a PUID:PGID, poi abbandona i privilegi (salta il passo con --user)
  • Fino alla Fase 6 l'entrypoint avvia direttamente il motore
  • HEALTHCHECK su database, ciclo del motore e flussi
  • Prova di avvio con sqlite e con postgres, e con configurazioni sbagliate

Criteri di accettazione della fase a cui contribuisce

  • L'immagine si costruisce e parte con ANUBIS_DB_ENGINE=sqlite e con postgres
  • Con una configurazione mancante o sbagliata compare la pagina d'errore e non nasce alcun altro database
  • Staccando il database compare la pagina d'errore e al ritorno l'applicazione riprende da sola

Valgono sempre le sezioni 2, 16 e 19 della specifica, lo stack dell'ADR 0003 (al posto della sezione 3), i soli componenti esterni dell'ADR 0004 e le regole di docs/SVILUPPO.md.

**Fase 1 — Fondamenta** · Specifica: `docs/SPEC.md` §15.2, 15.1 ### Obiettivo L'immagine che sarà pubblicata, già con le regole di 15.2. ### Passi - [ ] Multi-stage: `dotnet publish` su `sdk:10.0`, esecuzione su `aspnet:10.0` con `libgomp1`; verifica che si carichino le librerie native di LightGBM e ONNX Runtime - [ ] Entrypoint: da root crea `/data` e la assegna a `PUID:PGID`, poi abbandona i privilegi (salta il passo con `--user`) - [ ] Fino alla Fase 6 l'entrypoint avvia direttamente il motore - [ ] `HEALTHCHECK` su database, ciclo del motore e flussi - [ ] Prova di avvio con `sqlite` e con `postgres`, e con configurazioni sbagliate ### Criteri di accettazione della fase a cui contribuisce - L'immagine si costruisce e parte con `ANUBIS_DB_ENGINE=sqlite` e con `postgres` - Con una configurazione mancante o sbagliata compare la pagina d'errore e non nasce alcun altro database - Staccando il database compare la pagina d'errore e al ritorno l'applicazione riprende da sola --- Valgono sempre le sezioni 2, 16 e 19 della specifica, lo stack dell'ADR 0003 (al posto della sezione 3), i soli componenti esterni dell'ADR 0004 e le regole di `docs/SVILUPPO.md`.
Alby96 added this to the Fase 1 — Fondamenta milestone 2026-11-09 11:53:36 +01:00
Alby96 added the Kind/Feature
Priority
High
2
Area/Docker e CI
labels 2026-11-09 11:53:36 +01:00
Author
Owner

Fatto (commit f9d7155): deploy/docker/Dockerfile e deploy/docker/entrypoint.sh.

  • Avvio da root solo per creare le sottocartelle di /data e darle a PUID:PGID (99:100). Poi l'applicazione gira con quell'utente tramite setpriv, già nell'immagine di base: niente gosu.
  • chown -h solo su ciò che non appartiene già all'utente.
  • HEALTHCHECK con /dev/tcp di bash su /health; un 503 conta come container non sano.
  • Il logo è incluso da docs/design/logo.

Prove a mano sull'immagine

  • SQLite: sano, processo con uid 99, /data di 99:100, primo accesso fino al cambio della password.
  • PostgreSQL: sano, accesso e tutte le pagine con risposta 200.
  • PostgreSQL fermato: pagina d'errore e /health a 503; ripresa da sola 4 secondi dopo il ritorno.
  • Configurazione sbagliata: pagina d'errore. In /data nessun database, solo il registro e le chiavi dei moduli.

La CI costruisce l'immagine a ogni push.

**Fatto** (commit f9d7155): `deploy/docker/Dockerfile` e `deploy/docker/entrypoint.sh`. - Avvio da root solo per creare le sottocartelle di `/data` e darle a `PUID:PGID` (99:100). Poi l'applicazione gira con quell'utente tramite `setpriv`, già nell'immagine di base: niente `gosu`. - `chown -h` solo su ciò che non appartiene già all'utente. - `HEALTHCHECK` con `/dev/tcp` di bash su `/health`; un 503 conta come container non sano. - Il logo è incluso da `docs/design/logo`. **Prove a mano sull'immagine** - SQLite: sano, processo con uid 99, `/data` di 99:100, primo accesso fino al cambio della password. - PostgreSQL: sano, accesso e tutte le pagine con risposta 200. - PostgreSQL fermato: pagina d'errore e `/health` a 503; ripresa da sola 4 secondi dopo il ritorno. - Configurazione sbagliata: pagina d'errore. In `/data` nessun database, solo il registro e le chiavi dei moduli. La CI costruisce l'immagine a ogni push.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: BalboSoft/Anubis#16