Asennusopas

Ensimmäinen kirjautuminen ja ylläpito

Ensimmäinen ylläpitäjä, päivitykset, varmuuskopiot, coming soon ja tietoturvakäytäntö.

Ensimmäinen ylläpitäjä

Rekisteröityminen on avoinna vain kutsukoodin haltijoille, ja koodit luodaan konsolissa — jota kukaan ei vielä voi avata. Ensimmäinen koodi luodaan itse koneella.

  1. Levykuva: palvelimella tietovaraston juuressa docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Kansio: PowerShellissä kansiossa $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Komento tulostaa koodin muodossa XXXX-XXXX-XXXX; invite-code 5 tulostaa viisi.
  4. Napsauta portaalissa Kirjaudu sisään ja sitten Luo tili: syötä koodi, rekisteröidy tiedostoon ADMINISTRATORS kirjoittamallasi sähköpostiosoitteella ja vahvista se vahvistusviestin koodilla.
  5. Kirjaudu sisään: Diagnostiikka jokaisen sivun alaosassa avaa konsolin, jossa muut kutsukoodit luodaan.

Vinkki Jos vahvistusviesti ei saavu, tarkista postilaatikon salasana: kirjautumispalvelu kertoo käynnistyessään, jos se puuttuu.

Päivittäminen

Päivitys korvaa levykuvan ja säilyttää tiedot: ne ovat kontin taltiossa, joka kuuluu projektille eikä levykuvalle.

  1. Koosta kehityskoneella päivitetyn tietovaraston kanssa uusi levykuva: .\rebuild_container_release.ps1 -NoSeedData.
  2. Kopioi se palvelimelle, tarkista ja lataa se kuten ensimmäisellä kerralla: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Käynnistä samalla komennolla kuin ensimmäisellä kerralla: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d huomaa uuden levykuvan ja luo kontin uudelleen muutaman sekunnin katkolla.
  4. Avaa konsoli välilehdelle Päivitys: kun rivillä lukee Päivitys saatavilla, napsauta Suorita päivitys — siihen asti palvelun tietotoiminnot pysyvät pois käytöstä.

Vinkki Tarkista ennen jokaista päivitystä diagnostiikasta, että tietokantojen kopiot ovat kunnossa (kortti ”Tietokantojen kopiot”), ja kopioi tiedostot: tietokantojen päivitys toimii kopiolla ja pitää alkuperäisen, kunnes kopio on tarkistettu, mutta kopiot ovat oma tiesi takaisin.

Kopiot ja palautus

Jokainen palvelu pitää hallitsemistaan tietokannoista — tileistä, asiakirjojen indekseistä, postista, keskusteluista — jatkuvaa kopiota, joka on enintään noin sekunnin jäljessä, ja voi palauttaa sen minkä tahansa hetken tilaan viimeisten seitsemän päivän ajalta. Itse tiedostot — asiakirjat, liitteet, esikatselut — kirjoitetaan kerran, eivätkä ne muutu koskaan: ne kopioidaan erikseen tai säilytetään S3-säilössä.

  1. Siirrä tietokantojen kopiot pois koneelta: rekisteröi luokan backups kohde S3-säilöön tai toiselle levylle ja aktivoi se.
  2. Levykuva: kopioi tiedostot ilman tietokantoja sen ollessa käynnissä: 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 .' kirjoittaa päivätyn arkiston kansioon files.
  3. Kansio: pysäytä se komennolla .\stop.ps1, kopioi kansio data kokonaan ja käynnistä se sitten uudelleen.
  4. Jos ylläpitäjä on rekisteröinyt tiedostoille toisen kohteen, kopioi sen kansio samalla kierroksella: sen aktivoinnin jälkeen syntyneet tiedostot ovat vain siellä.
  5. Säilytä kopiot kaukana koneesta, jota ne suojaavat.

Vinkki Kun haluat palauttaa yhden tietokannan tai koko asennuksen jonkin hetken tilaan, pysäytä asennus ja suorita merydion-storage copies restore (runbookin menettely ”Kopiot ja palautus”): se kirjoittaa palautetut tietokannat uuteen kansioon, joka sitten korvaa vanhan.

Sivuston asettaminen coming soon -tilaan

Coming soon näyttää jokaiselle kävijälle vain esikatselusivun, kun asennusta valmistellaan: portaali, sovellukset, Palatys ja konsoli odottavat sen takana, myös ylläpitäjille.

  1. Kirjaudu sisään ylläpitäjänä ja avaa https://merydion.example.com/coming-soon.html?enabled=true: sivu vahvistaa, ja sivusto on coming soon -tilassa.
  2. Kytke sivusto takaisin päälle avaamalla https://merydion.example.com/coming-soon.html?enabled=false: vahvistuksen jälkeen sivu vie sinut etusivulle.
  3. Jos et ole kirjautunut, sivu pyytää ensin kirjautumaan; tilille, joka ei ole ylläpitäjä, se kertoo sen, eikä mikään muutu.
  4. Tila on tiedosto site/coming-soon tietokansiossa: sen poistaminen kytkee sivuston päälle myös ilman sivua.

Vinkki Coming soon -sivu on olemassa englanniksi ja italiaksi; muun kielen kävijä saa englanninkielisen.

Käyntitilastojen ottaminen käyttöön

Sivusto voi laskea käyntinsä Google Analytics 4:llä ja pyytää ensin jokaiselta kävijältä suostumuksen: ennen kuin kävijä hyväksyy, Googlelta ei ladata mitään. Tilastot pysyvät pois päältä, kunnes asennus ilmoittaa mittaustunnuksensa, eikä hallintakonsolissa ole niitä koskaan.

  1. Luo Google Analyticsissa mittauskokonaisuus ja verkkostriimi sivuston osoitteelle ja kopioi sen mittaustunnus (se alkaa merkeillä G-).
  2. Levykuva: lisää tiedostoon .env, joka on tiedoston docker-compose.yml vieressä, rivi MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX ja luo kontti uudelleen komennolla docker compose up -d. Kansio: aseta sama muuttuja istunnossa ennen komentoa start.ps1.
  3. Avaa sivusto yksityisessä ikkunassa: vasempaan alakulmaan ilmestyy käyntitilastoja koskeva ilmoitus, ja jokaisen sivun alareunaan ilmestyy ”Evästeasetukset”.
  4. Kun haluat poistaa tilastot käytöstä, tyhjennä muuttuja ja luo kontti uudelleen: ilmoitus katoaa, ja hyväksyneiden kävijöiden selaimet lakkaavat lataamasta Google Analyticsia.

Vinkki Tietosuojaseloste ja evästekäytäntö kuvaavat tilastot jo kaikilla kielillä asennukselle, joka ottaa ne käyttöön. Aseta mittauskokonaisuudessa haluamasi datansäilytys — Google säilyttää käynnin tiedot enintään 14 kuukautta — ja jätä Google-signaalit pois päältä: sivusto poistaa ne käytöstä myös omalta osaltaan.

Sivuston avaaminen hakukoneille

Jokainen asennus pyytää hakukoneita olemaan indeksoimatta sitä, kunnes se ottaa indeksoinnin käyttöön: sivuston kopio, joka ei ole virallinen — testiasennus, organisaation asennus — ei koskaan kilpaile sen kanssa tuloksissa. Sivujen, esikatselujen ja sivustokarttojen ilmoittamat osoitteet viittaavat viralliseen sivustoon, https://merydion.eu, eivätkä tilin sivut, konsoli tai olemattoman osoitteen sivu päädy koskaan indeksiin.

  1. Vain asennuksessa, joka tarjoilee virallisen sivuston. Levykuva: lisää tiedostoon .env, joka on tiedoston docker-compose.yml vieressä, rivi MERYDION_SITE_INDEXING=1 ja luo kontti uudelleen komennolla docker compose up -d. Kansio: aseta sama muuttuja istunnossa ennen komentoa start.ps1.
  2. Tarkista: curl -I https://merydion.eu/ ei enää näytä otsaketta X-Robots-Tag: noindex, ja https://merydion.eu/robots.txt viittaa osoitteeseen https://merydion.eu/sitemap.xml.
  3. Vahvista palveluissa Google Search Console ja Bing Webmaster Tools verkkotunnus DNS-tietueella ja lähetä niihin https://merydion.eu/sitemap.xml.
  4. Kun haluat poistaa sivuston taas hakukoneista, tyhjennä muuttuja ja luo kontti uudelleen: jokaisessa vastauksessa lukee taas noindex, ja hakukoneet poistavat sivut seuraavalla käynnillään.

Vinkki Toiselle osoitteelle luotava portaali asettaa muuttujan MERYDION_SITE_ORIGIN (esimerkiksi https://www.example.com), kun se luodaan: kanoniset osoitteet, kieliversiot, esikatselut ja sivustokartat viittaavat silloin siihen osoitteeseen. Olemattoman osoitteen sivu vastaa kansionsa kielellä tilakoodilla 404.

Portaalin Content-Security-Policy

Portaalin sivut toimivat yhdyskäytävän lähettämän tiukan Content-Security-Policyn alla: sivu saa käyttää vain omia tiedostojaan, pyyntöjä omaan alkuperäänsä, kuvia myös lähteistä data: ja blob:, eikä mitään toisen sivuston kehystä. Se estää eksynyttä merkintäkoodin palaa suorittamasta koodia. Ainoa poikkeus ovat käyntitilastot: sivut, jotka saavat laskea käyntejä, sallivat myös Googlen gtag.js:n vain sen omassa polussa sekä Google Analyticsin tiedonkeruun, ja ne latautuvat vasta, kun kävijä on hyväksynyt.

  1. Mukautettu portaali, jonka sivuille on kirjoitettu skriptejä tai tyylejä, ei toimi: skriptit ja tyylit kuuluvat omiin tiedostoihinsa.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE ja window.MERYDION_DIAGNOSTICS_BASE voivat siirtää pyyntöjen perheen vain saman alkuperän toisen polun alle; toisen alkuperän osoite ohitetaan, ja selaimen konsoliin tulee virhe.
  3. Asennuksen konsolin sivuilla on käytäntö ilman tilastojen poikkeusta, eikä niitä lisäksi voi näyttää kehyksen sisällä.
  4. Käytäntö on tiedostossa apps/portal-csp.mjs ja kolmessa Caddyfile-tiedostossa, ja testi pitää ne samoina: muuta sitä kaikissa neljässä paikassa yhtä aikaa.

Vinkki Identiteettipalvelun kirjautumislomake ja konsolin hylkäyssivu tulevat omalla, vielä tiukemmalla käytännöllään.

Takaisin oppaaseen

Tuottavuutta, made in Italy.

Tuo koko paketti tiimillesi — yksinkertainen, turvallinen ja täysin sinun.