homelab-codex-ws/services/kb-site
oskar 67e49a0952 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 13:08:13 +02:00
..
static feat(kb-site): noindex + robots.txt + obscure subdomain jako domyslny base-url 2026-08-05 13:08:13 +02:00
docker-compose.yml docs(kb-site): przepisz nieaktualne kb.okit.pl na kb-e2a24af3.okit.pl 2026-08-05 13:08:13 +02:00
env.example docs(kb-site): przepisz nieaktualne kb.okit.pl na kb-e2a24af3.okit.pl 2026-08-05 13:08:13 +02:00
healthcheck.sh feat(kb-site): serwis nginx na PIHA + manifesty (wzorzec narty27) 2026-08-04 17:59:05 +02:00
README.md docs(kb-site): przepisz nieaktualne kb.okit.pl na kb-e2a24af3.okit.pl 2026-08-05 13:08:13 +02:00
service.yaml docs(kb-site): przepisz nieaktualne kb.okit.pl na kb-e2a24af3.okit.pl 2026-08-05 13:08:13 +02:00

kb-site

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.

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:

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-e2a24af3.okit.pl) trafia do kontenera po opublikowanym porcie hosta 8250.

Dokumentacja: kb/services/kb-site.md