Diegimo vadovas

Pirmasis prisijungimas ir eksploatavimas

Pirmasis administratorius, naujinimai, atsarginės kopijos, coming soon ir saugos politika.

Pirmasis administratorius

Registracija atvira tik turintiems kvietimo kodą, o kodai kuriami konsolėje — kurios dar niekas negali atidaryti. Pirmasis kodas sukuriamas pačiame kompiuteryje.

  1. Atvaizdas: serveryje, saugyklos šaknyje, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Aplankas: PowerShell lange, aplanke, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Komanda išveda XXXX-XXXX-XXXX formos kodą; invite-code 5 išveda penkis.
  4. Portale spustelėkite Prisijungti, tada Sukurti paskyrą: įveskite kodą, užsiregistruokite el. pašto adresu, įrašytu į ADMINISTRATORS, ir patvirtinkite jį patvirtinimo laiško kodu.
  5. Prisijunkite: Diagnostika kiekvieno puslapio apačioje atidaro konsolę, kurioje kuriami kiti kvietimo kodai.

Patarimas Jei patvirtinimo laiškas neateina, patikrinkite pašto dėžutės slaptažodį: prisijungimo paslauga paleidžiama praneša, kai jo trūksta.

Naujinimas

Naujinimas pakeičia atvaizdą ir išsaugo duomenis: jie yra konteinerio tome, kuris priklauso projektui, o ne atvaizdui.

  1. Kūrimo kompiuteryje su atnaujinta saugykla sukurkite naują atvaizdą: .\rebuild_container_release.ps1 -NoSeedData.
  2. Nukopijuokite jį į serverį, patikrinkite ir įkelkite kaip pirmą kartą: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Paleiskite ta pačia komanda kaip pirmą kartą: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d pastebi naują atvaizdą ir iš naujo sukuria konteinerį, su kelių sekundžių pertrauka.
  4. Atidarykite konsolę skirtuke Naujinimas: kur eilutė rodo Yra naujinimas, spustelėkite Vykdyti naujinimą — iki tol tos paslaugos duomenų funkcijos lieka išjungtos.

Patarimas Prieš kiekvieną naujinimą diagnostikoje patikrinkite, ar duomenų bazių kopijos tvarkingos (kortelė „Duomenų bazių kopijos“), ir nukopijuokite failus: duomenų bazių naujinimas dirba su kopija ir išlaiko originalą, kol kopija patikrinama, bet kopijos yra jūsų pačių kelias atgal.

Kopijos ir atkūrimas

Kiekviena paslauga palaiko nuolatinę savo tvarkomų duomenų bazių — paskyrų, dokumentų indeksų, pašto, pokalbių — kopiją, kuri atsilieka daugiausia maždaug sekunde, ir gali atkurti jų būseną bet kuriuo paskutinių septynių dienų momentu. Patys failai — dokumentai, priedai, peržiūros — įrašomi vieną kartą ir niekada nesikeičia: jie kopijuojami atskirai arba laikomi S3 talpykloje.

  1. Iškelkite duomenų bazių kopijas iš kompiuterio: užregistruokite klasės backups paskirties vietą S3 talpykloje arba kitame diske ir ją aktyvinkite.
  2. Atvaizdas: kopijuokite failus be duomenų bazių, kol jis veikia: 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 .' įrašo archyvą su data į aplanką files.
  3. Aplankas: sustabdykite jį su .\stop.ps1, nukopijuokite visą aplanką data, tada vėl jį paleiskite.
  4. Jei administratorius užregistravo kitą failų paskirties vietą, nukopijuokite jos aplanką tame pačiame rate: po jos aktyvinimo sukurti failai yra tik ten.
  5. Kopijas laikykite toli nuo kompiuterio, kurį jos saugo.

Patarimas Norėdami grąžinti vienos duomenų bazės arba viso diegimo būseną tam tikru momentu, sustabdykite diegimą ir paleiskite merydion-storage copies restore (runbook procedūra „Kopijos ir atkūrimas“): komanda įrašo atkurtas duomenų bazes į naują aplanką, kuris paskui užima senojo vietą.

Svetainės perjungimas į coming soon

Coming soon kiekvienam lankytojui rodo tik peržiūros puslapį, kol ruošiamas diegimas: portalas, programos, Palatys ir konsolė laukia už jo, taip pat ir administratoriams.

  1. Prisijunkite kaip administratorius ir atverkite https://merydion.example.com/coming-soon.html?enabled=true: puslapis patvirtina, ir svetainė yra coming soon būsenos.
  2. Norėdami svetainę vėl įjungti, atverkite https://merydion.example.com/coming-soon.html?enabled=false: po patvirtinimo puslapis nuveda jus į pradžios puslapį.
  3. Jei nesate prisijungę, puslapis pirmiausia paprašo prisijungti; paskyrai, kuri nėra administratoriaus, jis tai pasako, ir niekas nesikeičia.
  4. Būsena yra failas site/coming-soon duomenų aplanke: jį pašalinus svetainė vėl įjungiama ir be puslapio.

Patarimas Coming soon puslapis yra anglų ir italų kalbomis; kitos kalbos lankytojas gauna anglišką.

Apsilankymų statistikos įjungimas

Svetainė gali skaičiuoti savo apsilankymus su „Google Analytics 4“, pirmiausia paprašydama kiekvieno lankytojo sutikimo: kol lankytojas nesutinka, iš „Google“ nieko neįkeliama. Statistika lieka išjungta, kol diegimas nenurodo savo įvertinimo ID, o administravimo konsolėje jos niekada nėra.

  1. Paslaugoje „Google Analytics“ sukurkite nuosavybę ir svetainės adreso žiniatinklio duomenų srautą, tada nukopijuokite jo įvertinimo ID (prasideda G-).
  2. Atvaizdas: faile .env šalia docker-compose.yml pridėkite MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX ir iš naujo sukurkite konteinerį su docker compose up -d. Aplankas: tą patį kintamąjį eksportuokite sesijoje prieš start.ps1.
  3. Atverkite svetainę privačiame lange: apačioje kairėje pasirodo pranešimas apie apsilankymų statistiką, o kiekvieno puslapio apačioje – „Slapukų nuostatos“.
  4. Norėdami statistiką išjungti, ištuštinkite kintamąjį ir iš naujo sukurkite konteinerį: pranešimas dingsta, o sutikusių lankytojų naršyklės nebeįkelia „Google Analytics“.

Patarimas Privatumo politika ir slapukų politika jau aprašo statistiką visomis kalbomis tam diegimui, kuris ją įjungia. Nuosavybėje nustatykite norimą duomenų saugojimo laikotarpį – „Google“ apsilankymo duomenis saugo ne ilgiau kaip 14 mėnesių – ir palikite „Google Signals“ išjungtą: svetainė ją išjungia ir iš savo pusės.

Svetainės pateikimas paieškos sistemoms

Kiekvienas diegimas liepia paieškos sistemoms jo neindeksuoti, kol pats neįjungia indeksavimo: neoficiali svetainės kopija – bandomasis diegimas, organizacijos diegimas – niekada nekonkuruoja su oficialiąja paieškos rezultatuose. Adresai, kuriuos skelbia puslapiai, peržiūros ir svetainės schemos, nurodo oficialią svetainę https://merydion.eu, o paskyros puslapiai, konsolė ir neegzistuojančio adreso puslapis į indeksą niekada nepatenka.

  1. Tik diegime, kuris aptarnauja oficialią svetainę. Atvaizdas: faile .env šalia docker-compose.yml pridėkite MERYDION_SITE_INDEXING=1 ir iš naujo sukurkite konteinerį su docker compose up -d. Aplankas: tą patį kintamąjį eksportuokite sesijoje prieš start.ps1.
  2. Patikrinkite: curl -I https://merydion.eu/ neberodo antraštės X-Robots-Tag: noindex, o https://merydion.eu/robots.txt nurodo https://merydion.eu/sitemap.xml.
  3. Paslaugose „Google Search Console“ ir „Bing Webmaster Tools“ patvirtinkite domeną DNS įrašu ir pateikite https://merydion.eu/sitemap.xml.
  4. Norėdami svetainę vėl pašalinti iš paieškos sistemų, ištuštinkite kintamąjį ir iš naujo sukurkite konteinerį: kiekvienas atsakymas vėl skelbia noindex, o paieškos sistemos per kitą apsilankymą puslapius pašalina.

Patarimas Kitam adresui skirtas portalas generuojamas nustačius MERYDION_SITE_ORIGIN (pavyzdžiui, https://www.example.com): tada kanoniniai adresai, alternatyvios kalbų versijos, peržiūros ir svetainės schemos nurodo tą adresą. Neegzistuojančio adreso puslapis atsako savo aplanko kalba, su būsenos kodu 404.

Portalo Content-Security-Policy

Portalo puslapiai veikia pagal griežtą Content-Security-Policy, kurią siunčia šliuzas: puslapis gali naudoti tik savo failus, užklausas savo kilmei, vaizdus ir iš data: bei blob:, ir jokio kitos svetainės rėmelio. Būtent tai neleidžia pasiklydusiam žymėjimo fragmentui vykdyti kodo. Vienintelė išimtis – apsilankymų statistika: puslapiai, kuriems leidžiama skaičiuoti apsilankymus, taip pat įsileidžia „Google“ gtag.js, tik jo kelyje, ir „Google Analytics“ duomenų rinkimą, kurie įkeliami tik lankytojui sutikus.

  1. Pritaikytas portalas su scenarijais ar stiliais, įrašytais į jo puslapius, neveikia: scenarijai ir stiliai dedami į atskirus failus.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE ir window.MERYDION_DIAGNOSTICS_BASE gali perkelti užklausų šeimą tik po kitu tos pačios kilmės keliu; kitos kilmės adresas ignoruojamas, o naršyklės konsolėje parodoma klaida.
  3. Diegimo konsolės puslapiai turi politiką be statistikos išimties ir, be to, negali būti rodomi rėmelyje.
  4. Politika yra faile apps/portal-csp.mjs ir trijuose Caddyfile, o testas juos palaiko vienodus: keiskite ją visose keturiose vietose vienu metu.

Patarimas Tapatybės paslaugos prisijungimo forma ir konsolės atmetimo puslapis ateina su savo, dar griežtesne politika.

Grįžti į vadovą

Produktyvumas, made in Italy.

Suteikite visą rinkinį savo komandai – paprastą, saugų ir visiškai jūsų.