Frissítés, mentés és visszaállítás
Mit kell menteni#
| Elem | Hol |
|---|---|
| Belső adatbázis | SQLite: database.db a database.db-wal és database.db-shm fájllal (mindig együtt). SQL Server, PostgreSQL, MySQL: az adatbázis saját mentőeszközeivel. |
| Szerverlemezes fájltároló | FileStorage/ (mellékletek, komponensképek) |
| Szerkesztett sablonok | LiveEmailTemplates/, LiveNotificationTemplates/ |
| Konfiguráció | appsettings.json |
| Naplók (opcionális) | Logs/ |
Dockerben és Kubernetesen az appsettings.json kivételével minden az adatköteten van (/app/data). A felhős fájltárolók mentése a szolgáltatónál történik.
A mentések hitelesítő adatokat tartalmaznak. Az adatbázisban az alkalmazás által visszafejthető formában vannak a fájltárolók kulcsai, az értesítési és e-mail hitelesítő adatok és más titkok, valamint a bejelentkezési sütiket védő kulcsok; az
appsettings.jsonaz aláíró kulcsokat és a kapcsolati titkokat tartalmazza. A mentéseket korlátozott hozzáféréssel és titkosítva tárolja, az ideiglenes másolatokat pedig törölje.
SQLite adatbázis másolása előtt állítsa le az alkalmazást: az adatbázis write-ahead-log módban fut, és futás közben készült másolata inkonzisztens lehet.
Frissítés#
- Olvassa el a kiadási jegyzékeket: ezek írják le, ha egy verzióhoz teendő tartozik, és hogy kell-e újabb .NET futtatókörnyezet.
- Készítsen mentést az adatbázisról és az adatmappáról vagy -kötetről.
- Cserélje le az alkalmazás fájljait (vagy az image-et), a saját
appsettings.jsonmegtartásával. - Indítsa el az alkalmazást. Az adatbázis-migrációk induláskor automatikusan lefutnak. Több szerver esetén csomópontok közötti zárolással futnak, így a szerverek együtt is frissíthetők. Az új beállítások alapértékkel bekerülnek az
appsettings.json-ba.
Korábbi verzióra visszatérni a frissítés előtt készült mentés visszaállításával lehet: a migrációk nem fordíthatók vissza.
Sablonok: IIS-es és linuxos frissítéskor a szerkesztett élő sablonok megmaradnak (a kiadás csak az alapértelmezetteket tartalmazza). Dockerben azok az image-ek, amelyeknél az élő sablonok a konténeren belül voltak, a konténer újralétrehozásakor elveszítik őket; előbb másolja ki őket a régi konténerből (lásd az üzemeltetői útmutatót).
Platformonkénti lépések: Windows (IIS), Linux, Kubernetes.
Docker#
Mentés (Linuxon; a segédparancs az alkalmazás image-ét használja, hálózat nélkül fut):
docker stop worksmarthub
docker run --rm --network none -v worksmarthub-data:/app/data -v "$PWD":/backup --user "$(id -u):$(id -g)" \
--entrypoint sh worksmarthub:23 -c 'umask 077; tar czf "/backup/worksmarthub-data-$(date +%F).tgz" -C /app/data .'
docker start worksmarthubVisszaállítás (leállított alkalmazással; a teljes kötetet lecseréli):
docker run --rm --network none -u 0 --cap-drop ALL --cap-add CHOWN --cap-add DAC_OVERRIDE --cap-add FOWNER \
-v worksmarthub-data:/app/data -v "$PWD":/backup:ro --entrypoint sh worksmarthub:23 \
-c 'tar tzf /backup/worksmarthub-data-YYYY-MM-DD.tgz >/dev/null && find /app/data -mindepth 1 -delete && tar xzf /backup/worksmarthub-data-YYYY-MM-DD.tgz -C /app/data && chown -R 1001:1001 /app/data'Frissítés: docker stop worksmarthub && docker rm worksmarthub, majd indítsa el az új image-et ugyanazzal a kötettel.
Vigyázzon a kötetre: a nevesített kötetek túlélik a docker rm parancsot és az image-frissítést, de a docker volume prune -a, valamint a Docker Desktop Clean / Purge data és Reset to factory defaults funkciója törli őket. Ezek előtt mindig készítsen mentést.
Átköltözés másik szerverre vagy adatbázisba#
- Azonos adatbázistípus esetén: mentse és állítsa vissza az adatbázist és az adatmappát, másolja át az
appsettings.jsonfájlt (ugyanazokkal az aláíró kulcsokkal, különben a munkamenetek, a tokenek és a fájlhivatkozások megszűnnek), és állítsa aPublicBaseUrlértékét az új címre. A mellékletek és képek hivatkozásai automatikusan az aktuális címre épülnek fel. - A Kubernetes üzemeltetői útmutatóban külön fejezet szól a környezetek közötti átköltözésről.