Príručka k inštalácii

Prvé prihlásenie a prevádzka

Prvý správca, aktualizácie, zálohy, coming soon a bezpečnostná politika.

Prvý správca

Registrácia je otvorená iba tomu, kto má kód pozvánky, a kódy sa generujú v konzole — ktorú zatiaľ nikto nemôže otvoriť. Prvý kód sa generuje priamo na počítači.

  1. Obraz: na serveri v koreni repozitára docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Priečinok: v PowerShelli v priečinku $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Príkaz vypíše kód v tvare XXXX-XXXX-XXXX; invite-code 5 ich vypíše päť.
  4. Na portáli kliknite na Prihlásiť sa a potom na Vytvoriť účet: zadajte kód, zaregistrujte sa e-mailom uvedeným v ADMINISTRATORS a potvrďte ho kódom z overovacieho e-mailu.
  5. Prihláste sa: Diagnostika v päte každej stránky otvorí konzolu, kde sa generujú ďalšie kódy pozvánok.

Tip Ak overovací e-mail nepríde, skontrolujte heslo schránky: prihlasovacia služba pri spustení oznámi, keď chýba.

Aktualizácia

Aktualizácia nahradí obraz a zachová údaje: sú vo zväzku kontajnera, ktorý patrí projektu, nie obrazu.

  1. Na vývojovom počítači s aktualizovaným repozitárom zostavte nový obraz: .\rebuild_container_release.ps1 -NoSeedData.
  2. Skopírujte ho na server, overte a načítajte ako prvýkrát: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Spustite rovnakým príkazom ako prvýkrát: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d rozpozná nový obraz a vytvorí kontajner znova, s výpadkom niekoľkých sekúnd.
  4. Otvorte konzolu na karte Aktualizácia: kde riadok ukazuje Dostupná aktualizácia, kliknite na Spustiť aktualizáciu — dovtedy zostávajú dátové funkcie tejto služby vypnuté.

Tip Pred každou aktualizáciou si v diagnostike skontrolujte, či sú kópie databáz v poriadku (karta „Kópie databáz“), a skopírujte súbory: aktualizácia databáz pracuje na kópii a originál drží, kým kópia nie je overená, ale kópie sú vaša vlastná cesta späť.

Kópie a obnova

Každá služba udržiava priebežnú kópiu databáz, ktoré spravuje — účty, indexy dokumentov, pošta, chaty —, najviac približne sekundu pozadu, a dokáže ich obnoviť do stavu v ľubovoľnom okamihu za posledných sedem dní. Samotné súbory — dokumenty, prílohy, náhľady — sa zapisujú raz a už sa nikdy nemenia: kopírujú sa zvlášť alebo sú uložené v buckete S3.

  1. Preneste kópie databáz mimo tohto počítača: zaregistrujte cieľ triedy backups v buckete S3 alebo na inom disku a aktivujte ho.
  2. Obraz: počas behu skopírujte súbory bez databáz: 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 archív s dátumom do priečinka files.
  3. Priečinok: zastavte ho pomocou .\stop.ps1, skopírujte celý priečinok data a potom ho znova spustite.
  4. Ak správca zaregistroval pre súbory ďalší cieľ, skopírujte jeho priečinok v tom istom kole: súbory vzniknuté po jeho aktivácii sú iba tam.
  5. Uchovávajte kópie ďaleko od počítača, ktorý chránia.

Tip Ak chcete vrátiť jednu databázu alebo celú inštaláciu do stavu v určitom okamihu, zastavte inštaláciu a spustite merydion-storage copies restore (postup „Kópie a obnova“ v runbooku): príkaz zapíše obnovené databázy do nového priečinka, ktorý potom nahradí starý.

Prepnutie webu do coming soon

Coming soon ukazuje každému návštevníkovi iba stránku s náhľadom, kým sa inštalácia pripravuje: portál, aplikácie, Palatys aj konzola čakajú za ňou, aj pre správcov.

  1. Prihláste sa ako správca a otvorte https://merydion.example.com/coming-soon.html?enabled=true: stránka to potvrdí a web je v coming soon.
  2. Ak chcete web znova zapnúť, otvorte https://merydion.example.com/coming-soon.html?enabled=false: po potvrdení vás stránka vráti na domovskú stránku.
  3. Ak nie ste prihlásený, stránka vás najprv požiada o prihlásenie; účtu, ktorý nie je správcom, to povie a nič sa nezmení.
  4. Stav je súbor site/coming-soon v dátovom priečinku: jeho odstránenie zapne web znova aj bez stránky.

Tip Stránka coming soon existuje v angličtine a taliančine; návštevník s iným jazykom dostane anglickú.

Zapnutie štatistík návštevnosti

Web môže počítať svoje návštevy pomocou Google Analytics 4 a každého návštevníka najprv požiada o súhlas: kým návštevník nesúhlasí, nenačíta sa nič od spoločnosti Google. Štatistiky zostávajú vypnuté, kým inštalácia neuvedie svoje ID merania, a administračná konzola ich nemá nikdy.

  1. V Google Analytics vytvorte vlastníctvo a webový dátový stream pre adresu webu a skopírujte jeho ID merania (začína sa na G-).
  2. Obraz: do súboru .env vedľa docker-compose.yml pridajte MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX a vytvorte kontajner znova pomocou docker compose up -d. Priečinok: exportujte tú istú premennú v relácii pred start.ps1.
  3. Otvorte web v súkromnom okne: vľavo dole sa zobrazí oznámenie o štatistikách návštevnosti a v dolnej časti každej stránky odkaz „Predvoľby súborov cookie“.
  4. Ak chcete štatistiky vypnúť, vyprázdnite premennú a vytvorte kontajner znova: oznámenie zmizne a prehliadače tých, ktorí súhlasili, prestanú Google Analytics načítavať.

Tip Zásady ochrany osobných údajov a zásady používania súborov cookie už štatistiky opisujú, v každom jazyku, pre inštaláciu, ktorá ich zapne. Vo vlastníctve nastavte požadované uchovávanie údajov — Google uchováva údaje o návšteve najviac 14 mesiacov — a signály Google nechajte vypnuté: web ich vypína aj na svojej strane.

Sprístupnenie webu vyhľadávačom

Každá inštalácia žiada vyhľadávače, aby ju neindexovali, kým sama nezapne indexovanie: neoficiálna kópia webu — testovacia inštalácia, inštalácia organizácie — oficiálnemu webu nikdy nekonkuruje vo výsledkoch vyhľadávania. Adresy, ktoré uvádzajú stránky, náhľady a súbory Sitemap, smerujú na oficiálny web https://merydion.eu, a stránky účtu, konzola a stránka neexistujúcej adresy sa nikdy nedostanú do indexu.

  1. Iba na inštalácii, ktorá obsluhuje oficiálny web. Obraz: do súboru .env vedľa docker-compose.yml pridajte MERYDION_SITE_INDEXING=1 a vytvorte kontajner znova pomocou docker compose up -d. Priečinok: exportujte tú istú premennú v relácii pred start.ps1.
  2. Skontrolujte to: curl -I https://merydion.eu/ už nezobrazuje 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 overte doménu záznamom DNS a odošlite https://merydion.eu/sitemap.xml.
  4. Ak chcete web z vyhľadávačov opäť odstrániť, vyprázdnite premennú a vytvorte kontajner znova: každá odpoveď bude zase hlásiť noindex a vyhľadávače stránky pri ďalšej návšteve vyradia.

Tip Portál generovaný pre inú adresu nastaví pri generovaní MERYDION_SITE_ORIGIN (napríklad https://www.example.com): kanonické adresy, jazykové alternatívy, náhľady a súbory Sitemap potom uvádzajú túto adresu. Stránka neexistujúcej adresy odpovedá v jazyku svojho priečinka so stavovým kódom 404.

Content-Security-Policy portálu

Stránky portálu bežia pod prísnou Content-Security-Policy, ktorú posiela brána: stránka smie používať iba vlastné súbory, požiadavky na vlastný pôvod, obrázky aj z data: a blob: a žiadny rámec iného webu. Práve to bráni zatúlanému kúsku značkovania spustiť kód. Jedinou výnimkou sú štatistiky návštevnosti: stránky, ktoré môžu počítať návštevy, pripúšťajú aj gtag.js od spoločnosti Google, iba na jeho ceste, a zber údajov Google Analytics, ktoré sa načítajú až potom, čo návštevník súhlasí.

  1. Upravený portál so skriptmi alebo štýlmi zapísanými priamo v stránkach nefunguje: skripty a štýly patria do vlastných súborov.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE a window.MERYDION_DIAGNOSTICS_BASE môžu presunúť skupinu požiadaviek iba pod inú cestu toho istého pôvodu; adresa na inom pôvode sa ignoruje, s chybou v konzole prehliadača.
  3. Stránky konzoly inštalácie majú politiku bez výnimky pre štatistiky a navyše ich nemožno zobraziť vnútri rámca.
  4. Politika je v apps/portal-csp.mjs a v troch súboroch Caddyfile a test ich drží rovnaké: meňte ju na všetkých štyroch miestach naraz.

Tip Prihlasovací formulár služby identít a stránka odmietnutia konzoly prichádzajú s vlastnou, ešte prísnejšou politikou.

Späť na príručku

Produktivita, made in Italy.

Prineste svojmu tímu celý balík — jednoduchý, bezpečný a úplne váš.