88 lines
2.5 KiB
Markdown
88 lines
2.5 KiB
Markdown
# 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`.
|
|
|
|
## 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
|
|
|
|
```sh
|
|
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:
|
|
|
|
```dotenv
|
|
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
|
|
|
|
I job di preprocessing usano gli stessi servizi interni Qdrant/Ollama:
|
|
|
|
```sh
|
|
docker compose --env-file deploy/env/local.env \
|
|
-f compose.yaml -f deploy/compose.local.yaml \
|
|
-f deploy/compose.preprocess.yaml --profile preprocess run --rm preprocess-evidence
|
|
```
|
|
|
|
Per introspezione DWH:
|
|
|
|
```sh
|
|
docker compose --env-file deploy/env/local.env \
|
|
-f compose.yaml -f deploy/compose.local.yaml \
|
|
-f deploy/compose.preprocess.yaml --profile preprocess run --rm preprocess-dwh
|
|
```
|
|
|
|
## Server
|
|
|
|
Per installazioni server usare il profilo server con overlay sessioni:
|
|
|
|
```sh
|
|
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`
|