Telepítés Windowsra (IIS)
Ezen az oldalon
Az IIS a WorkSmartHub-ot folyamaton belül (in-process) futtatja: kezeli a folyamatot, és fordított proxyként is működik, így külön Windows-szolgáltatásra nincs szükség. Mivel a háttérfolyamatok a webes folyamatban futnak, az IIS-nek akkor is futva kell tartania ezt a folyamatot, amikor senki sem használja az oldalt.
1. Előfeltételek#
- Telepítse a Web Server (IIS) szerepkört az Application Development → Application Initialization szolgáltatással. A Security → Windows Authentication csak Active Directory-s bejelentkezéshez kell.
- Telepítse az ASP.NET Core 10.0 Hosting Bundle csomagot (a .NET hivatalos letöltőoldaláról, .NET 10.0, ASP.NET Core Runtime), majd futtassa az
iisresetparancsot. - Telepítse a Microsoft Visual C++ Redistributable (x64) csomagot. A licenckezelés erre épül; nélküle az alkalmazás induláskor
libsodiumhibát jelez. - Ellenőrizze a futtatókörnyezetet:
dotnet --info.
2. A fájlok másolása#
Másolja a kiadás (publish) mappájának tartalmát az oldal mappájába, például a C:\inetpub\wwwroot\WorkSmartHub mappába. A mappában közvetlenül kell lennie a WorkSmartHub.dll, a web.config, az appsettings.json fájlnak és a wwwroot mappának.
3. Alkalmazáskészlet#
Hozzon létre egy alkalmazáskészletet (application pool) .NET CLR version: No Managed Code és Integrated pipeline beállítással. Az Advanced Settings alatt:
| Beállítás | Érték | Miért |
|---|---|---|
| Start Mode | AlwaysRunning | Az IIS-szel együtt indul, nem az első kéréssel |
| Idle Time-out (minutes) | 0 | Az IIS tétlenség miatt soha nem állítja le a folyamatot |
| Identity | Egy erre a célra létrehozott szolgáltatásfiók | |
| Load User Profile | True | Egyes hitelesítési beállításokhoz kell |
| Regular Time Interval (minutes) | 0, vagy egy munkaidőn és a háttérfolyamatok idején kívüli időpont | Az újrahasznosítás (recycle) megszakítja a futó munkát |
Adjon Modify jogot az alkalmazáskészlet identitásának az oldal mappájára. Az alkalmazás ide ír: Logs\, az SQLite adatbázis (database.db a -wal és -shm fájlokkal), FileStorage\, az élő sablonok, valamint maga az appsettings.json (induláskor biztonsági másolat után hozzáadja az új kiadás által bevezetett beállításokat).
4. A webhely#
- Add Website: válassza ki az alkalmazáskészletet, az oldal mappáját és a kötést (binding).
- A webhely Advanced Settings ablakában: Preload Enabled: True.
- Az oldalt HTTPS-en szolgálja ki (a kötésen vagy egy terheléselosztón). Az előtte álló proxynak magának kell beállítania az
X-Forwarded-Protoés azX-Forwarded-Hostfejlécet. - Active Directory-s bejelentkezés (csak Windowson): a szervernek tartományba léptetettnek kell lennie; a webhelyen kapcsolja be az Anonymous Authentication és a Windows Authentication módot is. Sok csoportba tartozó felhasználóknál növelje meg a HTTP.sys fejléckorlátait (
MaxFieldLength65534,MaxRequestBytes16777216 aHKLM\System\CurrentControlSet\Services\HTTP\Parametersalatt), majd indítsa újra a gépet. - A
web.configfájlban adja hozzá azaspNetCoreelemhez ashutdownTimeLimit="60"attribútumot, hogy újrahasznosításkor az alkalmazásnak legyen ideje befejezni a munkáját (legfeljebb 45 másodpercre van szüksége). - Indítsa el az alkalmazáskészletet, és nyissa meg az oldalt. A
GET /health200-as választ ad, ha az alkalmazás fut.
5. Beállítás#
Szerkessze az oldal mappájában lévő appsettings.json fájlt: adatbázis, cache, felhasználói tár és bejelentkezés, aláíró kulcsok, PublicBaseUrl, e-mail, naplózás (Konfiguráció). IIS alatt a HttpSettings.Urls beállítást nem használja az alkalmazás; hagyja az alapértéken. Módosítás után hasznosítsa újra az alkalmazáskészletet.
A háttérfolyamatok a beállított időpontban, a szerver helyi ideje szerint futnak; az alkalmazáskészlet újrahasznosítása ne essen ezekre az időpontokra.
Frissítés#
- Ha az új kiadás újabb .NET verziót igényel, telepítse annak Hosting Bundle-jét, és futtassa az
iisresetparancsot. - Készítsen mentést az adatbázisról és az oldal mappájáról, majd állítsa le az alkalmazáskészletet.
- Tegye félre az
appsettings.jsonegy másolatát. - Másolja az új fájlokat az oldal mappájára, majd tegye vissza a saját
appsettings.jsonfájlját. A szerkesztett sablonok megmaradnak. - Indítsa el az alkalmazáskészletet. Az adatbázist az alkalmazás induláskor migrálja.
IIS nélkül#
Bármely Windows-szolgáltatás-burkoló (service wrapper) megfelel, amely az alkalmazás mappájában a dotnet WorkSmartHub.dll parancsot futtatja, egy localhost:5000 felé mutató fordított proxyval. A burkoló leállítási időkorlátja legalább 60 másodperc legyen, és automatikusan induljon. Active Directoryhoz az IIS ajánlott.
A teljes, lépésenkénti leírás a kiadás backend README-jében található.