Paigaldusjuhend

Esimene sisselogimine ja käitamine

Esimene administraator, uuendused, varukoopiad, coming soon ja turbepoliitika.

Esimene administraator

Registreerumine on avatud ainult neile, kellel on kutsekood, ja koodid luuakse konsoolis — mida keegi veel avada ei saa. Esimene kood luuakse arvutis endas.

  1. Tõmmis: serveris, hoidla juurkaustas, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Kaust: PowerShellis, kaustas, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Käsk prindib koodi kujul XXXX-XXXX-XXXX; invite-code 5 prindib viis.
  4. Klõpsa portaalis Logi sisse ja seejärel Loo konto: sisesta kood, registreeru failis ADMINISTRATORS kirjas oleva e-postiga ja kinnita see kinnituskirja koodiga.
  5. Logi sisse: Diagnostika iga lehe allosas avab konsooli, kus luuakse ülejäänud kutsekoodid.

Näpunäide Kui kinnituskiri ei saabu, kontrolli postkasti parooli: sisselogimisteenus ütleb käivitusel, kui see puudub.

Uuendamine

Uuendus asendab tõmmise ja säilitab andmed: need on konteineri köites, mis kuulub projektile, mitte tõmmisele.

  1. Ehita arendusarvutis uuendatud hoidlaga uus tõmmis: .\rebuild_container_release.ps1 -NoSeedData.
  2. Kopeeri see serverisse, kontrolli ja laadi nagu esimesel korral: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Käivita sama käsuga nagu esimesel korral: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d märkab uut tõmmist ja loob konteineri uuesti, mõnesekundilise katkestusega.
  4. Ava konsool vahekaardil Uuendamine: kus rida näitab Uuendus saadaval, klõpsa Käivita uuendamine — seni jäävad selle teenuse andmefunktsioonid välja.

Näpunäide Vaata enne iga uuendust diagnostikast järele, et andmebaaside koopiad on korras (kaart „Andmebaaside koopiad“), ja kopeeri failid: andmebaaside uuendamine töötab koopia peal ja hoiab originaali, kuni koopia on kontrollitud, kuid koopiad on sinu enda tee tagasi.

Koopiad ja taastamine

Iga teenus hoiab oma andmebaasidest — kontodest, dokumentide indeksitest, postist, vestlustest — pidevat koopiat, mis jääb maha kõige rohkem umbes sekundi võrra, ja suudab selle taastada viimase seitsme päeva mis tahes hetke seisu. Failid ise — dokumendid, manused, eelvaated — kirjutatakse üks kord ega muutu enam kunagi: need kopeeritakse eraldi või hoitakse S3 ämbris.

  1. Vii andmebaaside koopiad arvutist välja: registreeri klassi backups sihtkoht S3 ämbris või teisel kettal ja aktiveeri see.
  2. Tõmmis: kopeeri failid ilma andmebaasideta, samal ajal kui see töötab: 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 .' kirjutab dateeritud arhiivi kausta files.
  3. Kaust: peata see käsuga .\stop.ps1, kopeeri kaust data tervikuna ja käivita see siis uuesti.
  4. Kui administraator on failidele registreerinud muu sihtkoha, kopeeri selle kaust samal korral: pärast selle aktiveerimist loodud failid on ainult seal.
  5. Hoia koopiaid kaugel arvutist, mida need kaitsevad.

Näpunäide Et viia üks andmebaas või kogu paigaldus tagasi mõne hetke seisu, peata paigaldus ja käivita merydion-storage copies restore (käsiraamatu protseduur „Koopiad ja taastamine“): see kirjutab taastatud andmebaasid uude kausta, mis võtab seejärel vana kausta koha.

Saidi viimine coming soon olekusse

Coming soon näitab igale külastajale ainult eelvaatelehte, kuni paigaldus valmib: portaal, rakendused, Palatys ja konsool ootavad selle taga, ka administraatorite jaoks.

  1. Logi sisse administraatorina ja ava https://merydion.example.com/coming-soon.html?enabled=true: leht kinnitab ja sait on coming soon olekus.
  2. Saidi uuesti sisselülitamiseks ava https://merydion.example.com/coming-soon.html?enabled=false: pärast kinnitust viib leht sind avalehele.
  3. Kui sa pole sisse logitud, palub leht sul kõigepealt sisse logida; kontole, mis pole administraator, ütleb see seda ja midagi ei muutu.
  4. Olek on fail site/coming-soon andmekaustas: selle eemaldamine lülitab saidi uuesti sisse ka ilma leheta.

Näpunäide Coming soon leht on olemas inglise ja itaalia keeles; muu keelega külastaja saab ingliskeelse.

Külastusstatistika sisselülitamine

Sait saab oma külastusi loendada Google Analytics 4-ga, küsides enne igalt külastajalt nõusolekut: kuni külastaja pole nõustunud, ei laadita Google'ilt midagi. Statistika jääb välja lülitatuks, kuni paigaldus annab oma mõõtmise ID (measurement ID), ja halduskonsoolis pole seda kunagi.

  1. Loo Google Analyticsis saidi aadressi jaoks atribuut (property) ja veebi andmevoog (web data stream) ning kopeeri selle mõõtmise ID (measurement ID), mis algab tähtedega G-.
  2. Tõmmis: lisa faili .env faili docker-compose.yml kõrval rida MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX ja loo konteiner uuesti käsuga docker compose up -d. Kaust: ekspordi sama muutuja seansis enne käsku start.ps1.
  3. Ava sait privaatses aknas: all vasakul ilmub külastusstatistika teade ja iga lehe allosas ilmub „Küpsiste eelistused“.
  4. Statistika väljalülitamiseks tühjenda muutuja ja loo konteiner uuesti: teade kaob ning nende brauserid, kes olid nõustunud, lõpetavad Google Analyticsi laadimise.

Näpunäide Privaatsuspoliitika ja küpsiste poliitika kirjeldavad statistikat juba kõigis keeltes, kui paigaldus selle sisse lülitab. Määra atribuudis (property) soovitud andmete säilitamise aeg — Google hoiab külastuse andmeid kõige rohkem 14 kuud — ja jäta Google'i signaalid (Google signals) välja: sait lülitab need ka omalt poolt välja.

Saidi avamine otsingumootoritele

Iga paigaldus annab otsingumootoritele teada, et seda ei tohi indekseerida, kuni see pole indekseerimist sisse lülitanud: saidi mitteametlik koopia — testpaigaldus, mõne organisatsiooni paigaldus — ei konkureeri tulemustes kunagi ametliku saidiga. Aadressid, mida lehed, eelvaated ja saidikaardid esitavad, osutavad ametlikule saidile https://merydion.eu ning konto lehed, konsool ja olematu aadressi leht ei jõua kunagi indeksisse.

  1. Ainult paigalduses, kus töötab ametlik sait. Tõmmis: lisa faili .env faili docker-compose.yml kõrval rida MERYDION_SITE_INDEXING=1 ja loo konteiner uuesti käsuga docker compose up -d. Kaust: ekspordi sama muutuja seansis enne käsku start.ps1.
  2. Kontrolli: curl -I https://merydion.eu/ ei näita enam päist X-Robots-Tag: noindex ja https://merydion.eu/robots.txt viitab aadressile https://merydion.eu/sitemap.xml.
  3. Kinnita teenustes Google Search Console ja Bing Webmaster Tools domeen DNS-kirjega ning esita https://merydion.eu/sitemap.xml.
  4. Et sait otsingumootoritest uuesti ära võtta, tühjenda muutuja ja loo konteiner uuesti: iga vastus ütleb jälle noindex ning otsingumootorid eemaldavad lehed järgmisel külastusel.

Näpunäide Teise aadressi jaoks genereeritud portaal määrab genereerimisel muutuja MERYDION_SITE_ORIGIN (näiteks https://www.example.com): kanoonilised aadressid, alternatiivsed keeleversioonid, eelvaated ja saidikaardid osutavad siis sellele aadressile. Olematu aadressi leht vastab oma kausta keeles, olekukoodiga 404.

Portaali Content-Security-Policy

Portaali lehed töötavad range Content-Security-Policy all, mille saadab lüüs: leht tohib kasutada ainult oma faile, päringuid oma päritolule, pilte ka allikatest data: ja blob: ning mitte ühtegi teise saidi raami. See takistab sissetrüginud märgendikillul koodi käivitamast. Ainus erand on külastusstatistika: lehed, mis tohivad külastusi loendada, lubavad ka Google'i gtag.js-i, ainult selle teel, ja Google Analyticsi andmekogumise, mis laaditakse alles pärast seda, kui külastaja on nõustunud.

  1. Kohandatud portaal, mille lehtedesse on kirjutatud skriptid või stiilid, ei tööta: skriptid ja stiilid käivad eraldi failidesse.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE ja window.MERYDION_DIAGNOSTICS_BASE saavad päringute perekonda viia ainult sama päritolu teise tee alla; teise päritolu aadressi eiratakse ja brauseri konsoolis kuvatakse viga.
  3. Paigalduse konsooli lehtedel on poliitika ilma statistika eranditata ja lisaks ei saa neid näidata raami sees.
  4. Poliitika asub failis apps/portal-csp.mjs ja kolmes Caddyfile'is ning test hoiab need ühesugused: muuda seda kõigis neljas kohas korraga.

Näpunäide Identiteediteenuse sisselogimisvorm ja konsooli keeldumisleht tulevad oma, veelgi rangema poliitikaga.

Tagasi juhendi juurde

Tootlikkus, made in Italy.

Too kogu komplekt oma meeskonnale — lihtne, turvaline ja täielikult sinu oma.