Compare commits
3 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 gitea
|
34947f8871 | ||
|
gitea
|
4ae06364d6 | ||
|
gitea
|
ddec1ee5a7 |
@@ -1,188 +0,0 @@
|
||||
# astroklient-demo — wdrożenie wersji demo (PRE-28/29)
|
||||
|
||||
Osobna usługa o dwóch funkcjach: **dodanie pliku bazy** i **zapytanie o
|
||||
interpretację urodzeniową**. Opis aplikacji: `services/astroklient-demo/README.md`
|
||||
w repo aplikacji.
|
||||
|
||||
---
|
||||
|
||||
## Jak to jest odizolowane
|
||||
|
||||
```
|
||||
astroklient-demo → logic-demo → data-demo → /mnt/Tank1/astrololo-demo
|
||||
└── klientA/ ← pula konta
|
||||
└── klientB/ ← pula konta
|
||||
```
|
||||
|
||||
**Oryginalne bazy są dla demo nieosiągalne.** Nie chodzi o uprawnienia: demo ma
|
||||
własną warstwę danych, pracującą na osobnym udziale, pustym na starcie.
|
||||
|
||||
Dlaczego osobna jest też **warstwa logiczna**: zna ona jeden adres warstwy danych,
|
||||
więc astroklient-demo korzystający z produkcyjnej logiki i tak trafiłby na produkcyjne
|
||||
bazy. Izolacja musi sięgnąć obu warstw naraz, inaczej nie ma jej wcale.
|
||||
|
||||
**Każde konto ma własną pulę** — swój podkatalog na tym udziale. Konta nie widzą
|
||||
swoich plików nawzajem ani w liście, ani w wynikach wyszukiwania. Pula bierze się
|
||||
z **loginu zalogowanej osoby**, nigdy z pola formularza.
|
||||
|
||||
---
|
||||
|
||||
## Krok 1 — udział `astrololo-demo` na TrueNAS
|
||||
|
||||
Ta sama procedura co przy `astrololo-state`, więc jeśli tamten działa, ten też
|
||||
zadziała. Po SSH na NAS:
|
||||
|
||||
```bash
|
||||
sudo zfs create Tank1/astrololo-demo # albo: sudo mkdir -p /mnt/Tank1/astrololo-demo
|
||||
```
|
||||
|
||||
```bash
|
||||
midclt call sharing.nfs.query '[["path","=","/mnt/Tank1/astrololo-demo"]]' \
|
||||
| python3 -m json.tool
|
||||
```
|
||||
|
||||
**Pusta lista `[]`** — twórz:
|
||||
|
||||
```bash
|
||||
midclt call sharing.nfs.create '{
|
||||
"path": "/mnt/Tank1/astrololo-demo",
|
||||
"comment": "astrololo — pule kont wersji demo (PRE-29)",
|
||||
"hosts": ["192.168.1.73", "192.168.1.80", "192.168.1.81"],
|
||||
"enabled": true,
|
||||
"ro": false,
|
||||
"mapall_user": "root",
|
||||
"mapall_group": "root"
|
||||
}'
|
||||
```
|
||||
|
||||
**Coś zwróciło** — weź `id` i użyj `sharing.nfs.update <ID>` z tą samą treścią.
|
||||
|
||||
```bash
|
||||
midclt call service.restart nfs
|
||||
sudo exportfs -v | grep astrololo-demo
|
||||
```
|
||||
|
||||
Musi tam być `rw`. Sprawdź jeszcze zapis z węzła — to jest ten test, którego
|
||||
zabrakło przy poprzednim udziale:
|
||||
|
||||
```bash
|
||||
ssh <węzeł> 'sudo mkdir -p /mnt/t && sudo mount -t nfs 192.168.1.34:/mnt/Tank1/astrololo-demo /mnt/t \
|
||||
&& sudo touch /mnt/t/proba && echo ZAPIS-OK || echo ZAPIS-NIE; sudo rm -f /mnt/t/proba; sudo umount /mnt/t'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Krok 2 — konta demo
|
||||
|
||||
Każde konto to osobna pula, więc **rozdajesz konta, nie jedno hasło**.
|
||||
|
||||
Hasła najlepiej jako hash — wtedy nie leżą nigdzie jawnie (skrypt jest w repo
|
||||
aplikacji, `services/presentation/scripts/make_user.py`):
|
||||
|
||||
```bash
|
||||
python scripts/make_user.py klientA # wypisze: scrypt$…
|
||||
python scripts/make_user.py klientB
|
||||
```
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo create secret generic astrololo-demo \
|
||||
--from-literal=DEMO_USERS='klientA:scrypt$…,klientB:scrypt$…' \
|
||||
--from-literal=SESSION_SECRET="$(openssl rand -hex 32)"
|
||||
```
|
||||
|
||||
`SESSION_SECRET` podpisuje ciasteczka sesji (LOG-34). **Pod bez niego celowo nie
|
||||
wstanie.** Jest WŁASNY, nie ten z pełnej aplikacji: demo i produkcja nie mają
|
||||
powodu uznawać nawzajem swoich sesji.
|
||||
|
||||
> **Zdalne unieważnienie w demo działa inaczej niż w pełnej wersji.** Demo nie ma
|
||||
> własnego wolumenu, więc nie ma gdzie trzymać licznika sesji. Zamiast tego:
|
||||
> usunięcie konta z `DEMO_USERS` albo zmiana jego hasła **natychmiast ubija jego
|
||||
> otwarte sesje** — bo odcisk poświadczenia wpisany w ciasteczko przestaje pasować.
|
||||
> Rotacja `SESSION_SECRET` wylogowuje wszystkich naraz.
|
||||
|
||||
### Dodanie konta później
|
||||
|
||||
```bash
|
||||
STARE=$(kubectl -n astrololo get secret astrololo-demo -o jsonpath='{.data.DEMO_USERS}' | base64 -d)
|
||||
|
||||
kubectl -n astrololo create secret generic astrololo-demo \
|
||||
--from-literal=DEMO_USERS="${STARE},klientC:scrypt\$…" \
|
||||
--dry-run=client -o yaml | kubectl apply -f -
|
||||
|
||||
kubectl -n astrololo rollout restart deploy/astroklient-demo
|
||||
```
|
||||
|
||||
### Odebranie dostępu
|
||||
|
||||
Usuń wpis z `DEMO_USERS` tą samą drogą. **Pula zostaje na udziale** — pliki
|
||||
klienta nie znikają, tylko przestaje być komu je pokazywać.
|
||||
|
||||
---
|
||||
|
||||
## Krok 3 — wdrożenie
|
||||
|
||||
```bash
|
||||
kubectl apply -k astrololo
|
||||
kubectl -n astrololo rollout status deploy/data-demo deploy/logic-demo deploy/astroklient-demo
|
||||
```
|
||||
|
||||
Sprawdzenie na czas jednej sesji, bez wystawiania na świat:
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo port-forward deploy/astroklient-demo 8005:8005
|
||||
```
|
||||
|
||||
Wejście z zewnątrz wymaga reguły w `ingress.yaml` — osobny host albo ścieżka.
|
||||
**Celowo nie zakładam tego za Ciebie**: to decyzja, pod jakim adresem świat
|
||||
zobaczy demo.
|
||||
|
||||
---
|
||||
|
||||
## Import puli klienta do pełnej aplikacji
|
||||
|
||||
Sedno całego układu: klient, który przechodzi na pełną wersję, **nie traci
|
||||
dotychczasowych wgrań**. Jego pula to jeden katalog.
|
||||
|
||||
**1. Zobacz, co tam jest** (na NAS):
|
||||
|
||||
```bash
|
||||
LOGIN=klientA
|
||||
sudo ls -la /mnt/Tank1/astrololo-demo/$LOGIN/
|
||||
```
|
||||
|
||||
**2. Sprawdź kolizje nazw** z bazami produkcyjnymi:
|
||||
|
||||
```bash
|
||||
comm -12 \
|
||||
<(cd /mnt/Tank1/astrololo-demo/$LOGIN && ls *.xlsx 2>/dev/null | sort) \
|
||||
<(cd /mnt/Tank1/astrololo && ls *.xlsx 2>/dev/null | sort)
|
||||
```
|
||||
|
||||
Pusto = brak kolizji. Cokolwiek się wypisze, przenieś ręcznie pod inną nazwą —
|
||||
**nie nadpisuj bazy produkcyjnej**.
|
||||
|
||||
**3. Skopiuj** (`-n` = nie nadpisuj niczego, co już jest):
|
||||
|
||||
```bash
|
||||
sudo cp -n /mnt/Tank1/astrololo-demo/$LOGIN/*.xlsx /mnt/Tank1/astrololo/
|
||||
```
|
||||
|
||||
> Kopiujemy **tylko pliki `.xlsx`**. Plik `.files-state.json` zostaje — opisuje
|
||||
> stan wewnątrz puli demo i w produkcji nie ma sensu; produkcja ma własny.
|
||||
|
||||
**4. Włącz je w pełnej aplikacji**: zakładka **Pliki**, nowe bazy pojawią się jako
|
||||
„gotowa, odstawiona". Klikasz przełącznik przy tych, które mają wejść do użytku.
|
||||
|
||||
To, że nie włączają się same, jest zamierzone: przeniesienie plików jest czynnością
|
||||
techniczną, a decyzja, które bazy biorą udział w interpretacji, należy do Ciebie.
|
||||
|
||||
---
|
||||
|
||||
## Odcięcie całego demo
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo scale deploy/astroklient-demo --replicas=0
|
||||
```
|
||||
|
||||
Pule i dane zostają. Skasowanie sekretu `astrololo-demo` zatrzyma pod (nie wstanie
|
||||
bez niego) i to też jest zachowanie zamierzone.
|
||||
@@ -1,133 +0,0 @@
|
||||
# Zarządzanie plikami baz — otwarcie udziału na zapis (DAN-27)
|
||||
|
||||
Ekran „Pliki" pozwala wgrywać bazy, archiwizować je i (dla administratora)
|
||||
kasować, a stan użycia jest **klikany**, więc musi być trwały. Wymaga to zapisu
|
||||
do udziału z bazami — a ten jest dziś wyeksportowany tylko do odczytu.
|
||||
|
||||
---
|
||||
|
||||
## Co świadomie tracimy
|
||||
|
||||
DAN-25 dawał gwarancję, że **baz nie da się zmienić przez NFS**. DAN-27 tę
|
||||
gwarancję z definicji znosi — nie da się mieć obu naraz.
|
||||
|
||||
**Co zostaje:**
|
||||
|
||||
| zabezpieczenie | działa nadal |
|
||||
|---|---|
|
||||
| eksport zawężony do trzech węzłów k8s | ✅ |
|
||||
| token międzywarstwowy | ✅ |
|
||||
| szyfrowane łącze prezentacja ↔ logika ↔ dane | ✅ |
|
||||
| kasowanie plików wyłącznie z konta administracyjnego (PRE-27) | ✅ |
|
||||
| dziennik audytowy (kto, kiedy, co) | ✅ |
|
||||
|
||||
Ryzyko, które przybywa: **przejęcie warstwy danych pozwala teraz nie tylko
|
||||
odczytać bazy, ale i je zmienić.**
|
||||
|
||||
---
|
||||
|
||||
## Krok 1 — otwórz udział na zapis
|
||||
|
||||
```bash
|
||||
midclt call sharing.nfs.query '[["path","=","/mnt/Tank1/astrololo"]]' \
|
||||
| python3 -c "import sys,json;[print(s['id'], '| ro:', s['ro'], '| mapall:', s.get('mapall_user')) for s in json.load(sys.stdin)]"
|
||||
```
|
||||
|
||||
Weź `id` i podstaw za `<ID>`:
|
||||
|
||||
```bash
|
||||
midclt call sharing.nfs.update <ID> '{"ro": false, "mapall_user": "root", "mapall_group": "root"}'
|
||||
```
|
||||
|
||||
> **Dlaczego `mapall_user`, skoro katalog ma `drwxrwxrwx`?** Samo `ro: false`
|
||||
> wystarczyłoby do zapisu — zmapowany `nobody` mieści się w prawach „innych".
|
||||
> Ale nowe pliki należałyby wtedy do `nobody`, a istniejące bazy do `root`.
|
||||
> Mieszana własność zemści się przy pierwszym zaostrzeniu praw. `mapall_user:
|
||||
> root` daje spójność i jest tym samym ustawieniem, co na udziale `astrololo-state`.
|
||||
|
||||
```bash
|
||||
midclt call service.restart nfs
|
||||
```
|
||||
|
||||
Sprawdź, że zmiana **faktycznie trafiła do jądra** — sama konfiguracja to za mało:
|
||||
|
||||
```bash
|
||||
sudo exportfs -v | grep -A1 "Tank1/astrololo "
|
||||
```
|
||||
|
||||
Przy `/mnt/Tank1/astrololo` musi być `rw`, nie `ro`.
|
||||
|
||||
---
|
||||
|
||||
## Krok 2 — zmerguj oba PR-y
|
||||
|
||||
* aplikacja: `feat/zarzadzanie-plikami`
|
||||
* deploy: `feat/pliki-zapis` (zdejmuje `readOnly` z montowania w podzie)
|
||||
|
||||
Bez tego drugiego pod nadal montuje udział tylko do odczytu, choćby serwer
|
||||
pozwalał pisać.
|
||||
|
||||
---
|
||||
|
||||
## Krok 3 — przeładuj warstwę danych PRZEZ ZERO REPLIK
|
||||
|
||||
> ⚠️ **`rollout restart` NIE WYSTARCZY.** Stary i nowy pod na chwilę
|
||||
> współistnieją, więc montowanie NFS ani na moment nie zostaje bez użytkownika
|
||||
> i nowy pod dziedziczy uprawnienia sprzed zmiany eksportu. To kosztowało
|
||||
> najwięcej czasu przy udziale `astrololo-state` — patrz
|
||||
> [README-stan-prezentacji.md](README-stan-prezentacji.md).
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo scale deploy/data --replicas=0
|
||||
kubectl -n astrololo wait --for=delete pod -l app=data --timeout=90s
|
||||
kubectl -n astrololo scale deploy/data --replicas=1
|
||||
kubectl -n astrololo rollout status deploy/data
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Krok 4 — sprawdź, w tej kolejności
|
||||
|
||||
**Czy warstwa danych może pisać:**
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo exec deploy/data -- sh -c 'touch /app/data_files/proba && echo ZAPIS-OK && rm /app/data_files/proba'
|
||||
```
|
||||
|
||||
**Czy powstał plik stanu i czy bazy zostały przyjęte jako aktywne:**
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo exec deploy/data -- sh -c 'cat /app/data_files/.files-state.json' | head -20
|
||||
```
|
||||
|
||||
Oczekiwane: każda baza ze `"status": "active"`. Przy pierwszym uruchomieniu bazy
|
||||
zastane na udziale są przyjmowane automatycznie — **bez tego wyszukiwanie
|
||||
przestałoby cokolwiek znajdować**, bo plik bez wpisu w rejestrze nie bierze
|
||||
udziału w wynikach.
|
||||
|
||||
**Czy wyszukiwanie NADAL DZIAŁA** — to jest najważniejszy sprawdzian tego
|
||||
wdrożenia, bo właśnie tu zmiana mogłaby przejść niezauważona:
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo logs deploy/data --tail=20
|
||||
```
|
||||
|
||||
a potem w przeglądarce: zakładka **Sygnifikatory**, dowolne wyszukanie. Musi
|
||||
zwracać wyniki jak przedtem. Jeśli nagle nic nie znajduje — zajrzyj do
|
||||
`.files-state.json` z komendy wyżej.
|
||||
|
||||
**Czy ekran „Pliki" działa:** zakładka **Pliki**, lista baz, przełącznik przy
|
||||
każdej. Wgraj testowy plik, zarchiwizuj go, skasuj.
|
||||
|
||||
---
|
||||
|
||||
## Odkręcenie
|
||||
|
||||
```bash
|
||||
midclt call sharing.nfs.update <ID> '{"ro": true, "mapall_user": null, "mapall_group": null}'
|
||||
midclt call service.restart nfs
|
||||
```
|
||||
|
||||
plus cofnięcie deploy `feat/pliki-zapis`. Ekran „Pliki" zostanie, ale wgrywanie
|
||||
i kasowanie przestaną działać — a stan użycia przestanie się zapisywać, więc bazy
|
||||
będą przyjmowane od nowa przy każdym starcie (czyli wszystkie aktywne).
|
||||
@@ -1,284 +0,0 @@
|
||||
# Postgres — lustro baz w SQL (DAN-28)
|
||||
|
||||
Runbook krok po kroku. Zakłada, że nie pamiętasz nic z rozmowy, w której to
|
||||
powstało.
|
||||
|
||||
---
|
||||
|
||||
## Co to jest — i czego to NIE jest
|
||||
|
||||
Postgres trzyma **lustro** plików Excela, żeby wyszukiwanie było szybsze i mądrzejsze.
|
||||
|
||||
> **ŹRÓDŁEM PRAWDY SĄ PLIKI EXCELA NA NFS.** Utrata tej bazy **nie jest utratą
|
||||
> danych** — odbudowuje się z plików. Dlatego kopie zapasowe Postgresa są tu
|
||||
> **opcjonalne**, a wolumen stoi na `local-path` zamiast na NFS.
|
||||
|
||||
Po co w ogóle Postgres, skoro danych jest mało (~54 tys. wierszy)? Nie dla skali —
|
||||
przy takim rozmiarze SQLite bywa szybszy. Dla **wyszukiwania w polskim,
|
||||
nieznormalizowanym tekście**: `pg_trgm` (dopasowanie mimo literówek) i `unaccent`
|
||||
(ogonki) nie mają w SQLite taniego zamiennika.
|
||||
|
||||
---
|
||||
|
||||
## Część 1 — co zrobiłem za Ciebie (w repo)
|
||||
|
||||
Nic z tego nie wymaga Twojej ręki, ale wiedz, co jest gdzie:
|
||||
|
||||
| plik | co w nim jest |
|
||||
|---|---|
|
||||
| `astrololo/postgres.yaml` | PVC (5 Gi, `local-path`), ConfigMap z SQL-em inicjalizującym, Deployment (`Recreate`), Service `ClusterIP` |
|
||||
| `astrololo/kustomization.yaml` | `postgres.yaml` dopisany **przed** `data.yaml` |
|
||||
| `astrololo/data.yaml` | `SQL_URL` z sekretu; `DATA_PROVIDER` **zostaje `excel`** |
|
||||
| repo aplikacji: `services/data/requirements.txt` | sterownik `psycopg[binary]` |
|
||||
|
||||
Decyzje, które w tych plikach zapadły — żeby nie trzeba było ich odtwarzać z głowy:
|
||||
|
||||
* **`local-path`, nie NFS.** Postgres zakłada semantykę blokad i `fsync`, której NFS
|
||||
nie gwarantuje — to klasyczne źródło uszkodzenia bazy przy nagłym restarcie.
|
||||
Ceną jest przywiązanie do węzła; przy luście odtwarzalnym z Excela to nie boli.
|
||||
* **`strategy: Recreate`.** Wolumen jest `ReadWriteOnce`, a dwa procesy Postgresa
|
||||
na jednym katalogu danych to uszkodzona baza. Rolling próbowałby wstać z nowym
|
||||
podem, zanim stary zejdzie.
|
||||
* **`PGDATA` w podkatalogu** (`…/data/pgdata`). Katalog główny wolumenu potrafi
|
||||
zawierać wpisy systemu plików, a `initdb` odmawia pracy w niepustym katalogu.
|
||||
* **Wersja przypięta (`postgres:17`) i POZA image-updaterem.** Podbicie majora
|
||||
wymaga migracji katalogu danych — nie może się zdarzyć samo, w nocy, przy okazji
|
||||
builda aplikacji.
|
||||
* **`DATA_PROVIDER` zostaje na `excel`.** Postgres można wdrożyć i obejrzeć **bez
|
||||
żadnego ryzyka** dla działającego wyszukiwania. Przełączenie na `sql` to osobna,
|
||||
późniejsza decyzja — po wdrożeniu lustra.
|
||||
|
||||
---
|
||||
|
||||
## Część 2 — co musisz zrobić Ty
|
||||
|
||||
### Krok 0. Sprawdź, że klaster ma `local-path`
|
||||
|
||||
```bash
|
||||
kubectl get storageclass
|
||||
```
|
||||
|
||||
Oczekiwany wynik: linia z `local-path` i dopiskiem `(default)`. W k3s jest
|
||||
domyślnie. **Jeśli jej nie ma — zatrzymaj się tutaj** i daj znać; bez niej PVC
|
||||
zawiśnie w `Pending`.
|
||||
|
||||
### Krok 1. Utwórz sekret `astrololo-postgres`
|
||||
|
||||
Ta sama konwencja co `astrololo-auth`: **sekretu nie ma w repo**, bo to repo
|
||||
GitOps i cokolwiek by tu wpadło, zostałoby w historii gita na zawsze.
|
||||
|
||||
```bash
|
||||
PGPASS="$(openssl rand -base64 24 | tr -d '/+=' | head -c 32)"
|
||||
|
||||
kubectl -n astrololo create secret generic astrololo-postgres \
|
||||
--from-literal=POSTGRES_PASSWORD="$PGPASS" \
|
||||
--from-literal=SQL_URL="postgresql+psycopg://astrololo:${PGPASS}@postgres:5432/astrololo"
|
||||
|
||||
unset PGPASS
|
||||
```
|
||||
|
||||
Hasła **nie musisz nigdzie zapisywać ani nigdy oglądać** — używają go tylko usługi
|
||||
między sobą. Gdybyś kiedyś go potrzebował:
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo get secret astrololo-postgres \
|
||||
-o jsonpath='{.data.POSTGRES_PASSWORD}' | base64 -d; echo
|
||||
```
|
||||
|
||||
> **Dlaczego dwa klucze, skoro hasło jest w obu?** `POSTGRES_PASSWORD` czyta sam
|
||||
> Postgres przy inicjalizacji, `SQL_URL` czyta warstwa danych. Rozdzielone, bo to
|
||||
> dwa różne formaty i dwóch różnych odbiorców — sklejanie DSN-a w manifeście
|
||||
> wymagałoby wstawienia tam hasła.
|
||||
|
||||
### Krok 2. Wdróż
|
||||
|
||||
Jeśli ArgoCD pilnuje katalogu `astrololo`, wystarczy **zmergować PR** — reszta
|
||||
zrobi się sama. Ręcznie:
|
||||
|
||||
```bash
|
||||
kubectl apply -k astrololo
|
||||
```
|
||||
|
||||
### Krok 3. Sprawdź, że wstało
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo rollout status deploy/postgres
|
||||
kubectl -n astrololo get pvc postgres-data
|
||||
```
|
||||
|
||||
Oczekiwane: `deployment "postgres" successfully rolled out` i PVC w stanie `Bound`.
|
||||
|
||||
### Krok 4. Sprawdź, że rozszerzenia się założyły
|
||||
|
||||
To jest **najważniejszy sprawdzian tego wdrożenia** — bez tych rozszerzeń cały
|
||||
sens stawiania Postgresa znika.
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo exec deploy/postgres -- \
|
||||
psql -U astrololo -d astrololo -c "\dx"
|
||||
```
|
||||
|
||||
Na liście muszą być **`pg_trgm`** i **`unaccent`**. Sprawdź też, że działają:
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo exec deploy/postgres -- psql -U astrololo -d astrololo -c \
|
||||
"SELECT unaccent('różdżka') AS bez_ogonkow,
|
||||
similarity(unaccent('różdżka'), 'rozdzka') AS po_zdjeciu_ogonkow,
|
||||
similarity('kowalski', 'kowlaski') > 0.3 AS literowka_lapana;"
|
||||
```
|
||||
|
||||
Oczekiwane **dokładnie**:
|
||||
|
||||
```
|
||||
bez_ogonkow | po_zdjeciu_ogonkow | literowka_lapana
|
||||
-------------+--------------------+------------------
|
||||
rozdzka | 1 | t
|
||||
```
|
||||
|
||||
Pierwsza kolumna pokazuje, że `unaccent` zna polskie znaki; druga, że po zdjęciu
|
||||
ogonków słowa są **identyczne** (stąd równo `1`); trzecia, że `pg_trgm` łapie
|
||||
przestawione litery. Jeśli druga kolumna nie jest równa `1`, rozszerzenia są, ale
|
||||
reguły `unaccent` nie obsługują polskich znaków — daj znać, bo to zmienia sposób
|
||||
budowania indeksów.
|
||||
|
||||
### Krok 5. Sprawdź, że warstwa danych ma połączenie
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo rollout restart deploy/data
|
||||
kubectl -n astrololo rollout status deploy/data
|
||||
kubectl -n astrololo logs deploy/data --tail=30 | grep -i -E "sql|postgres|error" || echo "brak wzmianek — OK"
|
||||
```
|
||||
|
||||
Na tym etapie warstwa danych **nadal czyta Excela** (`DATA_PROVIDER=excel`).
|
||||
Postgres tylko stoi i czeka. Aplikacja ma działać dokładnie jak przedtem —
|
||||
i to jest oczekiwany wynik tego wdrożenia.
|
||||
|
||||
---
|
||||
|
||||
## Część 3 — obsługa na co dzień
|
||||
|
||||
### Zajrzeć do bazy
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo exec -it deploy/postgres -- psql -U astrololo -d astrololo
|
||||
```
|
||||
|
||||
Przydatne w środku: `\dt mirror.*` (tabele lustra), `\dx` (rozszerzenia),
|
||||
`\l` (bazy), `\q` (wyjście).
|
||||
|
||||
### Podłączyć narzędzie graficzne z laptopa
|
||||
|
||||
Baza **celowo nie jest wystawiona poza klaster**. Na czas jednej sesji:
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo port-forward deploy/postgres 5432:5432
|
||||
```
|
||||
|
||||
i łączysz się na `localhost:5432`, użytkownik `astrololo`, baza `astrololo`,
|
||||
hasło jak w kroku 1. Po zamknięciu terminala tunel znika.
|
||||
|
||||
### Dodanie rozszerzenia do ISTNIEJĄCEJ bazy
|
||||
|
||||
> ⚠️ **Pułapka.** Skrypty z `/docker-entrypoint-initdb.d/` uruchamiają się
|
||||
> **wyłącznie przy pierwszej inicjalizacji**, na pustym katalogu danych. Dopisanie
|
||||
> rozszerzenia do ConfigMapy **nie zrobi nic**, jeśli baza już istnieje.
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo exec deploy/postgres -- \
|
||||
psql -U astrololo -d astrololo -c "CREATE EXTENSION IF NOT EXISTS nazwa;"
|
||||
```
|
||||
|
||||
### Kopia zapasowa (opcjonalna — patrz nagłówek)
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo exec deploy/postgres -- \
|
||||
pg_dump -U astrololo -d astrololo -Fc > astrololo-$(date +%F).dump
|
||||
```
|
||||
|
||||
Odtworzenie:
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo exec -i deploy/postgres -- \
|
||||
pg_restore -U astrololo -d astrololo --clean --if-exists < astrololo-2026-08-06.dump
|
||||
```
|
||||
|
||||
### Wyczyścić lustro i wczytać od nowa
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo exec deploy/postgres -- psql -U astrololo -d astrololo -c \
|
||||
"DROP SCHEMA mirror CASCADE; CREATE SCHEMA mirror;"
|
||||
```
|
||||
|
||||
Po tym warstwa danych odbuduje lustro z plików Excela (gdy lustro będzie już
|
||||
zaimplementowane — dziś ta komenda tylko czyści pusty schemat).
|
||||
|
||||
### Podbicie wersji Postgresa
|
||||
|
||||
**Nie robi się tego przez zmianę tagu w manifeście.** Major wymaga migracji
|
||||
katalogu danych. Ponieważ to lustro:
|
||||
|
||||
1. `kubectl -n astrololo scale deploy/data --replicas=0`
|
||||
2. skasuj Deployment i **PVC** (`kubectl -n astrololo delete deploy/postgres pvc/postgres-data`)
|
||||
3. zmień tag obrazu w `postgres.yaml`, wdróż ponownie
|
||||
4. `kubectl -n astrololo scale deploy/data --replicas=1` — lustro odbuduje się z Excela
|
||||
|
||||
To jest właśnie ta sytuacja, w której „lustro, nie źródło prawdy" oszczędza dzień
|
||||
pracy.
|
||||
|
||||
---
|
||||
|
||||
## Co zostało sprawdzone przed oddaniem, a co nie
|
||||
|
||||
**Sprawdzone:** `kubectl kustomize astrololo` składa komplet 21 zasobów bez błędu;
|
||||
YAML wszystkich manifestów parsuje się poprawnie; audyt odwołań do sekretów
|
||||
potwierdza, że jedyne brakujące to `astrololo-postgres` (oba klucze); DSN
|
||||
`postgresql+psycopg://…` jest poprawnie rozpoznawany przez SQLAlchemy 2.0
|
||||
z zainstalowanym `psycopg` 3.
|
||||
|
||||
**NIE sprawdzone, bo nie było na czym:** skrypt inicjalizujący nie został
|
||||
uruchomiony przeciwko prawdziwemu Postgresowi (na maszynie, na której to
|
||||
powstawało, nie ma Dockera). Składnia jest prosta i przejrzana, ale **krok 4 jest
|
||||
tu prawdziwym testem** — jeśli coś ma nie zadziałać, to właśnie tam.
|
||||
|
||||
---
|
||||
|
||||
## Część 4 — typowe problemy
|
||||
|
||||
| objaw | przyczyna | co zrobić |
|
||||
|---|---|---|
|
||||
| PVC wisi w `Pending` | brak `local-path` albo brak miejsca na węźle | `kubectl get storageclass`, `kubectl describe pvc postgres-data` |
|
||||
| pod w `CrashLoopBackOff`, w logach `directory not empty` | `PGDATA` wskazuje katalog główny wolumenu | sprawdź, czy `PGDATA` to `…/data/pgdata` (jest w manifeście) |
|
||||
| pod nie startuje, `secret not found` | nie wykonany krok 1 | utwórz sekret i `kubectl -n astrololo rollout restart deploy/postgres` |
|
||||
| `\dx` nie pokazuje `pg_trgm` | baza założona przed dodaniem ConfigMapy | patrz „Dodanie rozszerzenia do istniejącej bazy" |
|
||||
| warstwa danych: `ModuleNotFoundError: psycopg` | obraz zbudowany przed dodaniem sterownika | poczekaj na build z CI albo `kubectl -n astrololo rollout restart deploy/data` po nowym obrazie |
|
||||
| `password authentication failed` | `SQL_URL` w sekrecie nie zgadza się z `POSTGRES_PASSWORD` | odtwórz sekret krokiem 1 (oba klucze naraz) i zrestartuj **oba** deploymenty |
|
||||
|
||||
Gdy nic nie pasuje — pierwsze dwie komendy do wklejenia:
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo describe pod -l app=postgres | tail -30
|
||||
kubectl -n astrololo logs deploy/postgres --tail=50
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Część 5 — pełne odtworzenie ręczne, bez ArgoCD i bez repo
|
||||
|
||||
Gdyby trzeba było postawić to od zera na czystym klastrze:
|
||||
|
||||
```bash
|
||||
kubectl create namespace astrololo
|
||||
|
||||
PGPASS="$(openssl rand -base64 24 | tr -d '/+=' | head -c 32)"
|
||||
kubectl -n astrololo create secret generic astrololo-postgres \
|
||||
--from-literal=POSTGRES_PASSWORD="$PGPASS" \
|
||||
--from-literal=SQL_URL="postgresql+psycopg://astrololo:${PGPASS}@postgres:5432/astrololo"
|
||||
unset PGPASS
|
||||
|
||||
kubectl apply -f astrololo/postgres.yaml
|
||||
kubectl -n astrololo rollout status deploy/postgres
|
||||
kubectl -n astrololo exec deploy/postgres -- psql -U astrololo -d astrololo -c "\dx"
|
||||
```
|
||||
|
||||
Reszta aplikacji wymaga jeszcze sekretów `astrololo-auth` i `astrololo-link` —
|
||||
patrz [README.md](README.md).
|
||||
@@ -44,46 +44,116 @@ Jeśli `Tank1` nie jest pulą ZFS albo wolisz zwykły katalog:
|
||||
sudo mkdir -p /mnt/Tank1/astrololo-state
|
||||
```
|
||||
|
||||
### Właściciel i prawa
|
||||
### Właściciel i prawa — TU JEST NAJCZĘSTSZY BŁĄD
|
||||
|
||||
Kontenery aplikacji działają **jako root**, a eksport ma `root_squash`, więc root
|
||||
z klienta NIE jest rootem na udziale. Żeby zapis działał, przypinamy cały ruch
|
||||
z tych hostów do jednego, nieuprzywilejowanego użytkownika — to bezpieczniejsze
|
||||
niż `no_root_squash`, bo nie oddaje roota.
|
||||
Kontenery aplikacji działają **jako root** (`uid=0`), a NFS domyślnie stosuje
|
||||
**`root_squash`**: root z klienta NIE jest rootem na udziale — ląduje jako
|
||||
`nobody`. Świeży dataset ma prawa `drwxrwx--- root root`, czyli **nic dla
|
||||
„innych"** — i dlatego zapis odbija się o `Permission denied`, mimo że `ls`
|
||||
w podzie pokazuje `root root`.
|
||||
|
||||
To myli, bo `ls` pokazuje właściciela KATALOGU, a nie to, kim jest dla serwera
|
||||
proces, który próbuje pisać.
|
||||
|
||||
Do wyboru dwa rozwiązania. Oba trzeba ustawić **przy eksporcie** (niżej), tu
|
||||
tylko przygotowujemy katalog.
|
||||
|
||||
**A. Prościej — bez zakładania użytkownika.** Katalog zostaje `root:root 770`,
|
||||
a przy eksporcie ustawiamy `mapall_user: "root"`. To wyłącza squash **dla tego
|
||||
jednego udziału**. Zasięg jest wąski: eksportowany jest wyłącznie ten katalog,
|
||||
montują go tylko trzy węzły k8s, leży w nim jeden plik. Nic nie trzeba robić —
|
||||
świeży dataset ma już właściwe prawa.
|
||||
|
||||
**B. Czyściej — dedykowany użytkownik.** Zakładasz w UI TrueNAS
|
||||
nieuprzywilejowanego użytkownika (np. `astrololo`), a potem:
|
||||
|
||||
```bash
|
||||
# użytkownik, na którego mapujemy (jeśli nie istnieje — utwórz w UI TrueNAS)
|
||||
sudo chown -R apps:apps /mnt/Tank1/astrololo-state
|
||||
sudo chown -R astrololo:astrololo /mnt/Tank1/astrololo-state
|
||||
sudo chmod 770 /mnt/Tank1/astrololo-state
|
||||
```
|
||||
|
||||
> Podstaw swojego użytkownika w miejsce `apps`. Sprawdzisz istniejących:
|
||||
i przy eksporcie podstawiasz go w `mapall_user`. Efekt ten sam, bez oddawania
|
||||
roota — kosztem jednego użytkownika więcej do pamiętania.
|
||||
|
||||
> Istniejących użytkowników sprawdzisz przez:
|
||||
> `midclt call user.query | python3 -c "import sys,json;[print(u['uid'], u['username']) for u in json.load(sys.stdin)]"`
|
||||
|
||||
> **Czego NIE robić:** `chmod 777`. Zadziała, ale uczyni katalog zapisywalnym dla
|
||||
> każdego lokalnego użytkownika NAS-a — a leżą tam hashe haseł, więc jest to plik
|
||||
> wrażliwszy niż same bazy Excela.
|
||||
|
||||
### Eksport NFS
|
||||
|
||||
> **Najpierw sprawdź, czy udziału już nie ma.** `sharing.nfs.create` odmawia
|
||||
> z komunikatem `Export conflict`, jeśli ten sam katalog jest już eksportowany —
|
||||
> wtedy trzeba go **zaktualizować**, nie tworzyć.
|
||||
|
||||
```bash
|
||||
midclt call sharing.nfs.query '[["path","=","/mnt/Tank1/astrololo-state"]]' \
|
||||
| python3 -m json.tool
|
||||
```
|
||||
|
||||
**Pusta lista `[]`** — udziału nie ma, twórz:
|
||||
|
||||
```bash
|
||||
midclt call sharing.nfs.create '{
|
||||
"path": "/mnt/Tank1/astrololo-state",
|
||||
"comment": "astrololo — stan prezentacji (konta PRE-27)",
|
||||
"hosts": ["192.168.1.73", "192.168.1.80", "192.168.1.81"],
|
||||
"enabled": true,
|
||||
"ro": false,
|
||||
"mapall_user": "apps",
|
||||
"mapall_group": "apps"
|
||||
"mapall_user": "root",
|
||||
"mapall_group": "root"
|
||||
}'
|
||||
```
|
||||
|
||||
**Coś zwróciło** — weź `id` z wyniku i zaktualizuj (podstaw `<ID>`):
|
||||
|
||||
```bash
|
||||
midclt call sharing.nfs.update <ID> '{
|
||||
"hosts": ["192.168.1.73", "192.168.1.80", "192.168.1.81"],
|
||||
"enabled": true,
|
||||
"ro": false,
|
||||
"mapall_user": "root",
|
||||
"mapall_group": "root"
|
||||
}'
|
||||
```
|
||||
|
||||
> Wybrałeś wariant B? Podstaw swojego użytkownika zamiast `root` w obu polach.
|
||||
|
||||
| ustawienie | po co |
|
||||
|---|---|
|
||||
| `hosts` zawężone | te same trzy węzły k8s co w DAN-25 — nikt inny nie zamontuje |
|
||||
| `ro: false` | **musi być zapisywalny**, inaczej konta się nie zapiszą |
|
||||
| `mapall_user` | cały ruch pisze jako jeden nieuprzywilejowany użytkownik, niezależnie od UID w kontenerze |
|
||||
| `mapall_user` | cały ruch z tych hostów pisze jako JEDEN użytkownik, niezależnie od UID w kontenerze — bez tego `root_squash` zamienia roota z poda na `nobody`, który nie ma praw do katalogu |
|
||||
|
||||
> Podstaw swoje adresy węzłów, jeśli się zmieniły. Aktualne:
|
||||
> `kubectl get nodes -o wide`
|
||||
|
||||
---
|
||||
|
||||
### Sprawdź, co serwer FAKTYCZNIE eksportuje
|
||||
|
||||
Konfiguracja udziału i stan eksportu to **dwie różne rzeczy**: zapisana
|
||||
konfiguracja nie znaczy, że usługa ją przeładowała. To jest prawda:
|
||||
|
||||
```bash
|
||||
sudo exportfs -v | grep -A1 astrololo
|
||||
```
|
||||
|
||||
Muszą być **dwa** wpisy: `/mnt/Tank1/astrololo` (z `ro`) oraz
|
||||
`/mnt/Tank1/astrololo-state` (z `rw`), oba z listą trzech węzłów.
|
||||
|
||||
Jeśli `astrololo-state` **nie ma na liście**, mimo że `sharing.nfs.query` go
|
||||
pokazuje — usługa nie przeładowała eksportów:
|
||||
|
||||
```bash
|
||||
midclt call service.restart nfs
|
||||
sudo exportfs -v | grep astrololo-state
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Krok 2 — sprawdź z węzła, ZANIM wdrożysz
|
||||
|
||||
To jest ten test, którego zabrakło za pierwszym razem:
|
||||
@@ -94,8 +164,18 @@ ssh 192.168.1.73 'sudo mount -t nfs 192.168.1.34:/mnt/Tank1/astrololo-state /mnt
|
||||
&& sudo rm /mnt/test/proba; sudo umount /mnt/test'
|
||||
```
|
||||
|
||||
Musi wypisać **`ZAPIS DZIAŁA`**. Jeśli zamiast tego widzisz `Permission denied` —
|
||||
wróć do praw katalogu i `mapall_user` w kroku 1.
|
||||
Musi wypisać **`ZAPIS DZIAŁA`**.
|
||||
|
||||
| co widzisz | co to znaczy |
|
||||
|---|---|
|
||||
| `Permission denied` przy `touch` | montowanie działa, brakuje praw — wróć do właściciela katalogu i `mapall_user` |
|
||||
| `access denied by server while mounting` | serwer nie wpuszcza w ogóle: sprawdź `exportfs -v` (czy eksport istnieje i przeładowany), `enabled: true` w udziale oraz czy adres węzła jest na liście `hosts` |
|
||||
| `No such file or directory` | katalog `/mnt/Tank1/astrololo-state` nie istnieje na NAS-ie |
|
||||
| montuje się tylko z `-o vers=3` | negocjacja wersji: dopisz `mountOptions` w manifeście albo włącz NFSv4 w `midclt call nfs.config` |
|
||||
|
||||
Adresy węzłów sprawdzisz przez `kubectl get nodes -o wide` — jeśli któryś się
|
||||
zmienił od czasu DAN-25, lista `hosts` jest nieaktualna i to wystarczy, żeby
|
||||
serwer odmówił.
|
||||
|
||||
---
|
||||
|
||||
@@ -117,6 +197,70 @@ Oczekiwane: plik `accounts.json`.
|
||||
|
||||
---
|
||||
|
||||
## Jeśli mimo wszystko `Permission denied`
|
||||
|
||||
Trzy komendy, w tej kolejności:
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo exec deploy/presentation -- sh -c 'id; ls -ld /app/state; touch /app/state/proba && echo ZAPIS-OK || echo ZAPIS-NIE'
|
||||
```
|
||||
|
||||
```bash
|
||||
midclt call sharing.nfs.query '[["path","=","/mnt/Tank1/astrololo-state"]]' \
|
||||
| python3 -c "import sys,json;[print('ro:', s['ro'], '| mapall:', s.get('mapall_user'), '| hosts:', s['hosts']) for s in json.load(sys.stdin)]"
|
||||
```
|
||||
|
||||
```bash
|
||||
sudo ls -ld /mnt/Tank1/astrololo-state
|
||||
```
|
||||
|
||||
Zestaw, który DZIAŁA: kontener jako `uid=0(root)`, udział z `ro: false`
|
||||
i `mapall: root`, katalog `drwxrwx--- root root`.
|
||||
|
||||
### ⚠️ Po zmianie eksportu `rollout restart` NIE WYSTARCZA
|
||||
|
||||
To kosztowało najwięcej czasu przy pierwszym wdrożeniu, więc zapisane wprost.
|
||||
|
||||
**Objaw:** eksport poprawiony, `service.restart nfs` wykonany, pod zrestartowany —
|
||||
a zapis z poda nadal odbija się o `Permission denied`. Przy czym **ręczne
|
||||
zamontowanie tego samego eksportu z tego samego węzła działa** i pozwala pisać.
|
||||
|
||||
**Co z tym zrobić:** doprowadzić do stanu, w którym ŻADEN pod nie trzyma tego
|
||||
montowania.
|
||||
|
||||
```bash
|
||||
kubectl -n astrololo scale deploy/presentation --replicas=0
|
||||
kubectl -n astrololo wait --for=delete pod -l app=presentation --timeout=90s
|
||||
kubectl -n astrololo scale deploy/presentation --replicas=1
|
||||
kubectl -n astrololo rollout status deploy/presentation
|
||||
```
|
||||
|
||||
`rollout restart` tego nie osiąga, bo stary i nowy pod na chwilę WSPÓŁISTNIEJĄ —
|
||||
w logu widać `1 old replicas are pending termination`. Montowanie ani na moment
|
||||
nie zostaje bez użytkownika. (W ArgoCD ten sam skutek daje `force delete` poda.)
|
||||
|
||||
**Dlaczego (hipoteza, nie potwierdzona u źródła):** jądro współdzieli strukturę
|
||||
montowania NFS między montowania tego samego eksportu na węźle, razem z cache
|
||||
odpowiedzi ACCESS. Nowy pod podpina się do żywego montowania i dziedziczy
|
||||
odpowiedź sprzed zmiany eksportu.
|
||||
|
||||
**Test, który rozstrzyga, czy winny jest serwer czy klient** — montaż ręczny
|
||||
z węzła, z pominięciem Kubernetesa:
|
||||
|
||||
```bash
|
||||
ssh <węzeł> 'sudo mkdir -p /mnt/t && sudo mount -t nfs 192.168.1.34:/mnt/Tank1/astrololo-state /mnt/t \
|
||||
&& sudo touch /mnt/t/proba && echo SERWER-OK || echo SERWER-NIE; sudo umount /mnt/t'
|
||||
```
|
||||
|
||||
`SERWER-OK` przy jednoczesnym `Permission denied` w podzie znaczy, że konfiguracja
|
||||
NAS-a jest dobra i **nie ma czego na nim poprawiać** — problem jest po stronie
|
||||
klienta.
|
||||
|
||||
Osobno pamiętaj: sama zmiana konfiguracji udziału nie przeładowuje eksportów.
|
||||
Po każdej zmianie `midclt call service.restart nfs`.
|
||||
|
||||
---
|
||||
|
||||
## Odkręcenie
|
||||
|
||||
```bash
|
||||
|
||||
+7
-12
@@ -23,20 +23,15 @@ Ten plik **celowo nie jest w `kustomization.yaml`**: resource stoi w ns `argocd`
|
||||
(poza namespace docelowym aplikacji), a to konfiguracja kontrolera, który wdraża tę
|
||||
aplikację — nakładamy go ręcznie, w repo trzymamy dla odtwarzalności i historii.
|
||||
|
||||
## Pliki baz — udział otwarty na zapis (DAN-27)
|
||||
## ⚠️ Udział `astrololo-state` — wymagany przez konta (PRE-27)
|
||||
|
||||
Runbook: **[README-pliki.md](README-pliki.md)**. Ekran „Pliki" wymaga zapisu do
|
||||
udziału z bazami, więc znosi gwarancję z DAN-25, że baz nie da się zmienić przez
|
||||
NFS. Co zostaje z zabezpieczeń i jak to wdrożyć — w runbooku.
|
||||
Pod `presentation` **nie wstanie bez niego** (`CreateContainerConfigError:
|
||||
failed to create subPath directory`). Osobny runbook:
|
||||
**[README-stan-prezentacji.md](README-stan-prezentacji.md)**.
|
||||
|
||||
## astroklient-demo — wersja demo (PRE-28)
|
||||
|
||||
Osobna usługa o dwóch funkcjach. Runbook: **[README-astroklient-demo.md](README-astroklient-demo.md)**.
|
||||
|
||||
Ma **własną warstwę logiczną i własną warstwę danych** na osobnym udziale
|
||||
`astrololo-demo` — oryginalne bazy są dla demo nieosiągalne. Każde konto demo ma
|
||||
własną, niewidoczną dla pozostałych pulę plików, a jego pulę da się później
|
||||
przenieść do pełnej aplikacji jako jeden katalog.
|
||||
Krótko: udział z bazami jest wyeksportowany `ro` (DAN-25), więc konta nie mogą tam
|
||||
mieszkać — dostają własny, mały udział `/mnt/Tank1/astrololo-state`, zapisywalny,
|
||||
zawężony do tych samych węzłów.
|
||||
|
||||
## ⚠️ Sekret `astrololo-auth` — utwórz PRZED wdrożeniem
|
||||
|
||||
|
||||
@@ -1,122 +0,0 @@
|
||||
# Warstwa danych i logiki WYŁĄCZNIE dla wersji demo (PRE-29).
|
||||
#
|
||||
# DLACZEGO OSOBNY KOMPLET, A NIE WSPÓŁDZIELONY. Warstwa logiczna zna JEDEN adres
|
||||
# warstwy danych, więc astroklient-demo korzystający z produkcyjnej logiki i tak trafiłby
|
||||
# na produkcyjne bazy. Izolacja demo musi więc sięgnąć obu warstw naraz, inaczej
|
||||
# nie ma jej wcale.
|
||||
#
|
||||
# Udział `astrololo-demo` jest PUSTY na starcie i nigdy nie zawiera oryginalnych
|
||||
# baz. Każde konto demo dostaje w nim własny podkatalog (pulę) — patrz PRE-29.
|
||||
---
|
||||
apiVersion: apps/v1
|
||||
kind: Deployment
|
||||
metadata:
|
||||
name: data-demo
|
||||
namespace: astrololo
|
||||
spec:
|
||||
replicas: 1
|
||||
selector:
|
||||
matchLabels: { app: data-demo }
|
||||
template:
|
||||
metadata:
|
||||
labels: { app: data-demo }
|
||||
spec:
|
||||
containers:
|
||||
- name: data
|
||||
# TEN SAM obraz co produkcja — różni się wyłącznie udziałem, na którym
|
||||
# pracuje. Osobny obraz oznaczałby drugi kod do utrzymania i pewność,
|
||||
# że kiedyś się rozjadą.
|
||||
image: gitea.czernobog.pl/gitea/astrololo-data:latest
|
||||
ports: [{ containerPort: 8002 }]
|
||||
env:
|
||||
- name: DATA_PROVIDER
|
||||
value: "excel"
|
||||
- name: EXCEL_DIR
|
||||
value: "/app/data_files"
|
||||
- name: CACHE_DIR
|
||||
value: "/app/.cache"
|
||||
- name: INTERNAL_TOKEN
|
||||
valueFrom:
|
||||
secretKeyRef: { name: astrololo-auth, key: INTERNAL_TOKEN }
|
||||
- name: LINK_KEY_LOGIC_DATA
|
||||
valueFrom:
|
||||
secretKeyRef: { name: astrololo-link, key: LINK_KEY_LOGIC_DATA }
|
||||
- name: LINK_ENCRYPTION_REQUIRED
|
||||
value: "true"
|
||||
volumeMounts:
|
||||
- name: cache
|
||||
mountPath: /app/.cache
|
||||
- name: demo
|
||||
mountPath: /app/data_files
|
||||
resources:
|
||||
requests: { cpu: "100m", memory: "256Mi" }
|
||||
limits: { cpu: "500m", memory: "512Mi" }
|
||||
volumes:
|
||||
- name: cache
|
||||
emptyDir: {}
|
||||
- name: demo
|
||||
nfs:
|
||||
server: 192.168.1.34
|
||||
# OSOBNY udział, pusty na starcie. NIE /mnt/Tank1/astrololo —
|
||||
# to jest cała istota izolacji demo.
|
||||
path: /mnt/Tank1/astrololo-demo
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
name: data-demo
|
||||
namespace: astrololo
|
||||
spec:
|
||||
type: ClusterIP
|
||||
selector: { app: data-demo }
|
||||
ports: [{ port: 8002, targetPort: 8002 }]
|
||||
---
|
||||
apiVersion: apps/v1
|
||||
kind: Deployment
|
||||
metadata:
|
||||
name: logic-demo
|
||||
namespace: astrololo
|
||||
spec:
|
||||
replicas: 1
|
||||
selector:
|
||||
matchLabels: { app: logic-demo }
|
||||
template:
|
||||
metadata:
|
||||
labels: { app: logic-demo }
|
||||
spec:
|
||||
containers:
|
||||
- name: logic
|
||||
image: gitea.czernobog.pl/gitea/astrololo-logic:latest
|
||||
ports: [{ containerPort: 8001 }]
|
||||
env:
|
||||
# JEDYNA różnica wobec produkcyjnej logiki — i zarazem cała izolacja.
|
||||
- name: DATA_URL
|
||||
value: "http://data-demo:8002"
|
||||
- name: EPHEMERIS_ENGINE
|
||||
value: "own"
|
||||
- name: INTERNAL_TOKEN
|
||||
valueFrom:
|
||||
secretKeyRef: { name: astrololo-auth, key: INTERNAL_TOKEN }
|
||||
- name: LINK_KEY_PRESENTATION_LOGIC
|
||||
valueFrom:
|
||||
secretKeyRef: { name: astrololo-link, key: LINK_KEY_PRESENTATION_LOGIC }
|
||||
- name: LINK_KEY_LOGIC_DATA
|
||||
valueFrom:
|
||||
secretKeyRef: { name: astrololo-link, key: LINK_KEY_LOGIC_DATA }
|
||||
- name: LINK_ENCRYPTION_REQUIRED
|
||||
value: "true"
|
||||
# Bez kluczy do modeli językowych. Astroklient nie umie o nie prosić,
|
||||
# więc ich tu nie ma — czego nie ma w podzie, tego nie wyniesie.
|
||||
resources:
|
||||
requests: { cpu: "100m", memory: "128Mi" }
|
||||
limits: { cpu: "500m", memory: "512Mi" }
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
name: logic-demo
|
||||
namespace: astrololo
|
||||
spec:
|
||||
type: ClusterIP
|
||||
selector: { app: logic-demo }
|
||||
ports: [{ port: 8001, targetPort: 8001 }]
|
||||
@@ -1,86 +0,0 @@
|
||||
# astroklient-demo — wersja demonstracyjna (PRE-28).
|
||||
#
|
||||
# Osobna usługa o DWÓCH funkcjach: dodanie pliku bazy i zapytanie o interpretację
|
||||
# urodzeniową. Pozostałe funkcje nie są tu ukryte — nie ma ich w obrazie.
|
||||
#
|
||||
# IZOLACJA (PRE-29): astroklient-demo ma WŁASNĄ warstwę logiczną i WŁASNĄ warstwę
|
||||
# danych (astroklient-demo-stack.yaml), pracujące na osobnym, pustym na starcie
|
||||
# udziale. Oryginalne bazy interpretacyjne są dla demo NIEOSIĄGALNE.
|
||||
#
|
||||
# Wewnątrz demo każde konto ma własną pulę plików — swój podkatalog na tym
|
||||
# udziale — niewidoczną dla pozostałych kont. Dzięki temu demo można rozdawać
|
||||
# szeroko, a pliki jednego klienta da się później przenieść do pełnej aplikacji
|
||||
# jako jeden katalog (patrz README-astroklient-demo.md).
|
||||
apiVersion: apps/v1
|
||||
kind: Deployment
|
||||
metadata:
|
||||
name: astroklient-demo
|
||||
namespace: astrololo
|
||||
spec:
|
||||
replicas: 1
|
||||
selector:
|
||||
matchLabels: { app: astroklient-demo }
|
||||
template:
|
||||
metadata:
|
||||
labels: { app: astroklient-demo }
|
||||
spec:
|
||||
containers:
|
||||
- name: astroklient-demo
|
||||
image: gitea.czernobog.pl/gitea/astrololo-astroklient-demo:latest
|
||||
ports: [{ containerPort: 8005 }]
|
||||
env:
|
||||
# WŁASNA warstwa logiczna, wskazująca na WŁASNĄ warstwę danych.
|
||||
# Wpisanie tu produkcyjnego `logic` cofnęłoby całą izolację demo
|
||||
# jednym słowem — dlatego stoi to tuż obok siebie w jednym pliku.
|
||||
- name: LOGIC_URL
|
||||
value: "http://logic-demo:8001"
|
||||
# Konto demo — WŁASNE, nie astrololo-auth. Sekret tworzony POZA repo
|
||||
# (jak pozostałe), patrz README-astroklient-demo.md.
|
||||
# KONTA DEMO — lista `login:sekret` po przecinku. Każde konto ma
|
||||
# WŁASNĄ, niewidoczną dla pozostałych pulę baz (PRE-29), więc jedno
|
||||
# wspólne konto oznaczałoby klientów oglądających swoje wgrania
|
||||
# nawzajem. Sekrety najlepiej jako hash scrypt.
|
||||
- name: DEMO_USERS
|
||||
valueFrom:
|
||||
secretKeyRef: { name: astrololo-demo, key: DEMO_USERS }
|
||||
# Token międzywarstwowy i klucz łącza — TE SAME co prezentacja:
|
||||
# demo nie jest furtką omijającą ochronę warstwy logicznej.
|
||||
- name: INTERNAL_TOKEN
|
||||
valueFrom:
|
||||
secretKeyRef: { name: astrololo-auth, key: INTERNAL_TOKEN }
|
||||
- name: LINK_KEY_PRESENTATION_LOGIC
|
||||
valueFrom:
|
||||
secretKeyRef: { name: astrololo-link, key: LINK_KEY_PRESENTATION_LOGIC }
|
||||
- name: LINK_ENCRYPTION_REQUIRED
|
||||
value: "true"
|
||||
# Klucz podpisu ciasteczek sesji (LOG-34). WYMAGANY — pod bez niego
|
||||
# celowo nie wstaje. WŁASNY, nie ten z pełnej aplikacji: demo i produkcja
|
||||
# nie mają powodu uznawać nawzajem swoich sesji, a wspólny klucz
|
||||
# znaczyłby, że sesja z demo bywa ważna tam, gdzie nie powinna.
|
||||
- name: SESSION_SECRET
|
||||
valueFrom:
|
||||
secretKeyRef: { name: astrololo-demo, key: SESSION_SECRET }
|
||||
# Za Ingressem bezpośrednim rozmówcą jest pod Traefika. Bez tego limit
|
||||
# liczyłby WSZYSTKICH do jednego wiadra i pierwsza osoba, która go
|
||||
# wyklika, odcięłaby pozostałe.
|
||||
- name: TRUST_PROXY
|
||||
value: "true"
|
||||
# Niższy niż w pełnej aplikacji: demo bywa udostępniane szerzej,
|
||||
# a każde zapytanie sięga do treści baz.
|
||||
- name: RATE_LIMIT_PER_MIN
|
||||
value: "60"
|
||||
resources:
|
||||
requests: { cpu: "50m", memory: "96Mi" }
|
||||
limits: { cpu: "300m", memory: "256Mi" }
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
name: astroklient-demo
|
||||
namespace: astrololo
|
||||
spec:
|
||||
# ClusterIP — wejście z zewnątrz wyłącznie przez Ingress po https, tak samo
|
||||
# jak prezentacja. Druga, nieszyfrowana droga byłaby obejściem PRE-16.
|
||||
type: ClusterIP
|
||||
selector: { app: astroklient-demo }
|
||||
ports: [{ port: 8005, targetPort: 8005 }]
|
||||
+1
-20
@@ -44,31 +44,12 @@ spec:
|
||||
# zdążyłby wypuścić zapytanie jawnym tekstem, zanim dostanie odmowę.
|
||||
- name: LINK_ENCRYPTION_REQUIRED
|
||||
value: "true"
|
||||
# Lustro baz w SQL (DAN-28). DSN w SEKRECIE, bo niesie hasło —
|
||||
# w manifeście zostałoby w historii gita na zawsze.
|
||||
#
|
||||
# Sam adres nie przełącza jeszcze warstwy na SQL: o tym decyduje
|
||||
# DATA_PROVIDER, które celowo zostaje na `excel`, dopóki lustro nie
|
||||
# jest zaimplementowane i sprawdzone. Dzięki temu Postgres można
|
||||
# wdrożyć i obejrzeć BEZ ryzyka dla działającego wyszukiwania.
|
||||
- name: SQL_URL
|
||||
valueFrom:
|
||||
secretKeyRef: { name: astrololo-postgres, key: SQL_URL }
|
||||
volumeMounts:
|
||||
- name: cache
|
||||
mountPath: /app/.cache
|
||||
# ZAPISYWALNY od DAN-27. Wcześniej read-only, bo warstwa danych tylko
|
||||
# czytała bazy — teraz ekran „Pliki" pozwala je wgrywać, archiwizować
|
||||
# i (dla administratora) kasować, a stan użycia jest KLIKANY, więc musi
|
||||
# przetrwać restart poda.
|
||||
#
|
||||
# ŚWIADOMY KOSZT: znika jedna warstwa obrony w głąb. Przejęcie warstwy
|
||||
# danych pozwala teraz nie tylko odczytać bazy, ale i je zmienić.
|
||||
# Zostaje reszta: token międzywarstwowy, szyfrowane łącze, ograniczenie
|
||||
# eksportu NFS do konkretnych hostów (DAN-25) i to, że kasować może
|
||||
# wyłącznie konto administracyjne (PRE-27).
|
||||
- name: excel
|
||||
mountPath: /app/data_files
|
||||
readOnly: true
|
||||
resources:
|
||||
requests: { cpu: "100m", memory: "256Mi" }
|
||||
limits: { cpu: "500m", memory: "512Mi" }
|
||||
|
||||
@@ -34,10 +34,6 @@ spec:
|
||||
imageName: gitea.czernobog.pl/gitea/astrololo-presentation
|
||||
- alias: render
|
||||
imageName: gitea.czernobog.pl/gitea/astrololo-render
|
||||
# Wersja demo (PRE-28). Obraz, którego nie ma na tej liście, NIGDY się nie
|
||||
# podbije, choćby CI go budowało — tak przez chwilę wisiał render na :latest.
|
||||
- alias: astroklient-demo
|
||||
imageName: gitea.czernobog.pl/gitea/astrololo-astroklient-demo
|
||||
commonUpdateSettings:
|
||||
updateStrategy: newest-build
|
||||
writeBackConfig:
|
||||
|
||||
@@ -2,23 +2,18 @@ apiVersion: kustomize.config.k8s.io/v1beta1
|
||||
kind: Kustomization
|
||||
resources:
|
||||
- namespace.yaml
|
||||
- postgres.yaml # lustro baz Excela w SQL (DAN-28) — sekret astrololo-postgres POZA repo
|
||||
- data.yaml
|
||||
- logic.yaml
|
||||
- presentation.yaml
|
||||
- astroklient-demo-stack.yaml # OSOBNA warstwa danych i logiki dla demo (PRE-29)
|
||||
- astroklient-demo.yaml # wersja demo (PRE-28) — sekret astrololo-demo POZA repo
|
||||
- render.yaml # składanie raportu PDF (PRE-24), osobny obraz z TeX Live
|
||||
- tls.yaml # certyfikat z własnego CA (wymaga cert-managera)
|
||||
- ingress.yaml # wejście po https + przekierowanie z http
|
||||
images:
|
||||
- name: gitea.czernobog.pl/gitea/astrololo-data
|
||||
newTag: ee3c515d
|
||||
newTag: baf4e0e3
|
||||
- name: gitea.czernobog.pl/gitea/astrololo-logic
|
||||
newTag: ee3c515d
|
||||
newTag: baf4e0e3
|
||||
- name: gitea.czernobog.pl/gitea/astrololo-render
|
||||
newTag: latest
|
||||
- name: gitea.czernobog.pl/gitea/astrololo-astroklient-demo
|
||||
newTag: latest
|
||||
newTag: aec3f843
|
||||
- name: gitea.czernobog.pl/gitea/astrololo-presentation
|
||||
newTag: ee3c515d
|
||||
newTag: a8339659
|
||||
|
||||
@@ -1,150 +0,0 @@
|
||||
# Postgres — lustro baz Excela w SQL (DAN-28).
|
||||
#
|
||||
# DLACZEGO POSTGRES, A NIE SQLITE. Nie ze względu na skalę: dzisiejszy zbiór to
|
||||
# ~54 tys. wierszy, przy których SQLite bywa szybszy. Powodem jest WYSZUKIWANIE
|
||||
# w nieznormalizowanym, polskim tekście — `pg_trgm` (dopasowanie rozmyte, literówki)
|
||||
# i `unaccent` (ogonki) nie mają w SQLite taniego zamiennika, a to jest główna
|
||||
# funkcja programu, nie dodatek. Drugi powód: `pg_advisory_lock` sprawia, że model
|
||||
# sesji z atomowym commitem przestaje zakładać „jedna replika na zawsze".
|
||||
#
|
||||
# TO LUSTRO, NIE ŹRÓDŁO PRAWDY. Źródłem są pliki Excela na NFS. Utrata tej bazy
|
||||
# NIE JEST utratą danych — odbudowuje się z plików. Dlatego kopie zapasowe są tu
|
||||
# OPCJONALNE, a wolumen może stać na local-path.
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: PersistentVolumeClaim
|
||||
metadata:
|
||||
name: postgres-data
|
||||
namespace: astrololo
|
||||
spec:
|
||||
accessModes: [ReadWriteOnce]
|
||||
# local-path (domyślny provisioner k3s), NIE NFS. Postgres zakłada semantykę
|
||||
# blokad i fsync, której NFS nie gwarantuje — to klasyczne źródło uszkodzenia
|
||||
# bazy przy nagłym restarcie. Ceną jest przywiązanie do węzła; przy luście
|
||||
# odtwarzalnym z Excela to akceptowalne.
|
||||
storageClassName: local-path
|
||||
resources:
|
||||
requests:
|
||||
storage: 5Gi
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: ConfigMap
|
||||
metadata:
|
||||
name: postgres-init
|
||||
namespace: astrololo
|
||||
data:
|
||||
# UWAGA: skrypty z /docker-entrypoint-initdb.d/ uruchamiają się WYŁĄCZNIE przy
|
||||
# pierwszej inicjalizacji, na pustym katalogu danych. Dopisanie tu rozszerzenia
|
||||
# PO utworzeniu bazy nic nie zrobi — trzeba je wtedy założyć ręcznie (patrz
|
||||
# README-postgres.md, sekcja „Dodanie rozszerzenia do istniejącej bazy").
|
||||
01-extensions.sql: |
|
||||
-- Dopasowanie rozmyte: similarity(), operator %, indeksy GIN po trigramach.
|
||||
-- To jest powód, dla którego stoi tu Postgres, a nie SQLite.
|
||||
CREATE EXTENSION IF NOT EXISTS pg_trgm;
|
||||
-- Zdejmowanie ogonków: „różdżka" ma się znaleźć na „rozdzka".
|
||||
CREATE EXTENSION IF NOT EXISTS unaccent;
|
||||
|
||||
-- Schemat na lustro. Osobny, żeby purge i odbudowa nie musiały ruszać
|
||||
-- niczego w `public` i żeby `DROP SCHEMA mirror CASCADE` był bezpiecznym
|
||||
-- „wyczyść wszystko i wczytaj od nowa".
|
||||
CREATE SCHEMA IF NOT EXISTS mirror;
|
||||
|
||||
-- Rejestr luster: co, z jakiego pliku, o jakim skrócie i kiedy wczytane.
|
||||
-- Zgodność pliku z tabelą poznajemy po sha256 — nazwa pliku nie wystarcza,
|
||||
-- bo treść potrafi się zmienić bez zmiany nazwy.
|
||||
CREATE TABLE IF NOT EXISTS mirror.registry (
|
||||
table_name text PRIMARY KEY,
|
||||
source_path text NOT NULL UNIQUE,
|
||||
sha256 text NOT NULL,
|
||||
row_count integer NOT NULL DEFAULT 0,
|
||||
loaded_at timestamptz NOT NULL DEFAULT now(),
|
||||
active boolean NOT NULL DEFAULT false
|
||||
);
|
||||
CREATE INDEX IF NOT EXISTS registry_active_idx ON mirror.registry (active);
|
||||
---
|
||||
apiVersion: apps/v1
|
||||
kind: Deployment
|
||||
metadata:
|
||||
name: postgres
|
||||
namespace: astrololo
|
||||
spec:
|
||||
replicas: 1
|
||||
# Recreate, NIE RollingUpdate: wolumen jest ReadWriteOnce, a dwa procesy
|
||||
# Postgresa na jednym katalogu danych to uszkodzona baza. Rolling próbowałby
|
||||
# wstać z nowym podem, zanim stary zejdzie.
|
||||
strategy:
|
||||
type: Recreate
|
||||
selector:
|
||||
matchLabels: { app: postgres }
|
||||
template:
|
||||
metadata:
|
||||
labels: { app: postgres }
|
||||
spec:
|
||||
containers:
|
||||
- name: postgres
|
||||
# Wersja PRZYPIĘTA i celowo poza image-updaterem: podbicie majora
|
||||
# Postgresa wymaga migracji katalogu danych, więc nie może się zdarzyć
|
||||
# samo, w nocy, przy okazji builda aplikacji.
|
||||
image: postgres:17
|
||||
ports: [{ containerPort: 5432, name: postgres }]
|
||||
env:
|
||||
- name: POSTGRES_DB
|
||||
value: astrololo
|
||||
- name: POSTGRES_USER
|
||||
value: astrololo
|
||||
- name: POSTGRES_PASSWORD
|
||||
valueFrom:
|
||||
secretKeyRef: { name: astrololo-postgres, key: POSTGRES_PASSWORD }
|
||||
# PGDATA w PODKATALOGU montowanego wolumenu. Katalog główny wolumenu
|
||||
# potrafi zawierać wpisy systemu plików (np. lost+found), a initdb
|
||||
# odmawia inicjalizacji w niepustym katalogu.
|
||||
- name: PGDATA
|
||||
value: /var/lib/postgresql/data/pgdata
|
||||
# C.UTF-8 zamiast pl_PL.UTF-8: dopasowanie tekstu robimy przez
|
||||
# unaccent i pg_trgm, nie przez collation, a locale pl_PL wymagałoby
|
||||
# obrazu z wygenerowanymi lokalizacjami. Gdyby kiedyś potrzebne było
|
||||
# polskie SORTOWANIE, dokłada się collation ICU na konkretnej kolumnie.
|
||||
- name: POSTGRES_INITDB_ARGS
|
||||
value: "--encoding=UTF8 --locale=C.UTF-8"
|
||||
volumeMounts:
|
||||
- name: data
|
||||
mountPath: /var/lib/postgresql/data
|
||||
- name: init
|
||||
mountPath: /docker-entrypoint-initdb.d
|
||||
readOnly: true
|
||||
# pg_isready, nie zwykły TCP: gniazdo słucha, zanim baza przyjmuje
|
||||
# zapytania, więc sonda po porcie przepuściłaby ruch za wcześnie.
|
||||
readinessProbe:
|
||||
exec:
|
||||
command: ["pg_isready", "-U", "astrololo", "-d", "astrololo", "-q"]
|
||||
initialDelaySeconds: 5
|
||||
periodSeconds: 5
|
||||
livenessProbe:
|
||||
exec:
|
||||
command: ["pg_isready", "-U", "astrololo", "-d", "astrololo", "-q"]
|
||||
initialDelaySeconds: 30
|
||||
periodSeconds: 20
|
||||
failureThreshold: 6
|
||||
resources:
|
||||
requests: { cpu: "100m", memory: "256Mi" }
|
||||
limits: { cpu: "1000m", memory: "1Gi" }
|
||||
volumes:
|
||||
- name: data
|
||||
persistentVolumeClaim:
|
||||
claimName: postgres-data
|
||||
- name: init
|
||||
configMap:
|
||||
name: postgres-init
|
||||
---
|
||||
apiVersion: v1
|
||||
kind: Service
|
||||
metadata:
|
||||
name: postgres
|
||||
namespace: astrololo
|
||||
spec:
|
||||
# ClusterIP i tylko ClusterIP. Baza nie ma żadnego powodu być widoczna poza
|
||||
# klastrem; dostęp z zewnątrz robi się przez `kubectl port-forward` na czas
|
||||
# jednej sesji (patrz README-postgres.md).
|
||||
type: ClusterIP
|
||||
selector: { app: postgres }
|
||||
ports: [{ port: 5432, targetPort: 5432 }]
|
||||
@@ -8,9 +8,9 @@ resources:
|
||||
- deploy-bot-backup.yaml
|
||||
images:
|
||||
- name: gitea.czernobog.pl/gitea/conjurer-librarian
|
||||
newTag: d0c7ab61
|
||||
newTag: ae1bd677
|
||||
- name: gitea.czernobog.pl/gitea/conjurer-bot
|
||||
newTag: d0c7ab61
|
||||
newTag: fbd1ec9f
|
||||
# Production bot channel - only bumped when a [deploy]-tagged build appears.
|
||||
# Bootstrapped to fbd1ec9f: that's the image the first [deploy] build (merge
|
||||
# of conjurer#20) promoted to conjurer-bot-deploy. From here the image-updater
|
||||
|
||||
Reference in New Issue
Block a user