79 lines
1.9 KiB
Markdown
79 lines
1.9 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.
|
|
|
|
## 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`
|