Instalēšanas ceļvedis

Pirmā pieteikšanās un ekspluatācija

Pirmais administrators, jauninājumi, rezerves kopijas, coming soon un drošības politika.

Pirmais administrators

Reģistrācija ir atvērta tikai tiem, kam ir ielūguma kods, un kodi tiek ģenerēti konsolē — kuru vēl neviens nevar atvērt. Pirmais kods tiek ģenerēts pašā datorā.

  1. Attēls: serverī, repozitorija saknē, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Mape: PowerShell logā, mapē, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Komanda izdrukā kodu formā XXXX-XXXX-XXXX; invite-code 5 izdrukā piecus.
  4. Portālā noklikšķiniet uz Pieteikties un pēc tam uz Izveidot kontu: ievadiet kodu, reģistrējieties ar e-pastu, kas ierakstīts ADMINISTRATORS, un apstipriniet to ar verifikācijas e-pasta kodu.
  5. Piesakieties: Diagnostika katras lapas apakšā atver konsoli, kur tiek ģenerēti pārējie ielūguma kodi.

Padoms Ja verifikācijas e-pasts nepienāk, pārbaudiet pastkastes paroli: pieteikšanās pakalpojums palaišanas laikā ziņo, ja tās trūkst.

Jaunināšana

Jauninājums aizstāj attēlu un saglabā datus: tie atrodas konteinera sējumā, kas pieder projektam, nevis attēlam.

  1. Izstrādes datorā ar atjauninātu repozitoriju izveidojiet jauno attēlu: .\rebuild_container_release.ps1 -NoSeedData.
  2. Nokopējiet to uz serveri, pārbaudiet un ielādējiet kā pirmajā reizē: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Palaidiet ar to pašu komandu kā pirmajā reizē: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d pamana jauno attēlu un no jauna izveido konteineru, ar dažu sekunžu pārtraukumu.
  4. Atveriet konsoli cilnē Jaunināšana: kur rinda rāda Pieejama jaunināšana, noklikšķiniet uz Palaist jaunināšanu — līdz tam šī pakalpojuma datu funkcijas paliek izslēgtas.

Padoms Pirms katra jauninājuma diagnostikā pārbaudiet, vai datubāzu kopijas ir kārtībā (kartīte „Datubāzu kopijas“), un nokopējiet failus: datubāzu jaunināšana strādā ar kopiju un patur oriģinālu, līdz kopija ir pārbaudīta, taču kopijas ir jūsu pašu ceļš atpakaļ.

Kopijas un atjaunošana

Katrs pakalpojums uztur savu pārvaldīto datubāzu — kontu, dokumentu indeksu, pasta, tērzēšanu — nepārtrauktu kopiju, kas atpaliek ne vairāk kā aptuveni par sekundi, un var tās atjaunot tādas, kādas tās bija jebkurā pēdējo septiņu dienu brīdī. Paši faili — dokumenti, pielikumi, priekšskatījumi — tiek ierakstīti vienreiz un nekad nemainās: tos kopē atsevišķi vai glabā S3 krātuvē.

  1. Iznesiet datubāzu kopijas ārpus datora: reģistrējiet klases backups galamērķi S3 krātuvē vai citā diskā un aktivizējiet to.
  2. Attēls: kopējiet failus bez datubāzēm, kamēr tas darbojas: 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 .' ieraksta datētu arhīvu mapē files.
  3. Mape: apturiet to ar .\stop.ps1, nokopējiet visu mapi data un pēc tam palaidiet to vēlreiz.
  4. Ja administrators ir reģistrējis failiem citu galamērķi, nokopējiet tā mapi tajā pašā reizē: faili, kas izveidoti pēc tā aktivizēšanas, ir tikai tur.
  5. Glabājiet kopijas tālu no datora, ko tās aizsargā.

Padoms Lai atjaunotu vienu datubāzi vai visu instalāciju tādu, kāda tā bija kādā brīdī, apturiet instalāciju un palaidiet merydion-storage copies restore (rokasgrāmatas procedūra „Kopijas un atjaunošana“): tā ieraksta atjaunotās datubāzes jaunā mapē, kas pēc tam aizstāj veco.

Vietnes pārslēgšana uz coming soon

Coming soon katram apmeklētājam rāda tikai priekšskatījuma lapu, kamēr instalācija tiek gatavota: portāls, lietotnes, Palatys un konsole gaida aiz tās, arī administratoriem.

  1. Piesakieties kā administrators un atveriet https://merydion.example.com/coming-soon.html?enabled=true: lapa apstiprina, un vietne ir coming soon režīmā.
  2. Lai vietni atkal ieslēgtu, atveriet https://merydion.example.com/coming-soon.html?enabled=false: pēc apstiprinājuma lapa jūs aizved uz sākumlapu.
  3. Ja neesat pieteicies, lapa vispirms lūdz pieteikties; kontam, kas nav administrators, tā to pasaka, un nekas nemainās.
  4. Stāvoklis ir fails site/coming-soon datu mapē: tā noņemšana atkal ieslēdz vietni arī bez lapas.

Padoms Coming soon lapa ir angļu un itāļu valodā; citas valodas apmeklētājs saņem angļu valodas versiju.

Apmeklējumu statistikas ieslēgšana

Vietne var skaitīt savus apmeklējumus ar Google Analytics 4, vispirms lūdzot piekrišanu katram apmeklētājam: kamēr apmeklētājs nav piekritis, no Google nekas netiek ielādēts. Statistika paliek izslēgta, līdz instalācija norāda savu mērījuma ID, un administrēšanas konsolē tās nekad nav.

  1. Pakalpojumā Google Analytics izveidojiet īpašumu un tīmekļa straumi vietnes adresei un nokopējiet tās mērījuma ID (tas sākas ar G-).
  2. Attēls: failā .env blakus docker-compose.yml pievienojiet MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX un no jauna izveidojiet konteineru ar docker compose up -d. Mape: eksportējiet to pašu mainīgo sesijā pirms start.ps1.
  3. Atveriet vietni privātā logā: apakšā pa kreisi parādās paziņojums par apmeklējumu statistiku, un katras lapas apakšā parādās „Sīkdatņu iestatījumi“.
  4. Lai statistiku izslēgtu, iztukšojiet mainīgo un no jauna izveidojiet konteineru: paziņojums pazūd, un to apmeklētāju pārlūki, kuri bija piekrituši, pārtrauc ielādēt Google Analytics.

Padoms Privātuma politika un sīkdatņu politika jau apraksta statistiku visās valodās tai instalācijai, kas to ieslēdz. Īpašumā iestatiet vēlamo datu saglabāšanas periodu — Google apmeklējuma datus glabā ne ilgāk kā 14 mēnešus — un atstājiet Google signālus izslēgtus: vietne tos izslēdz arī no savas puses.

Vietnes atvēršana meklētājprogrammām

Katra instalācija liek meklētājprogrammām to neindeksēt, līdz pati ieslēdz indeksēšanu: neoficiāla vietnes kopija — testa instalācija, kādas organizācijas instalācija — nekad nekonkurē ar oficiālo vietni meklēšanas rezultātos. Adreses, ko norāda lapas, priekšskatījumi un vietnes kartes, ved uz oficiālo vietni https://merydion.eu, un konta lapas, konsole un neesošas adreses lapa nekad nenonāk indeksā.

  1. Tikai instalācijā, kas apkalpo oficiālo vietni. Attēls: failā .env blakus docker-compose.yml pievienojiet MERYDION_SITE_INDEXING=1 un no jauna izveidojiet konteineru ar docker compose up -d. Mape: eksportējiet to pašu mainīgo sesijā pirms start.ps1.
  2. Pārbaudiet: curl -I https://merydion.eu/ vairs nerāda galveni X-Robots-Tag: noindex, un https://merydion.eu/robots.txt norāda uz https://merydion.eu/sitemap.xml.
  3. Pakalpojumos Google Search Console un Bing Webmaster Tools verificējiet domēnu ar DNS ierakstu un iesniedziet https://merydion.eu/sitemap.xml.
  4. Lai vietni atkal izņemtu no meklētājprogrammām, iztukšojiet mainīgo un no jauna izveidojiet konteineru: katrā atbildē atkal ir noindex, un meklētājprogrammas nākamajā apmeklējumā lapas atmet.

Padoms Portālu, kas paredzēts citai adresei, ģenerē ar iestatītu MERYDION_SITE_ORIGIN (piemēram, https://www.example.com): tad kanoniskās adreses, alternatīvās valodu versijas, priekšskatījumi un vietnes kartes norāda uz šo adresi. Neesošas adreses lapa atbild savas mapes valodā ar statusa kodu 404.

Portāla Content-Security-Policy

Portāla lapas darbojas saskaņā ar stingru Content-Security-Policy, ko sūta vārteja: lapa drīkst izmantot tikai savus failus, pieprasījumus uz savu izcelsmi, attēlus arī no data: un blob: un nevienu citas vietnes rāmi. Tieši tas neļauj nejaušam iezīmēšanas fragmentam izpildīt kodu. Vienīgais izņēmums ir apmeklējumu statistika: lapas, kurām atļauts skaitīt apmeklējumus, pieļauj arī Google gtag.js, tikai tā ceļā, un Google Analytics datu vākšanu, kas tiek ielādēti tikai pēc tam, kad apmeklētājs ir piekritis.

  1. Pielāgots portāls ar skriptiem vai stiliem, kas ierakstīti tā lapās, nedarbojas: skripti un stili jāliek atsevišķos failos.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE un window.MERYDION_DIAGNOSTICS_BASE var pārvietot pieprasījumu saimi tikai zem cita tās pašas izcelsmes ceļa; citas izcelsmes adrese tiek ignorēta, un pārlūka konsolē parādās kļūda.
  3. Instalācijas konsoles lapām ir politika bez statistikas izņēmuma, un turklāt tās nevar parādīt rāmī.
  4. Politika atrodas failā apps/portal-csp.mjs un trijos Caddyfile, un tests tos uztur vienādus: mainiet to visās četrās vietās vienlaikus.

Padoms Identitātes pakalpojuma pieteikšanās veidlapa un konsoles atteikuma lapa nāk ar savu, vēl stingrāku politiku.

Atpakaļ uz rokasgrāmatu

Produktivitāte, made in Italy.

Nodrošiniet visu komplektu savai komandai — vienkāršu, drošu un pilnībā jūsu.