Příručka k instalaci

První přihlášení a provoz

První správce, aktualizace, zálohy, coming soon a bezpečnostní zásady.

První správce

Registrace je otevřena jen tomu, kdo má kód pozvánky, a kódy se generují v konzoli — kterou zatím nikdo nemůže otevřít. První kód se generuje přímo na počítači.

  1. Obraz: na serveru v kořeni repozitáře docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Složka: v PowerShellu ve složce $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Příkaz vypíše kód ve tvaru XXXX-XXXX-XXXX; invite-code 5 jich vypíše pět.
  4. Na portálu klikněte na Přihlásit se a potom na Vytvořit účet: zadejte kód, zaregistrujte se e-mailem uvedeným v ADMINISTRATORS a potvrďte ho kódem z ověřovacího e-mailu.
  5. Přihlaste se: Diagnostika v zápatí každé stránky otevře konzoli, kde se generují další kódy pozvánek.

Tip Pokud ověřovací e-mail nedorazí, zkontrolujte heslo schránky: přihlašovací služba při spuštění oznámí, když chybí.

Aktualizace

Aktualizace nahradí obraz a zachová data: jsou ve svazku kontejneru, který patří projektu, ne obrazu.

  1. Na vývojovém počítači s aktualizovaným repozitářem sestavte nový obraz: .\rebuild_container_release.ps1 -NoSeedData.
  2. Zkopírujte ho na server, ověřte a načtěte jako poprvé: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Spusťte stejným příkazem jako poprvé: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d rozpozná nový obraz a vytvoří kontejner znovu, s výpadkem několika sekund.
  4. Otevřete konzoli na kartě Aktualizace: kde řádek ukazuje Dostupná aktualizace, klikněte na Spustit aktualizaci — do té doby zůstávají datové funkce té služby vypnuté.

Tip Před každou aktualizací zkontrolujte v diagnostice, že jsou kopie databází v pořádku (karta „Kopie databází“), a zkopírujte soubory: aktualizace databází pracuje na kopii a originál drží, dokud kopie není ověřena, ale kopie jsou vaše vlastní cesta zpět.

Kopie a obnova

Každá služba udržuje průběžnou kopii databází, které spravuje — účty, indexy dokumentů, pošta, chaty —, nejvýše zhruba sekundu pozadu, a dokáže ji obnovit k libovolnému okamžiku posledních sedmi dnů. Samotné soubory — dokumenty, přílohy, náhledy — se zapisují jednou a už se nikdy nemění: kopírují se zvlášť, nebo jsou uloženy v bucketu S3.

  1. Přeneste kopie databází mimo tento počítač: zaregistrujte cíl třídy backups v bucketu S3 nebo na jiném disku a aktivujte ho.
  2. Obraz: zkopírujte soubory bez databází, zatímco běží: 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 .' zapíše archiv s datem do složky files.
  3. Složka: zastavte ji pomocí .\stop.ps1, zkopírujte celou složku data a pak ji znovu spusťte.
  4. Pokud správce zaregistroval pro soubory další cíl, zkopírujte jeho složku ve stejném kole: soubory vzniklé po jeho aktivaci jsou jen tam.
  5. Uchovávejte kopie daleko od počítače, který chrání.

Tip Chcete-li vrátit jednu databázi nebo celou instalaci do stavu v určitém okamžiku, zastavte instalaci a spusťte merydion-storage copies restore (postup „Kopie a obnova“ v runbooku): příkaz zapíše obnovené databáze do nové složky, která pak nahradí tu starou.

Přepnutí webu do coming soon

Coming soon ukazuje každému návštěvníkovi jen stránku s náhledem, zatímco se instalace připravuje: portál, aplikace, Palatys i konzole čekají za ní, i pro správce.

  1. Přihlaste se jako správce a otevřete https://merydion.example.com/coming-soon.html?enabled=true: stránka to potvrdí a web je v coming soon.
  2. Chcete-li web znovu zapnout, otevřete https://merydion.example.com/coming-soon.html?enabled=false: po potvrzení vás stránka vrátí na domovskou stránku.
  3. Pokud nejste přihlášeni, stránka vás nejprve požádá o přihlášení; účtu, který není správcem, to řekne a nic se nezmění.
  4. Stav je soubor site/coming-soon v datové složce: jeho odstranění zapne web znovu i bez stránky.

Tip Stránka coming soon existuje v angličtině a italštině; návštěvník s jiným jazykem dostane anglickou.

Zapnutí statistik návštěvnosti

Web může sčítat své návštěvy pomocí Google Analytics 4 a každého návštěvníka nejprve požádá o souhlas: dokud návštěvník nesouhlasí, nenačte se nic od společnosti Google. Statistiky zůstávají vypnuté, dokud instalace neuvede své ID měření, a administrační konzole je nemá nikdy.

  1. V Google Analytics vytvořte službu a webový datový stream pro adresu webu a zkopírujte jeho ID měření (začíná na G-).
  2. Obraz: do souboru .env vedle docker-compose.yml přidejte MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX a vytvořte kontejner znovu pomocí docker compose up -d. Složka: exportujte stejnou proměnnou v relaci před start.ps1.
  3. Otevřete web v anonymním okně: vlevo dole se objeví oznámení o statistikách návštěvnosti a v dolní části každé stránky odkaz „Předvolby souborů cookie“.
  4. Chcete-li statistiky vypnout, vyprázdněte proměnnou a vytvořte kontejner znovu: oznámení zmizí a prohlížeče těch, kdo souhlasili, přestanou Google Analytics načítat.

Tip Zásady ochrany osobních údajů a zásady používání souborů cookie už statistiky popisují, v každém jazyce, pro instalaci, která je zapne. Ve službě nastavte požadované uchovávání dat — Google uchovává údaje o návštěvě nejvýše 14 měsíců — a signály Google nechte vypnuté: web je vypíná i na své straně.

Zpřístupnění webu vyhledávačům

Každá instalace vyhledávačům sděluje, aby ji neindexovaly, dokud indexování nezapne: kopie webu, která není ta oficiální — testovací instalace, instalace některé organizace —, s ním ve výsledcích nikdy nesoupeří. Adresy, které uvádějí stránky, náhledy a mapy webu, vedou na oficiální web, https://merydion.eu, a stránky účtu, konzole a stránka neexistující adresy se do indexu nikdy nedostanou.

  1. Jen na instalaci, na které běží oficiální web. Obraz: do souboru .env vedle docker-compose.yml přidejte MERYDION_SITE_INDEXING=1 a vytvořte kontejner znovu pomocí docker compose up -d. Složka: exportujte stejnou proměnnou v relaci před start.ps1.
  2. Kontrola: curl -I https://merydion.eu/ už neukazuje hlavičku X-Robots-Tag: noindex a https://merydion.eu/robots.txt odkazuje na https://merydion.eu/sitemap.xml.
  3. V Google Search Console a v Bing Webmaster Tools ověřte doménu záznamem DNS a odešlete https://merydion.eu/sitemap.xml.
  4. Chcete-li web z vyhledávačů opět stáhnout, vyprázdněte proměnnou a vytvořte kontejner znovu: každá odpověď znovu říká noindex a vyhledávače stránky při příští návštěvě vyřadí.

Tip Portál generovaný pro jinou adresu nastaví při generování MERYDION_SITE_ORIGIN (například https://www.example.com): kanonické adresy, alternativní jazykové verze, náhledy a mapy webu pak uvádějí tuto adresu. Stránka neexistující adresy odpovídá v jazyce své složky, se stavovým kódem 404.

Content-Security-Policy portálu

Stránky portálu běží pod přísnou Content-Security-Policy, kterou posílá brána: stránka smí používat jen vlastní soubory, požadavky na vlastní původ, obrázky i z data: a blob: a žádný rámec jiného webu. Právě to brání zatoulanému kousku značkování spustit kód. Jedinou výjimkou jsou statistiky návštěvnosti: stránky, které mohou sčítat návštěvy, připouštějí také gtag.js od společnosti Google, jen na jeho cestě, a sběr dat Google Analytics, které se načtou až poté, co návštěvník souhlasí.

  1. Upravený portál se skripty nebo styly zapsanými přímo ve stránkách nefunguje: skripty a styly patří do vlastních souborů.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE a window.MERYDION_DIAGNOSTICS_BASE mohou přesunout skupinu požadavků jen pod jinou cestu téhož původu; adresa na jiném původu se ignoruje, s chybou v konzoli prohlížeče.
  3. Stránky konzole instalace nesou zásady bez výjimky pro statistiky a navíc je nelze zobrazit uvnitř rámce.
  4. Zásady žijí v apps/portal-csp.mjs a ve třech souborech Caddyfile a test je drží stejné: měňte je na všech čtyřech místech najednou.

Tip Přihlašovací formulář služby identit a stránka odmítnutí konzole přicházejí s vlastními, ještě přísnějšími zásadami.

Zpět na průvodce

Produktivita, made in Italy.

Přineste svému týmu celou sadu — jednoduchou, bezpečnou a zcela vaši.