Vodič za instalaciju

Prva prijava i rad

Prvi administrator, nadogradnje, sigurnosne kopije, coming soon i sigurnosna politika.

Prvi administrator

Registracija je otvorena samo onima koji imaju kod pozivnice, a kodovi se generiraju u konzoli — koju još nitko ne može otvoriti. Prvi kod generira se na samom računalu.

  1. Slika: na poslužitelju, u korijenu repozitorija, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Mapa: u PowerShellu, u mapi, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Naredba ispisuje kod u obliku XXXX-XXXX-XXXX; invite-code 5 ispisuje pet.
  4. Na portalu kliknite Prijava, zatim Stvori račun: unesite kod, registrirajte se adresom e-pošte upisanom u ADMINISTRATORS i potvrdite je kodom iz poruke za potvrdu.
  5. Prijavite se: Dijagnostika, na dnu svake stranice, otvara konzolu, u kojoj se generiraju ostali kodovi pozivnica.

Savjet Ako poruka za potvrdu ne stigne, provjerite lozinku poštanskog sandučića: usluga prijave pri pokretanju javlja kada nedostaje.

Nadogradnja

Nadogradnja zamjenjuje sliku i zadržava podatke: oni su u volumenu spremnika, koji pripada projektu, a ne slici.

  1. Na razvojnom računalu, s ažuriranim repozitorijem, izgradite novu sliku: .\rebuild_container_release.ps1 -NoSeedData.
  2. Kopirajte je na poslužitelj, provjerite i učitajte kao prvi put: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Pokrenite istom naredbom kao prvi put: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d primjećuje novu sliku i ponovno stvara spremnik, s prekidom od nekoliko sekundi.
  4. Otvorite konzolu na kartici Nadogradnja: gdje redak prikazuje Dostupna nadogradnja, kliknite Pokreni nadogradnju — do tada podatkovne funkcije te usluge ostaju isključene.

Savjet Prije svake nadogradnje pogledajte u dijagnostici jesu li kopije baza podataka u redu (kartica „Kopije baza podataka“) i kopirajte datoteke: nadogradnja baza podataka radi na kopiji i čuva izvornik dok kopija nije provjerena, ali kopije su vaš vlastiti put natrag.

Kopije i vraćanje

Svaka usluga vodi neprekidnu kopiju baza podataka kojima upravlja — računi, indeksi dokumenata, pošta, razgovori — koja kasni najviše oko jedne sekunde, i može je vratiti na stanje u bilo kojem trenutku posljednjih sedam dana. Same datoteke — dokumenti, privici, pretpregledi — zapisuju se jednom i nikad se ne mijenjaju: kopiraju se zasebno ili se čuvaju u S3 bucketu.

  1. Premjestite kopije baza podataka izvan računala: registrirajte odredište klase backups na S3 bucketu ili na drugom disku i aktivirajte ga.
  2. Slika: kopirajte datoteke, bez baza podataka, dok radi: 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 .' zapisuje datiranu arhivu u mapu files.
  3. Mapa: zaustavite je naredbom .\stop.ps1, kopirajte cijelu mapu data, a zatim je ponovno pokrenite.
  4. Ako je administrator registrirao drugo odredište za datoteke, kopirajte njegovu mapu u istom krugu: datoteke nastale nakon njegove aktivacije nalaze se samo ondje.
  5. Čuvajte kopije daleko od računala koje štite.

Savjet Da biste jednu bazu podataka ili cijelu instalaciju vratili na stanje u određenom trenutku, zaustavite instalaciju i pokrenite merydion-storage copies restore (postupak „Kopije i vraćanje“ iz runbooka): naredba zapisuje vraćene baze podataka u novu mapu, koja zatim zauzima mjesto stare.

Stavljanje web-mjesta u coming soon

Coming soon svakom posjetitelju prikazuje samo stranicu pretpregleda dok se instalacija priprema: portal, aplikacije, Palatys i konzola čekaju iza nje, i za administratore.

  1. Prijavite se kao administrator i otvorite https://merydion.example.com/coming-soon.html?enabled=true: stranica potvrđuje i web-mjesto je u coming soon.
  2. Da biste web-mjesto ponovno uključili, otvorite https://merydion.example.com/coming-soon.html?enabled=false: nakon potvrde stranica vas vodi na početnu stranicu.
  3. Ako niste prijavljeni, stranica najprije traži prijavu; računu koji nije administrator to kaže i ništa se ne mijenja.
  4. Stanje je datoteka site/coming-soon u podatkovnoj mapi: njezinim uklanjanjem web-mjesto se ponovno uključuje i bez stranice.

Savjet Stranica coming soon postoji na engleskom i talijanskom; posjetitelj s drugim jezikom dobiva englesku.

Uključivanje statistike posjeta

Web-mjesto može brojati svoje posjete uslugom Google Analytics 4, a prije toga od svakog posjetitelja traži privolu: dok posjetitelj ne prihvati, ne učitava se ništa od Googlea. Statistika ostaje isključena dok instalacija ne navede svoj ID mjerenja, a administratorska je konzola nikada nema.

  1. U usluzi Google Analytics izradite entitet i web-tok podataka za adresu web-mjesta te kopirajte njegov ID mjerenja (počinje s G-).
  2. Slika: u datoteku .env pokraj docker-compose.yml dodajte MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX i ponovno stvorite spremnik naredbom docker compose up -d. Mapa: izvezite istu varijablu u sesiji prije start.ps1.
  3. Otvorite web-mjesto u privatnom prozoru: dolje lijevo pojavljuje se obavijest o statistici posjeta, a na dnu svake stranice „Postavke kolačića“.
  4. Da biste isključili statistiku, ispraznite varijablu i ponovno stvorite spremnik: obavijest nestaje, a preglednici onih koji su prihvatili prestaju učitavati Google Analytics.

Savjet Pravila o privatnosti i pravila o kolačićima već opisuju statistiku, na svakom jeziku, za instalaciju koja je uključi. U entitetu postavite zadržavanje podataka koje želite — Google čuva podatke posjeta najviše 14 mjeseci — i ostavite Googleove signale isključenima: web-mjesto ih isključuje i sa svoje strane.

Otvaranje web-mjesta tražilicama

Svaka instalacija poručuje tražilicama da je ne indeksiraju dok ne uključi indeksiranje: kopija web-mjesta koja nije službena — probna instalacija, instalacija neke organizacije — nikad mu ne konkurira u rezultatima. Adrese koje navode stranice, pretpregledi i karte web-mjesta upućuju na službeno web-mjesto, https://merydion.eu, a stranice računa, konzola i stranica nepostojeće adrese nikad ne ulaze u indeks.

  1. Samo na instalaciji koja poslužuje službeno web-mjesto. Slika: u datoteku .env pokraj docker-compose.yml dodajte MERYDION_SITE_INDEXING=1 i ponovno stvorite spremnik naredbom docker compose up -d. Mapa: izvezite istu varijablu u sesiji prije start.ps1.
  2. Provjera: curl -I https://merydion.eu/ više ne prikazuje zaglavlje X-Robots-Tag: noindex, a https://merydion.eu/robots.txt upućuje na https://merydion.eu/sitemap.xml.
  3. U uslugama Google Search Console i Bing Webmaster Tools potvrdite domenu DNS zapisom i pošaljite https://merydion.eu/sitemap.xml.
  4. Da biste web-mjesto ponovno uklonili s tražilica, ispraznite varijablu i ponovno stvorite spremnik: svaki odgovor opet kaže noindex, a tražilice izbacuju stranice pri sljedećem posjetu.

Savjet Portal generiran za drugu adresu pri generiranju postavlja MERYDION_SITE_ORIGIN (na primjer https://www.example.com): kanonske adrese, alternativne jezične inačice, pretpregledi i karte web-mjesta tada navode tu adresu. Stranica nepostojeće adrese odgovara na jeziku svoje mape, sa statusom 404.

Content-Security-Policy portala

Stranice portala rade pod strogom Content-Security-Policy koju šalje pristupnik: stranica smije koristiti samo vlastite datoteke, zahtjeve prema vlastitom podrijetlu, slike i iz data: i blob: te nijedan okvir drugog web-mjesta. Upravo to sprječava zalutali komadić oznaka da izvrši kod. Jedina je iznimka statistika posjeta: stranice koje mogu brojati posjete dopuštaju i gtag.js tvrtke Google, samo na njegovoj putanji, te prikupljanje podataka usluge Google Analytics, koji se učitavaju tek nakon što posjetitelj prihvati.

  1. Prilagođeni portal sa skriptama ili stilovima napisanima unutar stranica ne radi: skripte i stilovi idu u vlastite datoteke.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE i window.MERYDION_DIAGNOSTICS_BASE mogu premjestiti obitelj zahtjeva samo pod drugu putanju istog podrijetla; adresa na drugom podrijetlu zanemaruje se, uz pogrešku u konzoli preglednika.
  3. Stranice konzole instalacije imaju politiku bez iznimke za statistiku i, osim toga, ne mogu se prikazati unutar okvira.
  4. Politika se nalazi u apps/portal-csp.mjs i u tri datoteke Caddyfile, a test ih drži jednakima: mijenjajte je na sva četiri mjesta odjednom.

Savjet Obrazac za prijavu usluge identiteta i stranica odbijanja konzole dolaze s vlastitom, još strožom politikom.

Natrag na vodič

Produktivnost, made in Italy.

Donesite cijeli paket svom timu — jednostavan, siguran i posve vaš.