Kubernetes
Ezen az oldalon
A WorkSmartHub Helm chartja (worksmarthub) a WorkSmartHub-Docker-Kubernetes repositoryban található. Az üzemeltetői útmutató (Magyar, English) tizenkét lépésben vezet végig a névtértől a licencig, és leírja a frissítést, a visszaállást, a környezetek közötti átköltözést, valamint egy élesítési ellenőrzőlistát is ad. Ez az oldal ennek összefoglalója.
Előfeltételek#
- Egy fürt (EKS, AKS, GKE, saját üzemeltetésű; teszteléshez minikube),
kubectl, Helm 3. - Az image olyan helyen, ahonnan a csomópontok le tudják tölteni (minikube-ba buildelve, a csomópontokra betöltve, vagy a saját registryben).
- Alapértelmezett StorageClass.
- Az ingress-nginx vezérlő a chart Ingress-éhez (vagy kapcsolja ki, és oldja meg saját maga az útválasztást).
Gyors kezdés#
bash build/build-image.sh --version 23 --minikube
helm install worksmarthub ./kubernetes-helm-chart --set app.image.tag=23
kubectl get pods -n worksmarthub -w
kubectl port-forward -n worksmarthub svc/worksmarthub 8080:80Alapbeállításokkal a chart a worksmarthub névtérbe telepít:
| Összetevő | Mi ez |
|---|---|
| Alkalmazás | Egy pod /health próbákkal, appsettings.json ConfigMapből, az adatkötet a /app/data alatt |
| Adatkötet | worksmarthub-data-claim PVC (5 Gi): fájltároló, naplók, sablonok, illetve SQLite, ha azt választja |
| PostgreSQL | Beépített postgres:16-alpine, ez a belső adatbázis |
| Redis | Beépített redis:7-alpine, ez a cache |
| Ingress | ingress-nginx-hez, feltöltési korlátokkal |
| NetworkPolicy-k | Csak a névtér podjai érhetik el az adatbázist és a Redist |
Változtassa meg a beépített adatbázis jelszavát, ha nem eldobható tesztről van szó: nyilvánosan ismert alapértékkel indul.
Éles üzem#
- Használjon külső adatbázist (ajánlott), vagy tartsa meg a beépített PostgreSQL-t saját jelszóval.
- Állítsa be az aláíró kulcsokat és a
PublicBaseUrlértékét, lehetőleg Kubernetes Secretből. - Válassza ki a környezetéhez illő Service típust és Ingress-t (TLS).
- Egynél több replikához: külső adatbázis, Redis vagy adatbázis-cache, és felhős fájltároló. Az induláskori migrációk zárolással futnak a replikák között, az ütemezett feladatok pedig alkalmanként csak egyszer futnak le.
- SQLite pontosan egy replikával használható.
Licenc#
A licencet az alkalmazásban (Licenc) vagy a POST /api/licensing/set hívással kell feltölteni; az adatbázisba kerül, így minden replika ugyanazt használja, és frissítés után is megmarad (Licenc).
Üzemeltetés#
helm upgrade worksmarthub ./kubernetes-helm-chart -f my-values.yaml --set app.image.tag=<új>
kubectl logs -n worksmarthub deploy/worksmarthub-deployment -c worksmarthub-container -fA beállításait tartsa egy saját values fájlban, és frissítéskor is ezt használja. Frissítés előtt mentse az adatbázist; visszalépni csak a mentés visszaállításával lehet, mert a migrációk nem fordíthatók vissza. Elszigetelt (air-gapped) fürtöknél másolja a saját registryjébe az image-eket (postgres, redis, busybox). A Pending állapotú podok, az image-letöltési hibák, az adatbázisjelszó-hibák és a 413-as feltöltési hibák elhárítása az üzemeltetői útmutatóban található.