M0 · Dockerfile, entrypoint e compose con pagina «in costruzione» #2

Closed
opened 2026-11-10 22:20:45 +01:00 by Alby96 · 0 comments
Owner

M0 — Bootstrap · Specifica: docs/SPEC.md §16.1, §16.2, §16.5, §16.6, Appendice C · ADR 0009, 0010 · Wiki: Installazione-Docker

Obiettivo

Avere fin da subito un'immagine Docker che si costruisce in locale e parte, con una pagina "in costruzione", l'icona e gli endpoint di salute.

Passi

  • docker/Dockerfile multi-stage: build su mcr.microsoft.com/dotnet/sdk:10.0 (restore con cache dei layer, check-packages.sh, test opzionali con --build-arg RUN_TESTS=true, dotnet publish … /p:Version=$VERSION /p:SourceRevisionId=$GIT_SHA); runtime mcr.microsoft.com/dotnet/aspnet:10.0 + postgresql-client-17 (repository PGDG), curl, tzdata
  • Utente app non root con PUID/PGID, VOLUME /data, EXPOSE 8080, HEALTHCHECK CMD curl -fs http://localhost:8080/health/live || exit 1, ENTRYPOINT ["/app/entrypoint.sh"]
  • Etichette OCI (org.opencontainers.image.*, sorgente = repository Gitea) e net.unraid.docker.icon / net.unraid.docker.webui con gli URL raw Gitea di ADR 0009
  • docker/entrypoint.sh (attesa DB, avvio; migrazioni e bootstrap arriveranno in M1–M2) e docker/postgres/init.sql
  • Khaemhat.Web minimo: pagina "in costruzione" con marca, icona, favicon (assets/), versione; /health/live e /health/ready
  • deploy/docker-compose.yml (app + postgres:17 + redis:7 nel profilo redis) e deploy/docker-compose.sqlite.yml (demo autonoma); verificare deploy/docker-compose.unraid.yml e deploy/unraid/khaemhat.xml già presenti
  • Provare docker build e docker compose -f deploy/docker-compose.sqlite.yml up in locale

Criteri di accettazione

  • L'immagine si costruisce in locale e il container risponde 200 su /health/live
  • Il container gira come utente non root e scrive solo in /data

Valgono sempre CLAUDE.md (emendamenti E1–E6), i vincoli di SPEC §1, le regole di codice di §19 e la Definition of Done di §20: stessa unità di lavoro per codice, test, wiki, docs/*.md e CHANGELOG.md.

**M0 — Bootstrap** · Specifica: `docs/SPEC.md` §16.1, §16.2, §16.5, §16.6, Appendice C · ADR 0009, 0010 · Wiki: [Installazione-Docker](https://gitea.encke-hake.ts.net/BalboSoft/Khaemhat/wiki/Installazione-Docker) ### Obiettivo Avere fin da subito un'immagine Docker che si costruisce in locale e parte, con una pagina "in costruzione", l'icona e gli endpoint di salute. ### Passi - [ ] `docker/Dockerfile` multi-stage: build su `mcr.microsoft.com/dotnet/sdk:10.0` (restore con cache dei layer, `check-packages.sh`, test opzionali con `--build-arg RUN_TESTS=true`, `dotnet publish … /p:Version=$VERSION /p:SourceRevisionId=$GIT_SHA`); runtime `mcr.microsoft.com/dotnet/aspnet:10.0` + `postgresql-client-17` (repository PGDG), `curl`, `tzdata` - [ ] Utente `app` non root con `PUID`/`PGID`, `VOLUME /data`, `EXPOSE 8080`, `HEALTHCHECK CMD curl -fs http://localhost:8080/health/live || exit 1`, `ENTRYPOINT ["/app/entrypoint.sh"]` - [ ] Etichette OCI (`org.opencontainers.image.*`, sorgente = repository Gitea) e `net.unraid.docker.icon` / `net.unraid.docker.webui` con gli URL raw Gitea di ADR 0009 - [ ] `docker/entrypoint.sh` (attesa DB, avvio; migrazioni e bootstrap arriveranno in M1–M2) e `docker/postgres/init.sql` - [ ] `Khaemhat.Web` minimo: pagina "in costruzione" con marca, icona, favicon (`assets/`), versione; `/health/live` e `/health/ready` - [ ] `deploy/docker-compose.yml` (app + `postgres:17` + `redis:7` nel profilo `redis`) e `deploy/docker-compose.sqlite.yml` (demo autonoma); verificare `deploy/docker-compose.unraid.yml` e `deploy/unraid/khaemhat.xml` già presenti - [ ] Provare `docker build` e `docker compose -f deploy/docker-compose.sqlite.yml up` in locale ### Criteri di accettazione - L'immagine si costruisce in locale e il container risponde `200` su `/health/live` - Il container gira come utente non root e scrive solo in `/data` --- Valgono sempre `CLAUDE.md` (emendamenti E1–E6), i vincoli di SPEC §1, le regole di codice di §19 e la Definition of Done di §20: stessa unità di lavoro per codice, test, wiki, `docs/*.md` e `CHANGELOG.md`.
Alby96 added this to the M0 — Bootstrap · v0.0.1 milestone 2026-11-10 22:20:45 +01:00
Alby96 added the Area/Docker e CIKind/Feature
Priority
High
Modulo/CORE
labels 2026-11-10 22:20:45 +01:00
Alby96 added this to the Khaemhat 1.0 — Sviluppo project 2026-11-10 22:20:54 +01:00
Alby96 moved this to Da fare in Khaemhat 1.0 — Sviluppo on 2026-11-10 22:20:54 +01:00
Alby96 referenced this issue from a commit 2026-11-11 11:57:28 +01:00
Alby96 moved this to Fatto in Khaemhat 1.0 — Sviluppo on 2026-11-11 12:17:43 +01:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: BalboSoft/Khaemhat#2