Telepítés Windowsra (IIS)

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.

Az IIS folyamaton belül, folyamatosan futó alkalmazáskészletben futtatja az alkalmazást; az adatok a webhely mappájában vagy külső adatbázisban vannak.

1. Előfeltételek#

  1. 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.
  2. 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 iisreset parancsot.
  3. Telepítse a Microsoft Visual C++ Redistributable (x64) csomagot. A licenckezelés erre épül; nélküle az alkalmazás induláskor libsodium hibát jelez.
  4. 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#

  1. Add Website: válassza ki az alkalmazáskészletet, az oldal mappáját és a kötést (binding).
  2. A webhely Advanced Settings ablakában: Preload Enabled: True.
  3. 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 az X-Forwarded-Host fejlécet.
  4. 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 (MaxFieldLength 65534, MaxRequestBytes 16777216 a HKLM\System\CurrentControlSet\Services\HTTP\Parameters alatt), majd indítsa újra a gépet.
  5. A web.config fájlban adja hozzá az aspNetCore elemhez a shutdownTimeLimit="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).
  6. Indítsa el az alkalmazáskészletet, és nyissa meg az oldalt. A GET /health 200-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#

  1. Ha az új kiadás újabb .NET verziót igényel, telepítse annak Hosting Bundle-jét, és futtassa az iisreset parancsot.
  2. Készítsen mentést az adatbázisról és az oldal mappájáról, majd állítsa le az alkalmazáskészletet.
  3. Tegye félre az appsettings.json egy másolatát.
  4. Másolja az új fájlokat az oldal mappájára, majd tegye vissza a saját appsettings.json fájlját. A szerkesztett sablonok megmaradnak.
  5. 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ó.

Nem találta, amit keresett?

Írjon nekünk, vagy foglaljon időpontot. Válaszolunk a funkciókkal, a telepítéssel és a licenceléssel kapcsolatos kérdésekre.

Kapcsolat