homelab-codex-ws/services/kb-site/README.md
oskar 4ecbdbb0a4 fix(kb-site): dolacz do istniejacej sieci proxy zamiast tworzyc wlasna
Docker na PIHA wyczerpal domyslne pule adresowe (~30 zywych stackow,
"all predefined address pools have been fully subnetted"), wiec
docker-compose nie mogl zalozyc kb-site_default i serwis nie wstawal.

Deklaracja networks: [proxy] na serwisie wylacza domniemana siec
domyslna i podpina kontener pod istniejacy bridge "proxy"
(192.168.0.0/20, tworzony poza tym stackiem) — zero nowych podsieci.

Bez wplywu na ruch: npm@PIHA siedzi na nginxproxymanager_default i
trafia do kb-site po opublikowanym porcie hosta 8250, nie po tej sieci.

Walidacja: yaml.safe_load + asercje ksztaltu (bez testu na PIHA).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-04 21:28:43 +02:00

22 lines
817 B
Markdown

# kb-site
Public slice of the knowledge base (`kb.okit.pl`) — static HTML generated from `kb/**/*.md` by `scripts/kb/gen_pages.py`, served by nginx on PIHA.
## Sieć
Stack nie tworzy własnej sieci — dołącza do istniejącego bridge'a `proxy` na PIHA
(`external: true`). Powód: Docker na PIHA wyczerpał domyślne pule adresowe
(`all predefined address pools have been fully subnetted`), więc kolejny
`kb-site_default` nie może powstać.
Warunek wstępny deployu — sieć musi już istnieć na hoście:
```bash
docker network ls | grep -w proxy # brak wyniku => docker network create proxy
```
Ruch publiczny i tak nie idzie przez tę sieć: npm@PIHA (vhost `kb.okit.pl`) trafia
do kontenera po opublikowanym porcie hosta `8250`.
Dokumentacja: [kb/services/kb-site.md](../../kb/services/kb-site.md)