﻿# Docker

> A Docker image a teljes alkalmazást (szervert és portált) futtatja a 8080-as porton, a nem root appuser felhasználóként (uid 1001). Az image az ASP.NET Core 10.0 futtatókörnyezetre épül Ubuntu 24.04 LTS-en, így a gépre nem kell .NET-et telepíteni.

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

A Docker image a teljes alkalmazást (szervert és portált) futtatja a 8080-as porton, a nem root `appuser` felhasználóként (uid 1001). Az image az ASP.NET Core 10.0 futtatókörnyezetre épül Ubuntu 24.04 LTS-en, így a gépre nem kell .NET-et telepíteni.

> **Teljes útmutató.** Az image elkészítése, a Linuxra és Windowsra készült indító és szolgáltatás-szkriptek, az összes beállítás és a hibaelhárítás a [WorkSmartHub-Docker-Kubernetes](https://workwise-solutions.net/hu/docs/installation/operator-guide/) repository üzemeltetői útmutatójában található ([Magyar](https://workwise-solutions.net/hu/docs/installation/operator-guide/), [English](https://workwise-solutions.net/docs/installation/operator-guide/)). Ez az oldal összefoglaló.

![WorkSmartHub Dockerben](https://workwise-solutions.net/docs/images/diagram-install-docker-hu.png)
*A konténer fordított proxy mögött a 8080-as porton figyel, és az állapotát a /app/data alatti kötetben tartja.*

## Az image

Nyilvános registry nincs: a `worksmarthub:<verzió>` image a forrásmappákból készül a `build/build-image.sh --version <n>` (vagy `build-image.ps1`) szkripttel, vagy a gépre töltik be a `docker load -i` paranccsal.

## Futtatás

Az üzemeltetői repository szkriptjeivel:

```bash
cd docker/linux
sh worksmarthub-run.sh --version 23 --detach
```

```powershell
cd docker\win
.\worksmarthub-run.ps1 -Version 23 -Detach
```

Szkriptek nélkül a lényeges parancs:

```bash
docker volume create worksmarthub-data
docker run -d --name worksmarthub --restart unless-stopped --stop-timeout 60 \
  -p 8080:8080 -e HttpSettings__Urls__0=http://+:8080 \
  --mount type=bind,source=/opt/worksmarthub/appsettings.json,target=/app/appsettings.json \
  -v worksmarthub-data:/app/data \
  worksmarthub:23
```

Ezután nyissa meg a `http://<gép>:8080/` címet, töltse fel a licencet, és hozza létre az első felhasználót ([Első lépések](https://workwise-solutions.net/hu/docs/getting-started/)).

| Kapcsoló | Szerepe |
|---|---|
| `-e HttpSettings__Urls__0=http://+:8080` | Minden hálózati interfészen figyel a konténer portján. Kötelező. |
| `-v worksmarthub-data:/app/data` | A megmaradó adatkötet. Nélküle a konténer törlésekor az adatok elvesznek. |
| `--mount ... appsettings.json` | A saját konfiguráció a gépről. A környezeti változók felülírják (`Szakasz__Kulcs`, például `ConnectionStrings__InternalDb`). |
| `--stop-timeout 60` | Időt ad az alkalmazásnak a háttérmunka befejezésére (45 mp) és az adatbázis lezárására. |
| `--restart unless-stopped` | Újraindítás összeomlás után és a Docker indulásakor. |

Rendszerinduláskori indításhoz elegendő az újraindítási szabály bekapcsolt Docker szolgáltatással, vagy telepítheti az üzemeltetői repository systemd szolgáltatását, illetve Windowson ütemezett feladatát. A konténer órája UTC szerint jár, így az **App Konfiguráció → Háttérfolyamatok** időpontjai is UTC-ben értendők.

## Mi van az adatkötetben

| Tartalom | Elérési út a köteten |
|---|---|
| SQLite adatbázis | `database.db`, `database.db-wal`, `database.db-shm` (mindig együtt másolja őket) |
| Szerverlemezes fájltároló | `FileStorage/` |
| Naplófájlok | `Logs/` |
| Élő e-mail és értesítési sablonok | `LiveEmailTemplates/`, `LiveNotificationTemplates/` |

Az `appsettings.json` nincs a köteten; arról külön készítsen mentést. Külső adatbázissal és felhős fájltárolóval a kötet csak a naplókat és a sablonokat tartalmazza.

## Az első éles használat előtt

Másolja ki az `appsettings.json` fájlt az image-ből, állítson be saját **aláíró kulcsokat** és `PublicBaseUrl` értéket, és tegye a fájlt csak a rendszergazdák és az 1001-es uid számára olvashatóvá ([Konfiguráció](https://workwise-solutions.net/hu/docs/installation/configuration/)). Fordított proxy mögött a proxynak kell beállítania az `X-Forwarded-Host` és `X-Forwarded-Proto` fejlécet, és el kell fogadnia a 25 MB-nál nagyobb kéréseket.

## Állapotellenőrzés

A `GET /health` bejelentkezés nélkül `200 {"status":"Healthy"}` választ ad. Az image-ben nincs `HEALTHCHECK` és nincs curl; az üzemeltetői útmutató egy `bash`-alapú ellenőrzést mutat Docker Compose-hoz.

## Frissítés, mentés, visszaállítás

Állítsa le és törölje a konténert, majd indítsa el az új image-et ugyanazzal a kötettel; a migrációk induláskor lefutnak. A kötetről leállított alkalmazás mellett készítsen mentést. A parancsok a [Frissítés, mentés és visszaállítás](https://workwise-solutions.net/hu/docs/installation/upgrade-backup-restore/#docker) oldalon vannak.
