Gwida għall-installazzjoni

L-ewwel dħul u t-tħaddim

L-ewwel amministratur, l-aġġornamenti, il-backups, il-coming soon u l-politika tas-sigurtà.

L-ewwel amministratur

Ir-reġistrazzjoni hija miftuħa biss għal min għandu kodiċi tal-istedina, u l-kodiċijiet jiġu ġġenerati fil-console — li għadu ħadd ma jista' jiftaħha. L-ewwel kodiċi jiġi ġġenerat fuq il-magna stess.

  1. Immaġni: fuq is-server, mill-għerq tar-repożitorju, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Folder: f'PowerShell, fil-folder, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Il-kmand jipprintja kodiċi fil-forma XXXX-XXXX-XXXX; invite-code 5 jipprintja ħamsa.
  4. Fuq il-portal, ikklikkja Idħol, imbagħad Oħloq kont: daħħal il-kodiċi, irreġistra bl-email miktuba f'ADMINISTRATORS u kkonfermaha bil-kodiċi tal-email tal-verifika.
  5. Idħol: Dijanjostika, fil-qiegħ ta' kull paġna, tiftaħ il-console, fejn jiġu ġġenerati l-kodiċijiet tal-istedina l-oħra.

Suġġeriment Jekk l-email tal-verifika ma tasalx, iċċekkja l-password tal-kaxxa postali: is-servizz tad-dħul jgħid meta jibda jekk hijiex nieqsa.

Aġġorna

Aġġornament jissostitwixxi l-immaġni u jżomm id-data: din tinsab fil-volum tal-kontenitur, li huwa tal-proġett u mhux tal-immaġni.

  1. Fuq il-magna tal-iżvilupp, bir-repożitorju aġġornat, ibni l-immaġni l-ġdida: .\rebuild_container_release.ps1 -NoSeedData.
  2. Ikkupjaha fuq is-server, iċċekkjaha u tellagħha bħall-ewwel darba: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Ibda bl-istess kmand tal-ewwel darba: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d jinduna bl-immaġni l-ġdida u jerġa' joħloq il-kontenitur, b'interruzzjoni ta' ftit sekondi.
  4. Iftaħ il-console fit-tab Aġġornament: fejn linja tgħid Aġġornament disponibbli, ikklikkja Mexxi l-aġġornament — sa dakinhar il-funzjonijiet tad-data ta' dak is-servizz jibqgħu mitfija.

Suġġeriment Qabel kull aġġornament, iċċekkja fid-dijanjostika li l-kopji tad-databases huma f'ordni (il-karta “Kopji tad-databases”) u kkopja l-fajls: l-aġġornament tad-databases jaħdem fuq kopja u jżomm l-oriġinal sakemm il-kopja tiġi vverifikata, iżda l-kopji huma t-triq tiegħek biex terġa' lura.

Kopji u restawr

Kull servizz iżomm kopja kontinwa tad-databases li jamministra — kontijiet, indiċi tad-dokumenti, posta, chats — b'dewmien ta' mhux aktar minn madwar sekonda, u jista' jirrestawrahom kif kienu fi kwalunkwe mument tal-aħħar sebat ijiem. Il-fajls infushom — dokumenti, attachments, anteprimi — jinkitbu darba u qatt ma jinbidlu: jiġu kkopjati separatament, jew jinżammu f'bucket S3.

  1. Ħu l-kopji tad-databases 'il barra mill-magna: irreġistra destinazzjoni tal-klassi backups fuq bucket S3 jew fuq disk ieħor, u attivaha.
  2. Immaġni: ikkopja l-fajls, mingħajr id-databases, waqt li tkun qed taħdem: 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 .' jikteb arkivju bid-data fil-folder files.
  3. Folder: waqqfu b'.\stop.ps1, ikkopja l-folder data kollu, imbagħad erġa' ibdih.
  4. Jekk amministratur irreġistra destinazzjoni oħra għall-fajls, ikkopja l-folder tagħha fl-istess darba: il-fajls li nħolqu wara l-attivazzjoni tagħha jinsabu hemm biss.
  5. Żomm il-kopji 'l bogħod mill-magna li jipproteġu.

Suġġeriment Biex terġa' ġġib database waħda jew l-installazzjoni kollha lura għall-istat ta' mument partikolari, waqqaf l-installazzjoni u ħaddem merydion-storage copies restore (il-proċedura “Kopji u restawr” tar-runbook): il-kmand jikteb id-databases restawrati f'folder ġdid, li mbagħad jieħu post il-qadim.

Poġġi s-sit f'coming soon

Il-coming soon juri lil kull viżitatur biss paġna ta' preview waqt li l-installazzjoni qed titħejja: il-portal, l-apps, Palatys u l-console jistennew warajha, anke għall-amministraturi.

  1. Idħol bħala amministratur u iftaħ https://merydion.example.com/coming-soon.html?enabled=true: il-paġna tikkonferma u s-sit ikun f'coming soon.
  2. Biex terġa' tixgħel is-sit, iftaħ https://merydion.example.com/coming-soon.html?enabled=false: wara l-konferma l-paġna teħdok lejn il-paġna ewlenija.
  3. Jekk m'intix dħalt, il-paġna titolbok tidħol l-ewwel; lil kont li mhuwiex amministratur tgħidlu, u ma jinbidel xejn.
  4. L-istat huwa l-fajl site/coming-soon fil-folder tad-data: jekk tneħħih, is-sit jerġa' jinxtegħel anke mingħajr il-paġna.

Suġġeriment Il-paġna tal-coming soon teżisti bl-Ingliż u bit-Taljan; viżitatur b'lingwa oħra jirċievi dik bl-Ingliż.

Ixgħel l-istatistika taż-żjarat

Is-sit jista' jgħodd iż-żjarat tiegħu b'Google Analytics 4, billi l-ewwel jitlob il-kunsens lil kull viżitatur: sakemm viżitatur ma jaċċettax, ma jitgħabba xejn minn Google. L-istatistika tibqa' mitfija sakemm l-installazzjoni ma tindikax l-ID tal-kejl tagħha, u l-console tal-amministrazzjoni qatt ma jkollha l-istatistika.

  1. F'Google Analytics, oħloq proprjetà u stream tad-data tal-web għall-indirizz tas-sit, u kkopja l-ID tal-kejl tiegħu (jibda b'G-).
  2. Immaġni: fil-fajl .env ħdejn docker-compose.yml żid MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX u erġa' oħloq il-kontenitur b'docker compose up -d. Folder: esporta l-istess varjabbli fis-sessjoni qabel start.ps1.
  3. Iftaħ is-sit f'tieqa privata: l-avviż dwar l-istatistika taż-żjarat jidher isfel fuq ix-xellug, u “Preferenzi tal-cookies” jidher fil-qiegħ ta' kull paġna.
  4. Biex titfi l-istatistika, battal il-varjabbli u erġa' oħloq il-kontenitur: l-avviż jisparixxi, u l-browsers ta' min kien aċċetta jieqfu jgħabbu Google Analytics.

Suġġeriment Il-politika tal-privatezza u l-politika tal-cookies diġà jiddeskrivu l-istatistika, f'kull lingwa, għall-installazzjoni li tixgħelha. Fil-proprjetà, issettja ż-żamma tad-data li trid — Google iżomm id-data ta' żjara għal mhux aktar minn 14-il xahar — u ħalli s-sinjali ta' Google mitfija: is-sit jitfihom ukoll min-naħa tiegħu.

Offri s-sit lill-magni tat-tiftix

Kull installazzjoni tgħid lill-magni tat-tiftix biex ma jindiċizzawhiex sakemm ma tixgħelx l-indiċizzazzjoni: kopja tas-sit li mhijiex dik uffiċjali — installazzjoni tal-prova, l-installazzjoni ta' organizzazzjoni — qatt ma tikkompeti miegħu fir-riżultati. L-indirizzi li jiddikjaraw il-paġni, il-previews u s-sitemaps jindikaw is-sit uffiċjali, https://merydion.eu, u l-paġni tal-kont, il-console u l-paġna ta' indirizz li ma jeżistix qatt ma jidħlu f'indiċi.

  1. Biss fuq l-installazzjoni li sservi s-sit uffiċjali. Immaġni: fil-fajl .env ħdejn docker-compose.yml żid MERYDION_SITE_INDEXING=1 u erġa' oħloq il-kontenitur b'docker compose up -d. Folder: esporta l-istess varjabbli fis-sessjoni qabel start.ps1.
  2. Iċċekkja: curl -I https://merydion.eu/ ma jibqax juri l-intestatura X-Robots-Tag: noindex, u https://merydion.eu/robots.txt jindika https://merydion.eu/sitemap.xml.
  3. F'Google Search Console u f'Bing Webmaster Tools, ivverifika d-dominju b'rekord DNS u ibgħat https://merydion.eu/sitemap.xml.
  4. Biex terġa' tneħħi s-sit mill-magni tat-tiftix, battal il-varjabbli u erġa' oħloq il-kontenitur: kull tweġiba terġa' tgħid noindex, u l-magni tat-tiftix ineħħu l-paġni fiż-żjara li jmiss.

Suġġeriment Portal iġġenerat għal indirizz ieħor jissettja MERYDION_SITE_ORIGIN (pereżempju https://www.example.com) meta jiġi ġġenerat: imbagħad l-indirizzi kanoniċi, l-alternattivi tal-lingwa, il-previews u s-sitemaps jindikaw dak l-indirizz. Il-paġna ta' indirizz li ma jeżistix twieġeb bil-lingwa tal-folder tagħha, bl-istatus 404.

Il-Content-Security-Policy tal-portal

Il-paġni tal-portal jaħdmu taħt Content-Security-Policy stretta li jibgħat il-gateway: paġna tista' tuża biss il-fajls tagħha, talbiet lejn l-oriġini tagħha, stampi anke minn data: u blob:, u l-ebda frame ta' sit ieħor. Huwa dan li jżomm biċċa markup mitlufa milli tħaddem kodiċi. L-unika eċċezzjoni hija l-istatistika taż-żjarat: il-paġni li jistgħu jgħoddu ż-żjarat jammettu wkoll gtag.js ta' Google, biss fil-mogħdija tiegħu, u l-ġbir ta' Google Analytics, li jitgħabbew biss wara li viżitatur jaċċetta.

  1. Portal personalizzat bi skripts jew stili miktuba ġewwa l-paġni tiegħu ma jaħdimx: l-iskripts u l-istili jmorru f'fajls tagħhom.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE u window.MERYDION_DIAGNOSTICS_BASE jistgħu jċaqilqu familja ta' talbiet biss taħt mogħdija oħra tal-istess oriġini; indirizz fuq oriġini oħra jiġi injorat, bi żball fil-console tal-browser.
  3. Il-paġni tal-console tal-installazzjoni għandhom il-politika mingħajr l-eċċezzjoni tal-istatistika u, barra minn hekk, ma jistgħux jintwerew ġewwa frame.
  4. Il-politika tinsab f'apps/portal-csp.mjs u fit-tliet Caddyfiles, u test iżommhom l-istess: ibdilha fl-erba' postijiet flimkien.

Suġġeriment Il-formola tad-dħul tas-servizz tal-identità u l-paġna taċ-ċaħda tal-console jaslu bil-politika tagħhom, saħansitra aktar stretta.

Lura għall-gwida

Produttività, made in Italy.

Ġib is-suite sħiħa lit-tim tiegħek — sempliċi, sigura u kompletament tiegħek.