# Peamised teenused (main) – Docker kasutusjuhend

Kataloog: `/opt/docker-compose/main/`

## Teenused

| Konteiner | Pilt | Port | Selgitus |
|-----------|------|------|----------|
| portainer | portainer/portainer-ce | 9000, 9443 | Docker halduse veebiliides |
| postgres_postgis | kartoza/postgis:16 | 5432 | PostgreSQL + GIS |
| mariadb | mariadb:11 | 3306 | MySQL-ühilduv andmebaas |
| weaviate | semitechnologies/weaviate | 8080, 50051 | Vektorandmebaas |
| qdrant | qdrant/qdrant | 6333, 6334 | Vektorandmebaaas |
| jupyter | jupyter/datascience-notebook | 8887 | Python andmeteaduse töölaud |
| rocm_pytorch | rocm/pytorch | 8889, 6006 | PyTorch AMD GPU-ga |
| rag_api | custom (Dockerfile) | 8072 | RAG API |

## Docker käsud

```bash
# Käivita kõik
docker-compose -f /opt/docker-compose/main/docker-compose.yml up -d

# Peata kõik
docker-compose -f /opt/docker-compose/main/docker-compose.yml down

# Taaskäivita üks teenus
docker-compose -f /opt/docker-compose/main/docker-compose.yml restart portainer

# Logid (kõik)
docker-compose -f /opt/docker-compose/main/docker-compose.yml logs -f

# Logid (üks teenus)
docker-compose -f /opt/docker-compose/main/docker-compose.yml logs -f jupyter
```

## Üksikud konteinerid

```bash
# Portainer
docker logs portainer
docker restart portainer

# PostgreSQL
docker logs postgres_postgis
docker exec -it postgres_postgis psql -U ai_user -d research_db

# MariaDB
docker logs mariadb
docker exec -it mariadb mariadb -u ai_mariadb_user -p

# Jupyter
docker logs jupyter
# Ava brauseris: http://100.87.1.24:8887 (token: ai_server_2026)

# ROCm PyTorch
docker logs rocm_pytorch
# Ava brauseris: http://100.87.1.24:8889 (token: ai_pytorch_2026)
```

## Ligipääs

| Teenus | URL |
|--------|-----|
| Portainer | http://100.87.1.24:9000 |
| Jupyter | http://100.87.1.24:8887 (token: ai_server_2026) |
| ROCm PyTorch | http://100.87.1.24:8889 (token: ai_pytorch_2026) |
| Weaviate | http://100.87.1.24:8080 |
| Qdrant | http://100.87.1.24:6333 |
| RAG API | http://100.87.1.24:8072 |

## Andmebaaside paroolid

| Teenus | Kasutaja | Parool |
|--------|----------|--------|
| PostgreSQL | ai_user | ai_secure_pass_2026 |
| MariaDB | ai_mariadb_user | ai_mariadb_pass_2026 |

## Olulised kataloogid

| Asukoht | Sisu |
|---------|------|
| `/data/docker/jupyter/notebooks` | Jupyteri märkmikud |
| `/data/docker/jupyter/data` | Jupyteri andmed |
| `/data/docker/jupyter/pytorch-workspace` | PyTorch tööruum |
| `/backups/docker/portainer` | Varukoopiad |
| `/backups/docker/postgres` | Varukoopiad |
| `/backups/docker/mariadb` | Varukoopiad |

## Võrguinfo

- Kõik konteinerid on `ai_network` peal
- `rag-api` sõltub weaviate'ist ja postgres'ist


## Qdrant seadistus

### Healthcheck
Qdrant pildil pole curl/wget. Healthcheck kasutab bash TCP kontrolli:
```yaml
healthcheck:
  test: ["CMD", "bash", "-c", "</dev/tcp/localhost/6333"]
  interval: 30s
  timeout: 10s
  retries: 3
  start_period: 10s
```

### Config fail
`/opt/docker-compose/main/qdrant-config.yaml` on monteeritud konteinerisse:
```yaml
volumes:
  - qdrant_data:/qdrant/storage
  - ./qdrant-config.yaml:/qdrant/config/production.yaml:ro
```

Config sisaldab:
- `hnsw_ef_construct: 100` — HNSW indeksi kvaliteet
- `hnsw_m: 16` — graafi ühenduvus
- `on_disk: false` — vektorid RAM-is (kiirem)
- `max_request_size_mb: 256` — suurte päringute tugi

### Qdrant API test
```bash
# Tervisekontroll
curl http://localhost:6333/health

# Kollektsioonide loend
curl http://localhost:6333/collections | jq

# Kollektsiooni info
curl http://localhost:6333/collections/open-webui_files | jq
```

### Andmete varundamine
Andmed asuvad Docker volume's `qdrant_data`:
```bash
# Varunda Qdranti andmed
docker run --rm -v qdrant_data:/data -v /backups/docker/qdrant:/backup \
  alpine tar czf /backup/qdrant-backup-$(date +%Y%m%d).tar.gz -C /data .

# Taasta
docker run --rm -v qdrant_data:/data -v /backups/docker/qdrant:/backup \
  alpine tar xzf /backup/qdrant-backup-YYYYMMDD.tar.gz -C /data
```

## Ajalugu

| Kuupäev | Muudatus |
|---------|----------|
| 2025-07-05 | Qdrant viidud otse `docker run` pealt compose haldusesse |
| 2025-07-05 | Qdrant healthcheck parandatud — `true` -> bash TCP kontroll |
| 2025-07-05 | Qdrant config fail monteeritud (`qdrant-config.yaml`) |