Vodnik po namestitvi

Prva prijava in delovanje

Prvi skrbnik, nadgradnje, varnostne kopije, coming soon in varnostni pravilnik.

Prvi skrbnik

Registracija je odprta samo tistim, ki imajo kodo povabila, kode pa se ustvarjajo v konzoli — ki je še nihče ne more odpreti. Prva koda se ustvari na samem računalniku.

  1. Slika: na strežniku v korenu skladišča 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: v PowerShellu v mapi $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Ukaz izpiše kodo v obliki XXXX-XXXX-XXXX; invite-code 5 jih izpiše pet.
  4. Na portalu kliknite Prijava, nato Ustvari račun: vnesite kodo, registrirajte se z e-poštnim naslovom iz ADMINISTRATORS in ga potrdite s kodo iz potrditvenega sporočila.
  5. Prijavite se: Diagnostika na dnu vsake strani odpre konzolo, kjer se ustvarjajo druge kode povabil.

Nasvet Če potrditveno sporočilo ne prispe, preverite geslo poštnega predala: storitev za prijavo ob zagonu sporoči, ko manjka.

Nadgradnja

Nadgradnja zamenja sliko in ohrani podatke: ti so v nosilcu vsebnika, ki pripada projektu, ne sliki.

  1. Na razvojnem računalniku s posodobljenim skladiščem zgradite novo sliko: .\rebuild_container_release.ps1 -NoSeedData.
  2. Kopirajte jo na strežnik, preverite in naložite kot prvič: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Zaženite z istim ukazom kot prvič: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d opazi novo sliko in znova ustvari vsebnik, s prekinitvijo nekaj sekund.
  4. Odprite konzolo na zavihku Nadgradnja: kjer vrstica kaže Na voljo je nadgradnja, kliknite Zaženi nadgradnjo — do takrat ostanejo podatkovne funkcije te storitve izklopljene.

Nasvet Pred vsako nadgradnjo v diagnostiki preverite, ali so kopije podatkovnih baz v redu (kartica „Kopije podatkovnih baz“), in kopirajte datoteke: nadgradnja podatkovnih baz dela na kopiji in ohrani izvirnik, dokler kopija ni preverjena, a kopije so vaša lastna pot nazaj.

Kopije in obnovitev

Vsaka storitev vzdržuje neprekinjeno kopijo podatkovnih baz, ki jih upravlja — računi, kazala dokumentov, pošta, klepeti —, z zaostankom največ približno ene sekunde, in jih lahko obnovi na stanje v katerem koli trenutku zadnjih sedmih dni. Same datoteke — dokumenti, priloge, predogledi — se zapišejo enkrat in se nikoli ne spremenijo: kopirajo se posebej ali pa so shranjene v vedru S3.

  1. Kopije podatkovnih baz prenesite stran od računalnika: registrirajte cilj razreda backups v vedru S3 ali na drugem disku in ga aktivirajte.
  2. Slika: kopirajte datoteke brez podatkovnih baz, medtem ko teče: 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 .' zapiše datiran arhiv v mapo files.
  3. Mapa: ustavite jo z .\stop.ps1, kopirajte celotno mapo data, nato jo znova zaženite.
  4. Če je skrbnik za datoteke registriral drug cilj, kopirajte njegovo mapo v istem krogu: datoteke, nastale po njegovi aktivaciji, so samo tam.
  5. Kopije hranite daleč od računalnika, ki ga ščitijo.

Nasvet Če želite eno podatkovno bazo ali celotno namestitev vrniti na stanje v določenem trenutku, ustavite namestitev in zaženite merydion-storage copies restore (postopek „Kopije in obnovitev“ v priročniku): ukaz zapiše obnovljene podatkovne baze v novo mapo, ki nato nadomesti staro.

Preklop spletnega mesta v coming soon

Coming soon vsakemu obiskovalcu prikaže samo stran s predogledom, medtem ko se namestitev pripravlja: portal, aplikacije, Palatys in konzola čakajo za njo, tudi za skrbnike.

  1. Prijavite se kot skrbnik in odprite https://merydion.example.com/coming-soon.html?enabled=true: stran potrdi in spletno mesto je v coming soon.
  2. Če želite spletno mesto znova vklopiti, odprite https://merydion.example.com/coming-soon.html?enabled=false: po potrditvi vas stran pelje na domačo stran.
  3. Če niste prijavljeni, vas stran najprej prosi za prijavo; računu, ki ni skrbnik, to pove in nič se ne spremeni.
  4. Stanje je datoteka site/coming-soon v podatkovni mapi: njena odstranitev znova vklopi spletno mesto tudi brez strani.

Nasvet Stran coming soon obstaja v angleščini in italijanščini; obiskovalec z drugim jezikom dobi angleško.

Vklop statistike obiskov

Spletno mesto lahko šteje svoje obiske s storitvijo Google Analytics 4, pri čemer vsakega obiskovalca najprej vpraša za privolitev: dokler obiskovalec ne sprejme, se nič od Googla ne naloži. Statistika ostane izklopljena, dokler namestitev ne navede svojega ID-ja meritve, skrbniška konzola pa je nima nikoli.

  1. V storitvi Google Analytics ustvarite lastnost in spletni podatkovni tok za naslov spletnega mesta ter kopirajte njegov ID meritve (začne se z G-).
  2. Slika: v datoteko .env poleg docker-compose.yml dodajte MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX in znova ustvarite vsebnik z docker compose up -d. Mapa: izvozite isto spremenljivko v seji pred start.ps1.
  3. Odprite spletno mesto v zasebnem oknu: spodaj levo se prikaže obvestilo o statistiki obiskov, na dnu vsake strani pa „Nastavitve piškotkov“.
  4. Če želite statistiko izklopiti, izpraznite spremenljivko in znova ustvarite vsebnik: obvestilo izgine, brskalniki tistih, ki so sprejeli, pa nehajo nalagati Google Analytics.

Nasvet Politika zasebnosti in politika piškotkov že opisujeta statistiko, v vsakem jeziku, za namestitev, ki jo vklopi. V lastnosti nastavite želeno hrambo podatkov — Google hrani podatke obiska največ 14 mesecev — in pustite Googlove signale izklopljene: spletno mesto jih izklopi tudi na svoji strani.

Odprtje spletnega mesta za iskalnike

Vsaka namestitev iskalnikom sporoča, naj je ne indeksirajo, dokler sama ne vklopi indeksiranja: neuradna kopija spletnega mesta — preizkusna namestitev, namestitev organizacije — uradnemu nikoli ne konkurira v rezultatih. Naslovi, ki jih navajajo strani, predogledi in zemljevidi spletnega mesta, kažejo na uradno spletno mesto https://merydion.eu, strani računa, konzola in stran neobstoječega naslova pa nikoli ne pridejo v indeks.

  1. Samo v namestitvi, ki streže uradno spletno mesto. Slika: v datoteko .env poleg docker-compose.yml dodajte MERYDION_SITE_INDEXING=1 in znova ustvarite vsebnik z docker compose up -d. Mapa: izvozite isto spremenljivko v seji pred start.ps1.
  2. Preverite: curl -I https://merydion.eu/ ne prikazuje več glave X-Robots-Tag: noindex, https://merydion.eu/robots.txt pa kaže na https://merydion.eu/sitemap.xml.
  3. V Google Search Console in v Bing Webmaster Tools potrdite domeno z zapisom DNS in oddajte https://merydion.eu/sitemap.xml.
  4. Če želite spletno mesto znova umakniti iz iskalnikov, izpraznite spremenljivko in znova ustvarite vsebnik: vsak odgovor spet vsebuje noindex, iskalniki pa strani ob naslednjem obisku odstranijo.

Nasvet Portal, ustvarjen za drug naslov, ob ustvarjanju nastavi MERYDION_SITE_ORIGIN (na primer https://www.example.com): kanonični naslovi, jezikovne različice, predogledi in zemljevidi spletnega mesta nato kažejo na ta naslov. Stran neobstoječega naslova odgovori v jeziku svoje mape, s statusno kodo 404.

Content-Security-Policy portala

Strani portala delujejo pod strogim pravilnikom Content-Security-Policy, ki ga pošilja prehod: stran sme uporabljati samo lastne datoteke, zahteve do lastnega izvora, slike tudi iz data: in blob: ter nobenega okvira drugega spletnega mesta. Prav to preprečuje, da bi zabloden košček označevanja izvedel kodo. Edina izjema je statistika obiskov: strani, ki lahko štejejo obiske, dovolijo tudi gtag.js družbe Google, samo na njegovi poti, in zbiranje podatkov storitve Google Analytics, ki se naložita šele, ko obiskovalec sprejme.

  1. Prilagojen portal s skripti ali slogi, zapisanimi v straneh, ne deluje: skripti in slogi gredo v lastne datoteke.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE in window.MERYDION_DIAGNOSTICS_BASE lahko družino zahtev premaknejo samo pod drugo pot istega izvora; naslov na drugem izvoru se prezre, z napako v konzoli brskalnika.
  3. Strani konzole namestitve imajo pravilnik brez izjeme za statistiko in jih poleg tega ni mogoče prikazati v okviru.
  4. Pravilnik je v apps/portal-csp.mjs in v treh datotekah Caddyfile, test pa jih ohranja enake: spreminjajte ga na vseh štirih mestih hkrati.

Nasvet Obrazec za prijavo storitve identitete in stran zavrnitve konzole prideta z lastnim, še strožjim pravilnikom.

Nazaj na vodnik

Produktivnost, made in Italy.

Prinesite celotno zbirko svoji ekipi – preprosto, varno in povsem vašo.