Docker
Ezen az oldalon
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 repository üzemeltetői útmutatójában található (Magyar, English). Ez az oldal összefoglaló.
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:
cd docker/linux
sh worksmarthub-run.sh --version 23 --detachcd docker\win
.\worksmarthub-run.ps1 -Version 23 -DetachSzkriptek nélkül a lényeges parancs:
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:23Ezutá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).
| 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ó). 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 oldalon vannak.