Installazione Docker nei contesti operativi correnti

ThothII usa una topologia Compose unica:

frontend
core
qdrant
embedding
embedding-model-init

Qdrant e Ollama embedding sono servizi interni obbligatori del progetto Compose. Restano esterni solo DWH e LLM. Il modello fissato è qwen3-embedding:0.6b con 1024 dimensioni e distanza coseno; embedding-model-init lo prepara prima dell'avvio di core.

flowchart TB
    INSTALL["Installation descriptor"] --> CONTEXT{Context}
    CONTEXT --> LOCAL["Local\nCompose local"]
    CONTEXT --> SERVER["Server\nCompose server"]
    CONTEXT --> SESSION["Session server\noperator services"]
    CONTEXT --> AUTH["Auth runtime\nprojection services"]
    LOCAL --> BUNDLE["Common secret bundle"]
    SERVER --> BUNDLE
    SESSION --> BUNDLE
    AUTH --> BUNDLE
    BUNDLE --> SERVICES["Frontend, core, vector, embedding"]

Contratto sintetico di ownership

Componente	Ownership	Contratto operativo
DWH	Esterno	Endpoint esterno configurato dall'installazione.
LLM	Esterno	Endpoint o policy esterna all'infrastruttura semantica interna.
Qdrant	Interno	Servizio Compose interno obbligatorio con volume persistente `qdrant-data`.
Ollama embedding	Interno	Servizio Compose interno obbligatorio per `qwen3-embedding:0.6b`.

Comando standard locale

cp deploy/env/local.env.example deploy/env/local.env
cp deploy/secrets/thothii.secrets.example deploy/secrets/thothii.secrets
chmod 600 deploy/secrets/thothii.secrets

docker compose --env-file deploy/env/local.env \
  -f compose.yaml -f deploy/compose.local.yaml up --build -d

Compilare deploy/env/local.env con:

PI_AUTH_FILE
THT_SECRETS_FILE
THT_WORKSPACE_GIT_REMOTE
endpoint DWH
endpoint LLM

Non inserire secret nel file .env. I secret runtime stanno nel bundle deploy/secrets/thothii.secrets.

Bundle dei secret

Le chiavi documentate e supportate nel bundle sono:

THT_MODEL_API_KEY=...
THT_DWH_API_KEY=...

Una CA privata PEM resta esterna al bundle e va montata con un override Compose revisionato.

Preprocessing

Il preprocessing passa dal CLI host nativo e dal descrittore dell'installazione:

tht --installation /percorso/assoluto/thothii-installation.yaml workspace preprocess evidence
tht --installation /percorso/assoluto/thothii-installation.yaml workspace preprocess dwh

Il CLI esegue il servizio profile-gated workspace-maintenance. I dettagli sono nel contratto del preprocessing e nella guida Evidence.

Server

Per installazioni server usare il profilo server con overlay sessioni:

docker compose --env-file deploy/env/server.env \
  -f compose.yaml -f deploy/compose.server.yaml \
  -f deploy/compose.session-server.yaml.example up --build -d

Consultare anche:

docs/install/local-workspace-registry.md
docs/install/server-workspace-registry.md

2.9 KiB Raw Blame History