Éles üzemeltetés

Éles üzemeltetés

Ezen az oldalon

Ezek a tudnivalók minden telepítési módra és minden adatbázisra vonatkoznak.

Állapotellenőrzés#

A GET /health bejelentkezés nélkül 200 {"status":"Healthy"} választ ad, amint az alkalmazás kiszolgálja a kéréseket (az induláskori migrációk után). Mást nem érint. Terheléselosztókhoz, monitorozáshoz és Kubernetes-próbákhoz használja; a liveness próbának adjon bőséges kezdeti késleltetést, mert az első induláskor lefutnak a migrációk.

Munkamenetek#

A bejelentkezési sütiket védő kulcsok az adatbázisban vannak. Ezért a munkamenetek túlélik az újraindítást, a konténer újralétrehozását és a frissítést, és minden szerveren érvényesek. Aki hozzáfér az adatbázis egy másolatához, érvényes bejelentkezési sütit tud készíteni, ezért védje a mentéseket.

Több szerver#

Több alkalmazásszerver is használhat egy közös adatbázist:

  • Adatbázis: SQL Server, PostgreSQL vagy MySQL. Az SQLite csak egy szervert támogat.
  • Cache: Redis vagy adatbázis-cache. Az alapértelmezett InMemory cache esetén a jogosultságok, a licenc állapota, a törzsadatlisták és az OAuth bejelentkezési állapot szerverenként eltérhetne; az alkalmazás induláskor figyelmeztet erre.
  • Fájltároló: felhős tároló, nem a szerver lemeze.
  • Mindenhol ugyanazok a beállítások: azonos appsettings.json, az aláíró kulcsokkal és a PublicBaseUrl értékkel együtt.
  • A migrációk induláskor csomópontok közötti zárolással futnak: az egyik szerver migrál, a többi megvárja.
  • Az ütemezett háttérfolyamatok alkalmanként csak egyszer futnak le az összes szerver között: futás előtt a szerver lefoglalja az adott alkalmat az adatbázisban, így egyetlen e-mail, Slack/Teams üzenet vagy Számlázz.hu hívás sem duplázódik. A szerverek órája legyen szinkronban és azonos időzónában, és 1 napos vagy rövidebb időközöket használjon. A Futtatási zárolások takarítása háttérfolyamat törli a régi foglalásokat (naponta 04:15-kor, 7 napig őrzi meg őket).
  • Az App Konfiguráció módosításai kb. 10 másodpercen belül eljutnak a többi szerverre.
Több szerver közös adatbázist, cache-t és felhős fájltárolót használ; az ütemezett háttérfolyamatok alkalmanként egyszer futnak.

Leállítás#

Leállításkor az alkalmazás 45 másodpercet ad a háttérfolyamatainak, majd lezárja az adatbázist. Hagyjon neki legalább 60 másodpercet: Dockerben --stop-timeout 60, systemd alatt TimeoutStopSec=75, IIS alatt shutdownTimeLimit="60".

Naplózási szintek#

A minimális naplózási szintek az appsettings.json-ból (Serilog:MinimumLevel) vagy környezeti változókból jönnek, hacsak az App Konfiguráció → Log Szintek nem írja felül őket az összes szerveren. Ott minden módosítást a rendszergazda nevével rögzít az alkalmazás. Éles környezetben ne használjon Debug vagy Verbose szintet, legfeljebb rövid ideig: ezek sokkal több adatot írnak, köztük személyes adatokat is, és megtöltik a lemezt. A kérésnaplók soha nem tartalmazzák a hitelesítő adatokat hordozó lekérdezési paramétereket.

Tárolt titkok#

A felületen megadott titkok (az értesítési csatornák és fájltárolók hitelesítő adatai, a Számlázz.hu kulcsai, a HashiCorp Vault token) csak írhatók: soha többé nem jelennek meg, és ha a mezőt üresen hagyja, a tárolt érték megmarad. Ha a titok célja megváltozik (SMTP-szerver vagy port, MinIO szerver, S3 régió, Azure tárfiók, SharePoint tenant, Vault URL, a típus, vagy kikapcsolja az SSL-t), a titkot újra meg kell adni. Titok cseréjekor hozzon létre újat a szolgáltatónál, adja meg, és csak utána vonja vissza a régit.

Biztonsági ellenőrzőlista#

  • Saját aláíró kulcsok, HTTPS, SecureCookie: true, beállított PublicBaseUrl (Konfiguráció).
  • A fordított proxynak felül kell írnia az X-Forwarded-Host és X-Forwarded-Proto fejlécet, mert az alkalmazás megbízik bennük.
  • Az appsettings.json és a mentések csak a rendszergazdák számára legyenek elérhetők.
  • Nézze át az Admin Token Menedzsment oldalt, és érvénytelenítse a nem használt tokeneket.
  • Ha nincs szüksége az API-dokumentációra, kapcsolja ki a Swagger.Enabled beállítást.
  • Hagyja bekapcsolva a biztonsági fejléceket (App Konfiguráció → Biztonsági fejlécek).

Parancssor#

Az alkalmazás parancssori műveleteket (verb) is elfogad. A dotnet WorkSmartHub.dll --help kilistázza őket; a jelenlegi kiadásban:

Művelet Szerepe
run A webalkalmazás futtatása (ez az alapértelmezés, ha nincs megadva művelet)
database Műveletek a belső adatbázison: mentés, visszaállítás, ürítés, migrálás. A migrálás ugyanazt a csomópontok közötti zárolást használja, mint az indulás.
user-store A beállított felhasználói tár lekérdezése (címtárkapcsolat kipróbálására hasznos)
help, version Súgó és verzióinformáció

A műveleteket az alkalmazás mappájában, ugyanazzal az appsettings.json fájllal futtassa, visszaállítás előtt pedig állítsa le az alkalmazást.

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