Ghid de instalare

Prima autentificare și exploatare

Primul administrator, actualizările, copiile de rezervă, coming soon și politica de securitate.

Primul administrator

Înregistrarea este deschisă doar celor care au un cod de invitație, iar codurile se generează în consolă — pe care încă nu o poate deschide nimeni. Primul cod se generează pe mașina însăși.

  1. Imagine: pe server, din rădăcina depozitului, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Dosar: în PowerShell, în dosar, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Comanda afișează un cod de forma XXXX-XXXX-XXXX; invite-code 5 afișează cinci.
  4. Pe portal, faceți clic pe Autentificare, apoi pe Creați cont: introduceți codul, înregistrați-vă cu e-mailul scris în ADMINISTRATORS și confirmați-l cu codul din e-mailul de verificare.
  5. Autentificați-vă: Diagnosticare, în partea de jos a fiecărei pagini, deschide consola, unde se generează celelalte coduri de invitație.

Sfat Dacă e-mailul de verificare nu sosește, verificați parola căsuței poștale: serviciul de autentificare semnalează la pornire când lipsește.

Actualizarea

O actualizare înlocuiește imaginea și păstrează datele: acestea se află în volumul containerului, care aparține proiectului, nu imaginii.

  1. Pe mașina de dezvoltare, cu depozitul actualizat, construiți noua imagine: .\rebuild_container_release.ps1 -NoSeedData.
  2. Copiați-o pe server, verificați-o și încărcați-o ca prima dată: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Porniți cu aceeași comandă ca prima dată: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d observă noua imagine și recreează containerul, cu o întrerupere de câteva secunde.
  4. Deschideți consola pe fila Actualizare: unde un rând arată Actualizare disponibilă, faceți clic pe Rulează actualizarea — până atunci funcțiile de date ale acelui serviciu rămân oprite.

Sfat Înainte de fiecare actualizare, verificați în diagnosticare dacă copiile bazelor de date sunt în regulă (cardul „Copiile bazelor de date”) și copiați fișierele: actualizarea bazelor de date lucrează pe o copie și păstrează originalul până la verificarea copiei, dar copiile sunt propriul dvs. drum înapoi.

Copiile și restaurarea

Fiecare serviciu ține o copie continuă a bazelor de date pe care le gestionează — conturi, indexuri ale documentelor, poștă, conversații —, cu o întârziere de cel mult aproximativ o secundă, și le poate readuce la starea din orice moment al ultimelor șapte zile. Fișierele propriu-zise — documente, atașamente, previzualizări — se scriu o singură dată și nu se mai schimbă niciodată: se copiază separat sau stau într-un bucket S3.

  1. Mutați copiile bazelor de date în afara mașinii: înregistrați o destinație din clasa backups pe un bucket S3 sau pe alt disc și activați-o.
  2. Imagine: copiați fișierele, fără bazele de date, în timp ce rulează: 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 .' scrie o arhivă datată în dosarul files.
  3. Dosar: opriți-l cu .\stop.ps1, copiați integral dosarul data, apoi reporniți-l.
  4. Dacă un administrator a înregistrat o altă destinație pentru fișiere, copiați dosarul ei în aceeași rundă: fișierele create după activarea ei se află doar acolo.
  5. Păstrați copiile departe de mașina pe care o protejează.

Sfat Pentru a readuce o bază de date sau întreaga instalare la starea dintr-un anumit moment, opriți instalarea și rulați merydion-storage copies restore (procedura „Copiile și restaurarea” din runbook): comanda scrie bazele de date restaurate într-un dosar nou, care apoi ia locul celui vechi.

Trecerea site-ului în coming soon

Coming soon arată fiecărui vizitator doar o pagină de previzualizare cât timp se pregătește instalarea: portalul, aplicațiile, Palatys și consola așteaptă în spatele ei, inclusiv pentru administratori.

  1. Autentificați-vă ca administrator și deschideți https://merydion.example.com/coming-soon.html?enabled=true: pagina confirmă, iar site-ul este în coming soon.
  2. Pentru a reporni site-ul, deschideți https://merydion.example.com/coming-soon.html?enabled=false: după confirmare, pagina vă duce la pagina principală.
  3. Dacă nu sunteți autentificat, pagina vă cere întâi autentificarea; unui cont care nu este administrator îi spune acest lucru și nu se schimbă nimic.
  4. Starea este fișierul site/coming-soon din dosarul de date: eliminarea lui repornește site-ul chiar și fără pagină.

Sfat Pagina coming soon există în engleză și italiană; un vizitator cu altă limbă o primește pe cea în engleză.

Activarea statisticilor de vizitare

Site-ul își poate număra vizitele cu Google Analytics 4, cerând mai întâi consimțământul fiecărui vizitator: până când un vizitator nu acceptă, nu se încarcă nimic de la Google. Statisticile rămân oprite până când instalarea își indică ID-ul de măsurare, iar consola de administrare nu le are niciodată.

  1. În Google Analytics, creați o proprietate și un flux de date web pentru adresa site-ului și copiați ID-ul său de măsurare (începe cu G-).
  2. Imagine: în fișierul .env de lângă docker-compose.yml adăugați MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX și recreați containerul cu docker compose up -d. Dosar: exportați aceeași variabilă în sesiune înainte de start.ps1.
  3. Deschideți site-ul într-o fereastră privată: notificarea despre statisticile de vizitare apare în stânga jos, iar „Preferințe privind cookie-urile” apare în partea de jos a fiecărei pagini.
  4. Pentru a opri statisticile, goliți variabila și recreați containerul: notificarea dispare, iar browserele celor care acceptaseră nu mai încarcă Google Analytics.

Sfat Politica de confidențialitate și politica privind cookie-urile descriu deja statisticile, în fiecare limbă, pentru instalarea care le activează. În proprietate, setați perioada de păstrare a datelor pe care o doriți — Google păstrează datele unei vizite cel mult 14 luni — și lăsați semnalele Google dezactivate: site-ul le dezactivează și din partea sa.

Deschiderea site-ului către motoarele de căutare

Fiecare instalare le cere motoarelor de căutare să nu o indexeze până când nu activează indexarea: o copie a site-ului care nu este cea oficială — o instalare de test, instalarea unei organizații — nu îi face niciodată concurență în rezultate. Adresele declarate de pagini, de previzualizări și de sitemapuri indică site-ul oficial, https://merydion.eu, iar paginile contului, consola și pagina unei adrese inexistente nu intră niciodată într-un index.

  1. Doar pe instalarea care servește site-ul oficial. Imagine: în fișierul .env de lângă docker-compose.yml adăugați MERYDION_SITE_INDEXING=1 și recreați containerul cu docker compose up -d. Dosar: exportați aceeași variabilă în sesiune înainte de start.ps1.
  2. Verificați: curl -I https://merydion.eu/ nu mai afișează antetul X-Robots-Tag: noindex, iar https://merydion.eu/robots.txt indică https://merydion.eu/sitemap.xml.
  3. În Google Search Console și în Bing Webmaster Tools, verificați domeniul cu o înregistrare DNS și trimiteți https://merydion.eu/sitemap.xml.
  4. Pentru a scoate din nou site-ul din motoarele de căutare, goliți variabila și recreați containerul: fiecare răspuns spune din nou noindex, iar motoarele de căutare elimină paginile la următoarea vizită.

Sfat Un portal generat pentru o altă adresă setează MERYDION_SITE_ORIGIN (de exemplu https://www.example.com) la generare: adresele canonice, alternativele de limbă, previzualizările și sitemapurile indică atunci acea adresă. Pagina unei adrese inexistente răspunde în limba dosarului său, cu codul de stare 404.

Content-Security-Policy a portalului

Paginile portalului rulează sub o Content-Security-Policy strictă trimisă de gateway: o pagină poate folosi doar propriile fișiere, cereri către propria origine, imagini și din data: și blob:, și niciun cadru al altui site. Asta împiedică un fragment de marcaj rătăcit să ruleze cod. Singura excepție sunt statisticile de vizitare: paginile care pot număra vizitele admit și gtag.js de la Google, doar pe calea sa, și colectarea Google Analytics, care se încarcă numai după ce un vizitator acceptă.

  1. Un portal personalizat cu scripturi sau stiluri scrise în interiorul paginilor nu funcționează: scripturile și stilurile merg în fișiere proprii.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE și window.MERYDION_DIAGNOSTICS_BASE pot muta o familie de cereri doar sub o altă cale a aceleiași origini; o adresă pe altă origine este ignorată, cu o eroare în consola browserului.
  3. Paginile consolei instalării au politica fără excepția pentru statistici și, în plus, nu pot fi afișate într-un cadru.
  4. Politica se află în apps/portal-csp.mjs și în cele trei Caddyfile, iar un test le ține identice: modificați-o în toate cele patru locuri deodată.

Sfat Formularul de autentificare al serviciului de identitate și pagina de refuz a consolei sosesc cu o politică proprie, și mai strictă.

Înapoi la ghid

Productivitate, made in Italy.

Aduceți întreaga suită echipei dvs. — simplă, sigură și complet a dvs.