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>
This commit is contained in:
oskar 2026-08-05 12:34:13 +02:00
parent db81cb15d3
commit 67e49a0952
6 changed files with 21 additions and 21 deletions

View file

@ -168,7 +168,7 @@ services:
kb-site: kb-site:
role: static-html-host # public KB slice generated by scripts/kb/gen_pages.py role: static-html-host # public KB slice generated by scripts/kb/gen_pages.py
deployment_model: docker-compose deployment_model: docker-compose
exposure: public # via npm@PIHA vhost kb.okit.pl; container binds LAN :8250 exposure: public # via npm@PIHA vhost kb-e2a24af3.okit.pl; container binds LAN :8250
offline_required: false offline_required: false
depends_on: depends_on:
local: [] local: []

View file

@ -3,17 +3,17 @@ okf: "0.1"
type: runbook type: runbook
visibility: private visibility: private
status: active status: active
updated: 2026-08-04 updated: 2026-08-05
links: links:
- ../services/kb-site.md - ../services/kb-site.md
- ./npm-api.md - ./npm-api.md
- ../phases/okit-cloudflare.md - ../phases/okit-cloudflare.md
--- ---
# kb-site — deploy, publikacja treści, ingress (kb.okit.pl) # kb-site — deploy, publikacja treści, ingress (kb-e2a24af3.okit.pl)
Serwis: `services/kb-site/` (nginx:alpine na PIHA, host port **8250**). Serwis: `services/kb-site/` (nginx:alpine na PIHA, host port **8250**).
Generator: `scripts/kb/gen_pages.py`. Publiczny adres: `https://kb.okit.pl`. Generator: `scripts/kb/gen_pages.py`. Publiczny adres: `https://kb-e2a24af3.okit.pl`.
Kolejność ma znaczenie: **DNS → NPM host → cert**. Certyfikat Let's Encrypt Kolejność ma znaczenie: **DNS → NPM host → cert**. Certyfikat Let's Encrypt
leci challenge'em HTTP-01, więc rekord A musi już wskazywać na łącze domowe, leci challenge'em HTTP-01, więc rekord A musi już wskazywać na łącze domowe,
@ -57,7 +57,7 @@ docker volume ls | grep kb-site # kb-site_kb-site_content
Generujemy w checkoucie repo, na węźle z którego pracujesz — nie na PIHA. Generujemy w checkoucie repo, na węźle z którego pracujesz — nie na PIHA.
```bash ```bash
python3 scripts/kb/gen_pages.py --base-url https://kb.okit.pl python3 scripts/kb/gen_pages.py --base-url https://kb-e2a24af3.okit.pl
python3 scripts/kb/gen_pages.py --check python3 scripts/kb/gen_pages.py --check
echo $? # 0 = czysto, 1 = trafienia echo $? # 0 = czysto, 1 = trafienia
``` ```
@ -130,7 +130,7 @@ curl -sI http://192.168.31.5:8250/index.html | head -1
``` ```
Type: A Type: A
Name: kb Name: kb-e2a24af3
Content: <publiczny IP łącza domowego> # ten sam, co ma vikunja.okit.pl Content: <publiczny IP łącza domowego> # ten sam, co ma vikunja.okit.pl
Proxy: DNS only (szara chmurka) Proxy: DNS only (szara chmurka)
TTL: Auto TTL: Auto
@ -144,13 +144,13 @@ a nie na krawędź Cloudflare. Włączenie proxy to osobna decyzja, po tym jak c
już działa. już działa.
Split-horizon (patrz `kb/phases/okit-cloudflare.md`): w Pi-hole na PIHA dodaj Split-horizon (patrz `kb/phases/okit-cloudflare.md`): w Pi-hole na PIHA dodaj
Local DNS Record `kb.okit.pl → 192.168.31.5`, żeby klienci w LAN szli prosto do Local DNS Record `kb-e2a24af3.okit.pl → 192.168.31.5`, żeby klienci w LAN szli prosto do
npm, a nie przez hairpin NAT na routerze. npm, a nie przez hairpin NAT na routerze.
Sprawdzenie propagacji (z hosta poza LAN albo przez publiczny resolver): Sprawdzenie propagacji (z hosta poza LAN albo przez publiczny resolver):
```bash ```bash
dig +short kb.okit.pl @1.1.1.1 dig +short kb-e2a24af3.okit.pl @1.1.1.1
``` ```
--- ---
@ -161,15 +161,15 @@ Wszystkie komendy `npm_api.py` są **dry-run domyślnie**; realna zmiana dopiero
z `--apply`. Puść najpierw bez `--apply` i przeczytaj payload. z `--apply`. Puść najpierw bez `--apply` i przeczytaj payload.
```bash ```bash
# 5a. host: kb.okit.pl -> PIHA:8250 # 5a. host: kb-e2a24af3.okit.pl -> PIHA:8250
python3 scripts/npm/npm_api.py --npm piha create-host \ python3 scripts/npm/npm_api.py --npm piha create-host \
--domain kb.okit.pl \ --domain kb-e2a24af3.okit.pl \
--forward-host 192.168.31.5 --forward-port 8250 \ --forward-host 192.168.31.5 --forward-port 8250 \
--block-exploits --http2-support --block-exploits --http2-support
# ...i to samo z --apply # ...i to samo z --apply
# 5b. cert Let's Encrypt (HTTP-01 — wymaga działającego kroku 4 i 5a) # 5b. cert Let's Encrypt (HTTP-01 — wymaga działającego kroku 4 i 5a)
python3 scripts/npm/npm_api.py --npm piha create-cert --domain kb.okit.pl --apply python3 scripts/npm/npm_api.py --npm piha create-cert --domain kb-e2a24af3.okit.pl --apply
# 5c. podepnij cert pod host i wymuś HTTPS # 5c. podepnij cert pod host i wymuś HTTPS
python3 scripts/npm/npm_api.py --npm piha list-hosts # weź HOST_ID python3 scripts/npm/npm_api.py --npm piha list-hosts # weź HOST_ID
@ -190,12 +190,12 @@ wiersz certyfikatu (szczegóły w `kb/runbooks/npm-api.md`).
## 6. Weryfikacja końcowa ## 6. Weryfikacja końcowa
```bash ```bash
curl -sI https://kb.okit.pl/ | head -1 # 200 curl -sI https://kb-e2a24af3.okit.pl/ | head -1 # 200
curl -s https://kb.okit.pl/ | grep -c 'class="cards"' # spis jest curl -s https://kb-e2a24af3.okit.pl/ | grep -c 'class="cards"' # spis jest
curl -s https://kb.okit.pl/subsystems/observer.html | tail -5 # stopka: data + commit curl -s https://kb-e2a24af3.okit.pl/subsystems/observer.html | tail -5 # stopka: data + commit
``` ```
W przeglądarce: `https://kb.okit.pl` — spis pogrupowany per type, kłódka bez W przeglądarce: `https://kb-e2a24af3.okit.pl` — spis pogrupowany per type, kłódka bez
ostrzeżeń, wejście w dowolną kartę, powrót linkiem „All documents". ostrzeżeń, wejście w dowolną kartę, powrót linkiem „All documents".
Kontrola treści (ręczna, jednorazowa po pierwszej publikacji): przejrzyj spis Kontrola treści (ręczna, jednorazowa po pierwszej publikacji): przejrzyj spis
@ -209,7 +209,7 @@ pilnuje pola `visibility`, ale to człowiek decyduje, co dostaje `public`.
Po każdej zmianie w `kb/**/*.md`, która dotyczy dokumentów `public`: Po każdej zmianie w `kb/**/*.md`, która dotyczy dokumentów `public`:
```bash ```bash
python3 scripts/kb/gen_pages.py --base-url https://kb.okit.pl \ python3 scripts/kb/gen_pages.py --base-url https://kb-e2a24af3.okit.pl \
&& python3 scripts/kb/gen_pages.py --check \ && python3 scripts/kb/gen_pages.py --check \
&& tar -czf /tmp/kb-site.tgz -C build/kb-site . \ && tar -czf /tmp/kb-site.tgz -C build/kb-site . \
&& scp /tmp/kb-site.tgz piha:/tmp/kb-site.tgz \ && scp /tmp/kb-site.tgz piha:/tmp/kb-site.tgz \

View file

@ -1,6 +1,6 @@
# kb-site # 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. 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ć ## Sieć
@ -15,7 +15,7 @@ Warunek wstępny deployu — sieć musi już istnieć na hoście:
docker network ls | grep -w proxy # brak wyniku => docker network create proxy 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 Ruch publiczny i tak nie idzie przez tę sieć: npm@PIHA (vhost `kb-e2a24af3.okit.pl`) trafia
do kontenera po opublikowanym porcie hosta `8250`. do kontenera po opublikowanym porcie hosta `8250`.
Dokumentacja: [kb/services/kb-site.md](../../kb/services/kb-site.md) Dokumentacja: [kb/services/kb-site.md](../../kb/services/kb-site.md)

View file

@ -7,7 +7,7 @@ services:
# PIHA 82x0 static-HTTP block: 8210 paperless, 8220 nextcloud, # PIHA 82x0 static-HTTP block: 8210 paperless, 8220 nextcloud,
# 8230 kb-query, 8240 narty27 -> 8250 is the next free slot. # 8230 kb-query, 8240 narty27 -> 8250 is the next free slot.
# Publicly the site is reached only through the npm@PIHA vhost # Publicly the site is reached only through the npm@PIHA vhost
# kb.okit.pl; this bind is the proxy's upstream. # kb-e2a24af3.okit.pl; this bind is the proxy's upstream.
- "8250:80" - "8250:80"
volumes: volumes:
# Generated output of scripts/kb/gen_pages.py — never committed, never # Generated output of scripts/kb/gen_pages.py — never committed, never

View file

@ -7,4 +7,4 @@
# copy to .env. # copy to .env.
# #
# The public address is a generator argument, not an env var: # The public address is a generator argument, not an env var:
# python3 scripts/kb/gen_pages.py --base-url https://kb.okit.pl # python3 scripts/kb/gen_pages.py --base-url https://kb-e2a24af3.okit.pl

View file

@ -2,7 +2,7 @@ service:
name: kb-site name: kb-site
owner_node: piha owner_node: piha
role: static-html-host # public slice of the KB, rendered by scripts/kb/gen_pages.py role: static-html-host # public slice of the KB, rendered by scripts/kb/gen_pages.py
exposure: public # public via npm@PIHA (kb.okit.pl). The container itself binds exposure: public # public via npm@PIHA (kb-e2a24af3.okit.pl). The container itself binds
# 8250 on the LAN; npm is the sole public entry point. # 8250 on the LAN; npm is the sole public entry point.
dependencies: [] # nginx serving a local volume — nothing else required at runtime dependencies: [] # nginx serving a local volume — nothing else required at runtime
ports: ports: