Treoir suiteála

An chéad logáil isteach agus an oibríocht

An chéad riarthóir, uasghráduithe, cúltacaí, an coming soon agus an polasaí slándála.

An chéad riarthóir

Níl an clárú oscailte ach don té a bhfuil cód cuiridh aige, agus gintear na cóid sa chonsól — nach féidir le duine ar bith a oscailt go fóill. Gintear an chéad chód ar an meaisín féin.

  1. Íomhá: ar an bhfreastalaí, ó fhréamh an stóir, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Fillteán: in PowerShell, san fhillteán, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Priontálann an t-ordú cód san fhoirm XXXX-XXXX-XXXX; priontálann invite-code 5 cúig cinn.
  4. Ar an tairseach, cliceáil Logáil isteach agus ansin Cruthaigh cuntas: cuir isteach an cód, cláraigh leis an ríomhphost atá scríofa in ADMINISTRATORS agus deimhnigh é le cód an ríomhphoist fíoraithe.
  5. Logáil isteach: osclaíonn Diagnóisic, ag bun gach leathanaigh, an consól, áit a ngintear na cóid chuiridh eile.

Leid Mura dtagann an ríomhphost fíoraithe, seiceáil pasfhocal an bhosca poist: deir an tseirbhís logála isteach ag am tosaithe nuair atá sé ar iarraidh.

Uasghrádú

Cuireann uasghrádú íomhá nua in áit na seanchinn agus coinníonn sé na sonraí: tá siad in imleabhar an choimeádáin, a bhaineann leis an tionscadal agus ní leis an íomhá.

  1. Ar an meaisín forbartha, leis an stór nuashonraithe, tóg an íomhá nua: .\rebuild_container_release.ps1 -NoSeedData.
  2. Cóipeáil chuig an bhfreastalaí í, seiceáil í agus lódáil í mar a rinne tú an chéad uair: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Tosaigh leis an ordú céanna agus an chéad uair: tugann docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d an íomhá nua faoi deara agus athchruthaíonn sé an coimeádán, le briseadh cúpla soicind.
  4. Oscail an consól ar an gcluaisín Uasghrádú: nuair a deir líne Uasghrádú ar fáil, cliceáil Rith uasghrádú — go dtí sin fanann feidhmeanna sonraí na seirbhíse sin múchta.

Leid Roimh gach uasghrádú, seiceáil sa diagnóisic go bhfuil cóipeanna na mbunachar sonraí i gceart (an cárta “Cóipeanna de na bunachair shonraí”) agus cóipeáil na comhaid: oibríonn uasghrádú na mbunachar sonraí ar chóip agus coinníonn sé an bunleagan go dtí go bhfíoraítear an chóip, ach is iad na cóipeanna do bhealach féin ar ais.

Cóipeanna agus athchóiriú

Coinníonn gach seirbhís cóip leanúnach de na bunachair shonraí atá faoina cúram — cuntais, innéacsanna doiciméad, post, comhráite — nach mbíonn níos mó ná timpeall soicind amháin ar gcúl, agus is féidir léi í a athchóiriú go dtí aon nóiméad de na seacht lá is déanaí. Na comhaid féin — doiciméid, ceangaltáin, réamhamhairc — scríobhtar uair amháin iad agus ní athraíonn siad choíche: cóipeáiltear ar leithligh iad, nó coinnítear i mbuicéad S3 iad.

  1. Cuir cóipeanna na mbunachar sonraí lasmuigh den mheaisín: cláraigh ceann scríbe den aicme backups ar bhuicéad S3 nó ar dhiosca eile, agus gníomhachtaigh é.
  2. Íomhá: cóipeáil na comhaid, gan na bunachair shonraí, agus í ag rith: scríobhann 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 .' cartlann dhátaithe san fhillteán files.
  3. Fillteán: stop é le .\stop.ps1, cóipeáil an fillteán data ina iomláine, agus ansin tosaigh arís é.
  4. Má chláraigh riarthóir ceann scríbe eile do na comhaid, cóipeáil a fhillteán sa bhabhta céanna: níl na comhaid a cruthaíodh tar éis a ghníomhachtaithe ach ansin.
  5. Coinnigh na cóipeanna i bhfad ón meaisín a chosnaíonn siad.

Leid Chun bunachar sonraí amháin nó an tsuiteáil iomlán a thabhairt ar ais go dtí nóiméad áirithe, stop an tsuiteáil agus rith merydion-storage copies restore (an nós imeachta “Cóipeanna agus athchóiriú” sa leabhar oibre): scríobhann an t-ordú na bunachair shonraí athchóirithe i bhfillteán nua, a ghlacann áit an tseanfhillteáin ansin.

An suíomh a chur i coming soon

Ní thaispeánann an coming soon do gach cuairteoir ach leathanach réamhamhairc fad atá an tsuiteáil á hullmhú: fanann an tairseach, na feidhmchláir, Palatys agus an consól taobh thiar de, do riarthóirí freisin.

  1. Logáil isteach mar riarthóir agus oscail https://merydion.example.com/coming-soon.html?enabled=true: deimhníonn an leathanach agus tá an suíomh i coming soon.
  2. Chun an suíomh a chasadh air arís, oscail https://merydion.example.com/coming-soon.html?enabled=false: tar éis an deimhnithe tugann an leathanach chuig an leathanach baile thú.
  3. Mura bhfuil tú logáilte isteach, iarrann an leathanach ort logáil isteach ar dtús; deir sé le cuntas nach riarthóir é, agus ní athraíonn aon rud.
  4. Is é an staid an comhad site/coming-soon i bhfillteán na sonraí: má bhaintear é, casann sé an suíomh air arís fiú gan an leathanach.

Leid Tá leathanach an coming soon ann i mBéarla agus in Iodáilis; faigheann cuairteoir le teanga eile an leagan Béarla.

Na staitisticí cuairte a chasadh air

Is féidir leis an suíomh a chuairteanna a chomhaireamh le Google Analytics 4, ag iarraidh toilithe ar gach cuairteoir ar dtús: go dtí go nglacann cuairteoir leis, ní lódáiltear aon rud ó Google. Fanann na staitisticí múchta go dtí go n-ainmníonn an tsuiteáil a haitheantas tomhais (measurement ID), agus ní bhíonn siad riamh ag an gconsól riaracháin.

  1. In Google Analytics, cruthaigh maoin (property) agus sruth sonraí gréasáin do sheoladh an tsuímh, agus cóipeáil a aitheantas tomhais (tosaíonn sé le G-).
  2. Íomhá: sa chomhad .env in aice le docker-compose.yml cuir MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX leis agus athchruthaigh an coimeádán le docker compose up -d. Fillteán: easpórtáil an athróg chéanna sa seisiún roimh start.ps1.
  3. Oscail an suíomh i bhfuinneog phríobháideach: feictear an fógra faoi staitisticí cuairte thíos ar chlé, agus feictear “Roghanna fianán” ag bun gach leathanaigh.
  4. Chun na staitisticí a mhúchadh, folmhaigh an athróg agus athchruthaigh an coimeádán: imíonn an fógra, agus ní lódálann brabhsálaithe na ndaoine a ghlac leo Google Analytics a thuilleadh.

Leid Déanann an beartas príobháideachais agus an beartas fianán cur síos ar na staitisticí cheana féin, i ngach teanga, don tsuiteáil a chasann air iad. Sa mhaoin, socraigh an choinneáil sonraí is mian leat — coinníonn Google sonraí cuairte ar feadh 14 mhí ar a mhéad — agus fág comharthaí Google múchta: múchann an suíomh iad óna thaobh féin freisin.

An suíomh a oscailt d'innill chuardaigh

Deir gach suiteáil le hinnill chuardaigh gan í a innéacsú go dtí go gcasann sí an t-innéacsú air: ní bhíonn cóip neamhoifigiúil den suíomh — suiteáil tástála, suiteáil eagraíochta — in iomaíocht leis an suíomh oifigiúil riamh sna torthaí. Is chuig an suíomh oifigiúil, https://merydion.eu, a thagraíonn na seoltaí a fhógraíonn na leathanaigh, na réamhamhairc agus na léarscáileanna suímh, agus ní théann leathanaigh an chuntais, an consól ná an leathanach do sheoladh nach bhfuil ann isteach in innéacs riamh.

  1. Ar an tsuiteáil a sholáthraíonn an suíomh oifigiúil amháin. Íomhá: sa chomhad .env in aice le docker-compose.yml cuir MERYDION_SITE_INDEXING=1 leis agus athchruthaigh an coimeádán le docker compose up -d. Fillteán: easpórtáil an athróg chéanna sa seisiún roimh start.ps1.
  2. Seiceáil: ní thaispeánann curl -I https://merydion.eu/ an ceanntásc X-Robots-Tag: noindex a thuilleadh, agus díríonn https://merydion.eu/robots.txt ar https://merydion.eu/sitemap.xml.
  3. In Google Search Console agus in Bing Webmaster Tools, fíoraigh an fearann le taifead DNS agus seol isteach https://merydion.eu/sitemap.xml.
  4. Chun an suíomh a bhaint de na hinnill chuardaigh arís, folmhaigh an athróg agus athchruthaigh an coimeádán: deir gach freagra noindex arís, agus ligeann na hinnill na leathanaigh uathu ar a gcéad chuairt eile.

Leid Socraíonn tairseach a ghintear do sheoladh eile MERYDION_SITE_ORIGIN (mar shampla https://www.example.com) nuair a ghintear í: ansin is chuig an seoladh sin a thagraíonn na seoltaí canónacha, na leaganacha teanga eile, na réamhamhairc agus na léarscáileanna suímh. Freagraíonn an leathanach do sheoladh nach bhfuil ann i dteanga a fhillteáin féin, leis an stádas 404.

Content-Security-Policy na tairsí

Ritheann leathanaigh na tairsí faoi Content-Security-Policy dhian a sheolann an geata: ní féidir le leathanach ach a chomhaid féin a úsáid, iarratais chuig a bhunús féin, íomhánna ó data: agus blob: freisin, agus fráma ar bith ó shuíomh eile. Is é sin a chuireann cosc ar phíosa marcála isteach cód a rith. Is iad na staitisticí cuairte an t-aon eisceacht: ligeann na leathanaigh ar féidir leo cuairteanna a chomhaireamh isteach gtag.js Google freisin, ar a chosán féin amháin, agus bailiúchán Google Analytics, nach lódáiltear ach amháin tar éis do chuairteoir glacadh leo.

  1. Ní oibríonn tairseach shaincheaptha le scripteanna nó stíleanna scríofa taobh istigh dá leathanaigh: téann scripteanna agus stíleanna ina gcomhaid féin.
  2. Ní féidir le window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE agus window.MERYDION_DIAGNOSTICS_BASE teaghlach iarratas a bhogadh ach faoi chosán eile den bhunús céanna; déantar neamhaird de sheoladh ar bhunús eile, le hearráid i gconsól an bhrabhsálaí.
  3. Tá an polasaí gan eisceacht na staitisticí ar leathanaigh chonsól na suiteála agus, ina theannta sin, ní féidir iad a thaispeáint taobh istigh d'fhráma.
  4. Tá an polasaí in apps/portal-csp.mjs agus sna trí Caddyfile, agus coinníonn tástáil ar aon dul iad: athraigh é sna ceithre áit ag an am céanna.

Leid Tagann foirm logála isteach na seirbhíse aitheantais agus leathanach diúltaithe an chonsóil lena bpolasaí féin, atá níos déine fós.

Ar ais chuig an treoir

Táirgiúlacht, made in Italy.

Tabhair an tsraith iomlán chuig d'fhoireann — simplí, slán agus go hiomlán leatsa.