﻿# Kubernetes

> 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…

Source: https://workwise-solutions.net/hu/docs/installation/kubernetes/ · Language: hu · English version: https://workwise-solutions.net/docs/installation/kubernetes/

A WorkSmartHub Helm chartja (`worksmarthub`) a [WorkSmartHub-Docker-Kubernetes](https://workwise-solutions.net/hu/docs/installation/operator-guide/) repositoryban található. Az üzemeltetői útmutató ([Magyar](https://workwise-solutions.net/hu/docs/installation/operator-guide/#kubernetes), [English](https://workwise-solutions.net/docs/installation/operator-guide/#kubernetes)) 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
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:80
```

Alapbeá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 |

![WorkSmartHub Kubernetesen, a Helm charttal](https://workwise-solutions.net/docs/images/diagram-install-kubernetes-hu.png)
*A chart által alapértékekkel létrehozott erőforrások.*

**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](https://workwise-solutions.net/hu/docs/features/licence/)).

## Üzemeltetés

```bash
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 -f
```

A 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ó.
