Telepítési útmutató

Első bejelentkezés és üzemeltetés

Az első rendszergazda, a frissítések, a biztonsági mentések, a coming soon és a biztonsági szabályzat.

Az első rendszergazda

A regisztráció csak meghívókóddal rendelkezőknek nyitott, a kódokat pedig a konzolban hozzák létre — amelyet még senki sem tud megnyitni. Az első kódot magán a gépen hozza létre.

  1. Lemezkép: a kiszolgálón, a tároló gyökerében, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Mappa: PowerShellben, a mappában, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. A parancs XXXX-XXXX-XXXX formájú kódot ír ki; az invite-code 5 ötöt.
  4. A portálon kattintson a Bejelentkezés, majd a Fiók létrehozása lehetőségre: adja meg a kódot, regisztráljon az ADMINISTRATORS fájlba írt e-mail-címmel, és erősítse meg az ellenőrző e-mail kódjával.
  5. Jelentkezzen be: a Diagnosztika minden oldal alján megnyitja a konzolt, ahol a további meghívókódok készülnek.

Tipp Ha az ellenőrző e-mail nem érkezik meg, ellenőrizze a postafiók jelszavát: a bejelentkezési szolgáltatás induláskor jelzi, ha hiányzik.

Frissítés

A frissítés lecseréli a lemezképet, és megtartja az adatokat: azok a konténer kötetében vannak, amely a projekthez tartozik, nem a lemezképhez.

  1. A fejlesztői gépen, a frissített tárolóval készítse el az új lemezképet: .\rebuild_container_release.ps1 -NoSeedData.
  2. Másolja a kiszolgálóra, ellenőrizze és töltse be, mint első alkalommal: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Indítsa ugyanazzal a paranccsal, mint első alkalommal: a docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d észreveszi az új lemezképet, és néhány másodperces kieséssel újra létrehozza a konténert.
  4. Nyissa meg a konzolt a Frissítés lapon: ahol egy sor Frissítés érhető el állapotot mutat, kattintson a Frissítés futtatása gombra — addig az adott szolgáltatás adatfunkciói kikapcsolva maradnak.

Tipp Minden frissítés előtt nézze meg a diagnosztikában, hogy rendben vannak-e az adatbázisok másolatai („Az adatbázisok másolatai” kártya), és készítsen másolatot a fájlokról: az adatbázisok frissítése egy másolaton dolgozik, és az eredetit megtartja, amíg a másolat ellenőrzése meg nem történik, de a másolatok az Ön saját visszaútja.

Másolatok és visszaállítás

Minden szolgáltatás folyamatos másolatot tart az általa kezelt adatbázisokról — fiókok, dokumentumindexek, levelek, csevegések —, legfeljebb nagyjából egy másodperces lemaradással, és az utolsó hét nap bármely pillanatának állapotára vissza tudja állítani őket. Maguk a fájlok — dokumentumok, mellékletek, előnézetek — egyszer íródnak, és soha nem változnak: ezeket külön kell lemásolni, vagy egy S3-bucket tárolja őket.

  1. Vigye ki az adatbázisok másolatait a gépről: regisztráljon egy backups osztályú célhelyet egy S3-bucketen vagy egy másik lemezen, és aktiválja.
  2. Lemezkép: futás közben másolja le a fájlokat, az adatbázisok nélkül: a docker run --rm -v merydion-prod-allinone_merydion_state:/d:ro -v "$PWD/files":/b alpine sh -c 'tar czf /b/files-$(date +%F).tgz -C /d --exclude="*.db" --exclude="*.db-*" --exclude=./backups --exclude=./restores .' dátumozott archívumot ír a files mappába.
  3. Mappa: állítsa le a .\stop.ps1 paranccsal, másolja át a teljes data mappát, majd indítsa újra.
  4. Ha egy rendszergazda másik célhelyet regisztrált a fájlok számára, ugyanabban a körben másolja annak mappáját is: az aktiválása után keletkezett fájlok csak ott vannak.
  5. A másolatokat a védett géptől távol tárolja.

Tipp Ha egy adatbázist vagy a teljes telepítést egy adott pillanat állapotára szeretné visszaállítani, állítsa le a telepítést, és futtassa a merydion-storage copies restore parancsot (a runbook „Másolatok és visszaállítás” eljárása): a parancs egy új mappába írja a visszaállított adatbázisokat, és aztán ez a mappa veszi át a régi helyét.

A webhely coming soon állapotba helyezése

A coming soon minden látogatónak csak egy előnézeti oldalt mutat, amíg a telepítés készül: a portál, az alkalmazások, a Palatys és a konzol mögötte vár, a rendszergazdák számára is.

  1. Jelentkezzen be rendszergazdaként, és nyissa meg a https://merydion.example.com/coming-soon.html?enabled=true címet: az oldal megerősíti, és a webhely coming soon állapotba kerül.
  2. A webhely visszakapcsolásához nyissa meg a https://merydion.example.com/coming-soon.html?enabled=false címet: a megerősítés után az oldal a kezdőlapra viszi.
  3. Ha nincs bejelentkezve, az oldal először bejelentkezést kér; egy nem rendszergazdai fióknak ezt jelzi, és semmi sem változik.
  4. Az állapot az adatmappában lévő site/coming-soon fájl: eltávolítása az oldal nélkül is visszakapcsolja a webhelyet.

Tipp A coming soon oldal angolul és olaszul létezik; más nyelvű látogató az angolt kapja.

A látogatási statisztika bekapcsolása

A webhely a Google Analytics 4 szolgáltatással számolhatja a látogatásait, de előbb minden látogatótól hozzájárulást kér: amíg a látogató el nem fogadja, semmi sem töltődik be a Google-tól. A statisztika kikapcsolva marad, amíg a telepítés meg nem adja a mérési azonosítóját, az adminisztrációs konzolban pedig soha nincs statisztika.

  1. A Google Analytics szolgáltatásban hozzon létre egy tulajdont és egy webes adatfolyamot a webhely címéhez, és másolja ki a mérési azonosítóját (G- kezdetű).
  2. Lemezkép: a .env fájlba (a docker-compose.yml mellett) írja be a MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX sort, és hozza létre újra a konténert a docker compose up -d paranccsal. Mappa: exportálja ugyanezt a változót a munkamenetben a start.ps1 előtt.
  3. Nyissa meg a webhelyet egy privát ablakban: a bal alsó sarokban megjelenik a látogatási statisztikáról szóló értesítés, minden oldal alján pedig a „Sütibeállítások”.
  4. A statisztika kikapcsolásához ürítse ki a változót, és hozza létre újra a konténert: az értesítés eltűnik, és azoknak a böngészői, akik elfogadták, többé nem töltik be a Google Analytics szolgáltatást.

Tipp Az adatvédelmi tájékoztató és a sütikre vonatkozó tájékoztató minden nyelven leírja már a statisztikát annál a telepítésnél, amely bekapcsolja. A tulajdonban állítsa be a kívánt adatmegőrzést — a Google egy látogatás adatait legfeljebb 14 hónapig őrzi meg —, és hagyja kikapcsolva a Google-jeleket: a webhely a saját oldalán is kikapcsolja őket.

A webhely megnyitása a keresőmotorok előtt

Minden telepítés jelzi a keresőmotoroknak, hogy ne indexeljék, amíg be nem kapcsolja az indexelést: a webhely nem hivatalos példánya — egy próbatelepítés, egy szervezet telepítése — soha nem versenyez vele a találatok között. Az oldalak, az előnézetek és a webhelytérképek által megadott címek a hivatalos webhelyre, a https://merydion.eu címre mutatnak, a fiókoldalak, a konzol és egy nem létező cím oldala pedig soha nem kerülnek be indexbe.

  1. Csak azon a telepítésen, amely a hivatalos webhelyet kiszolgálja. Lemezkép: a .env fájlba (a docker-compose.yml mellett) írja be a MERYDION_SITE_INDEXING=1 sort, és hozza létre újra a konténert a docker compose up -d paranccsal. Mappa: exportálja ugyanezt a változót a munkamenetben a start.ps1 előtt.
  2. Ellenőrzés: a curl -I https://merydion.eu/ már nem mutatja az X-Robots-Tag: noindex fejlécet, a https://merydion.eu/robots.txt pedig a https://merydion.eu/sitemap.xml címre mutat.
  3. A Google Search Console és a Bing Webmaster Tools szolgáltatásban igazolja a tartományt egy DNS-rekorddal, és küldje be a https://merydion.eu/sitemap.xml címet.
  4. Ha újra ki szeretné vonni a webhelyet a keresőmotorokból, ürítse ki a változót, és hozza létre újra a konténert: minden válasz ismét noindex jelzést tartalmaz, a keresőmotorok pedig a következő látogatásukkor eltávolítják az oldalakat.

Tipp A más címre generált portál a generáláskor beállítja a MERYDION_SITE_ORIGIN változót (például https://www.example.com): a kanonikus címek, a nyelvi változatok, az előnézetek és a webhelytérképek ekkor ezt a címet adják meg. Egy nem létező cím oldala a mappája nyelvén válaszol, 404-es állapotkóddal.

A portál Content-Security-Policy szabályzata

A portál oldalai az átjáró által küldött szigorú Content-Security-Policy alatt futnak: egy oldal csak a saját fájljait, a saját eredetére irányuló kéréseket, data: és blob: forrásból származó képeket is használhat, más webhely keretét pedig semmiképp. Ez akadályozza meg, hogy egy becsúszott jelölőkód-darab kódot futtasson. Az egyetlen kivétel a látogatási statisztika: azok az oldalak, amelyek látogatásokat számolhatnak, a Google gtag.js szkriptjét is engedélyezik, csak annak útvonalán, valamint a Google Analytics adatgyűjtését, és ezek csak azután töltődnek be, hogy a látogató elfogadta.

  1. Az a testreszabott portál, amelynek oldalaiba szkripteket vagy stílusokat írtak, nem működik: a szkriptek és stílusok saját fájlokba kerülnek.
  2. A window.MERYDION_AUTH_BASE, a window.MERYDION_API_BASE és a window.MERYDION_DIAGNOSTICS_BASE egy kéréscsaládot csak ugyanazon eredet másik útvonala alá helyezhet át; más eredetű címet figyelmen kívül hagy, hibával a böngésző konzoljában.
  3. A telepítés konzoljának oldalai a szabályzatot a statisztikára vonatkozó kivétel nélkül viselik, és ezen felül keretben sem jeleníthetők meg.
  4. A szabályzat az apps/portal-csp.mjs fájlban és a három Caddyfile-ban él, és egy teszt egyformán tartja őket: mind a négy helyen egyszerre módosítsa.

Tipp Az identitásszolgáltatás bejelentkezési űrlapja és a konzol elutasító oldala saját, még szigorúbb szabályzattal érkezik.

Vissza az útmutatóhoz

Termelékenység, made in Italy.

Adja a teljes csomagot a csapata kezébe – egyszerű, biztonságos és teljesen az Öné.