oskar/homelab-codex-ws
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
homelab-codex-ws/services/kb-site/README.md

22 lines
835 B
Markdown
Raw Permalink Normal View History

feat(kb-site): serwis nginx na PIHA + manifesty (wzorzec narty27) services/kb-site/ — nginx:alpine serwujacy wolumen kb-site_content (:ro, /usr/share/nginx/html), pelny layout z CLAUDE.md: docker-compose.yml, service.yaml, README-wskaznik, env.example (swiadomie pusty — brak sekretow), healthcheck.sh. Wpis w hosts/piha/services.yaml. Port hosta 8250, NIE 8240 z opisu zadania: 8240 jest juz zajete przez narty27 (services/narty27/docker-compose.yml). Blok statyczny PIHA to 8210 paperless, 8220 nextcloud, 8230 kb-query, 8240 narty27 -> 8250 to nastepny wolny. Uzgodnione z operatorem. exposure: public — w odroznieniu od narty27 ta wystawka ma byc dostepna z internetu przez vhost npm@PIHA kb.okit.pl; bind :8250 jest upstreamem proxy, nie punktem wejscia. Tresc jest czystym artefaktem repo (wyjscie scripts/kb/gen_pages.py), zyje wylacznie w wolumenie kb-site_kb-site_content — bez binda pod /opt/homelab/data i bez zadania backupu: odtworzeniem jest regeneracja z kb/. Sprawdzone lokalnie: docker compose config -q, bash -n healthcheck.sh, yaml.safe_load na obu manifestach.
2026-08-04 17:59:05 +02:00
# kb-site
docs(kb-site): przepisz nieaktualne kb.okit.pl na kb-e2a24af3.okit.pl Dociagniecie do zmiany DEFAULT_BASE_URL z 24afb49 — po niej repo w szesciu miejscach dalej podawalo stary adres. - kb/runbooks/kb-site-deploy.md: wszystkie wystapienia + rekord Cloudflare (Name: kb -> kb-e2a24af3). Runbook jest visibility: private, wiec slug moze stac wprost. - services/kb-site/{README.md,service.yaml,env.example,docker-compose.yml} - hosts/piha/services.yaml: komentarz przy exposure kb/services/kb-site.md swiadomie nietkniety — dokument publiczny, slug tam nie wchodzi (opisuje adres jako "non-obvious subdomain"). check_okf.py exit 0, gen_pages.py --check exit 0. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-05 12:34:13 +02:00
Public slice of the knowledge base (`kb-e2a24af3.okit.pl`) — static HTML generated from `kb/**/*.md` by `scripts/kb/gen_pages.py`, served by nginx on PIHA.
feat(kb-site): serwis nginx na PIHA + manifesty (wzorzec narty27) services/kb-site/ — nginx:alpine serwujacy wolumen kb-site_content (:ro, /usr/share/nginx/html), pelny layout z CLAUDE.md: docker-compose.yml, service.yaml, README-wskaznik, env.example (swiadomie pusty — brak sekretow), healthcheck.sh. Wpis w hosts/piha/services.yaml. Port hosta 8250, NIE 8240 z opisu zadania: 8240 jest juz zajete przez narty27 (services/narty27/docker-compose.yml). Blok statyczny PIHA to 8210 paperless, 8220 nextcloud, 8230 kb-query, 8240 narty27 -> 8250 to nastepny wolny. Uzgodnione z operatorem. exposure: public — w odroznieniu od narty27 ta wystawka ma byc dostepna z internetu przez vhost npm@PIHA kb.okit.pl; bind :8250 jest upstreamem proxy, nie punktem wejscia. Tresc jest czystym artefaktem repo (wyjscie scripts/kb/gen_pages.py), zyje wylacznie w wolumenie kb-site_kb-site_content — bez binda pod /opt/homelab/data i bez zadania backupu: odtworzeniem jest regeneracja z kb/. Sprawdzone lokalnie: docker compose config -q, bash -n healthcheck.sh, yaml.safe_load na obu manifestach.
2026-08-04 17:59:05 +02:00
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
## 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
```
docs(kb-site): przepisz nieaktualne kb.okit.pl na kb-e2a24af3.okit.pl Dociagniecie do zmiany DEFAULT_BASE_URL z 24afb49 — po niej repo w szesciu miejscach dalej podawalo stary adres. - kb/runbooks/kb-site-deploy.md: wszystkie wystapienia + rekord Cloudflare (Name: kb -> kb-e2a24af3). Runbook jest visibility: private, wiec slug moze stac wprost. - services/kb-site/{README.md,service.yaml,env.example,docker-compose.yml} - hosts/piha/services.yaml: komentarz przy exposure kb/services/kb-site.md swiadomie nietkniety — dokument publiczny, slug tam nie wchodzi (opisuje adres jako "non-obvious subdomain"). check_okf.py exit 0, gen_pages.py --check exit 0. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-05 12:34:13 +02:00
Ruch publiczny i tak nie idzie przez tę sieć: npm@PIHA (vhost `kb-e2a24af3.okit.pl`) trafia
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
do kontenera po opublikowanym porcie hosta `8250`.
feat(kb-site): serwis nginx na PIHA + manifesty (wzorzec narty27) services/kb-site/ — nginx:alpine serwujacy wolumen kb-site_content (:ro, /usr/share/nginx/html), pelny layout z CLAUDE.md: docker-compose.yml, service.yaml, README-wskaznik, env.example (swiadomie pusty — brak sekretow), healthcheck.sh. Wpis w hosts/piha/services.yaml. Port hosta 8250, NIE 8240 z opisu zadania: 8240 jest juz zajete przez narty27 (services/narty27/docker-compose.yml). Blok statyczny PIHA to 8210 paperless, 8220 nextcloud, 8230 kb-query, 8240 narty27 -> 8250 to nastepny wolny. Uzgodnione z operatorem. exposure: public — w odroznieniu od narty27 ta wystawka ma byc dostepna z internetu przez vhost npm@PIHA kb.okit.pl; bind :8250 jest upstreamem proxy, nie punktem wejscia. Tresc jest czystym artefaktem repo (wyjscie scripts/kb/gen_pages.py), zyje wylacznie w wolumenie kb-site_kb-site_content — bez binda pod /opt/homelab/data i bez zadania backupu: odtworzeniem jest regeneracja z kb/. Sprawdzone lokalnie: docker compose config -q, bash -n healthcheck.sh, yaml.safe_load na obu manifestach.
2026-08-04 17:59:05 +02:00
Dokumentacja: [kb/services/kb-site.md](../../kb/services/kb-site.md)
Reference in a new issue Copy permalink