Οδηγός εγκατάστασης

Πρώτη σύνδεση και λειτουργία

Ο πρώτος διαχειριστής, οι αναβαθμίσεις, τα αντίγραφα ασφαλείας, το coming soon και η πολιτική ασφαλείας.

Ο πρώτος διαχειριστής

Η εγγραφή είναι ανοιχτή μόνο σε όποιον έχει κωδικό πρόσκλησης, και οι κωδικοί δημιουργούνται στην κονσόλα — που κανείς δεν μπορεί ακόμη να ανοίξει. Ο πρώτος κωδικός δημιουργείται στον ίδιο τον υπολογιστή.

  1. Εικόνα: στον διακομιστή, από τη ρίζα του αποθετηρίου, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Φάκελος: στο PowerShell, μέσα στον φάκελο, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Η εντολή εμφανίζει έναν κωδικό της μορφής XXXX-XXXX-XXXX· το invite-code 5 εμφανίζει πέντε.
  4. Στην πύλη κάντε κλικ στο Σύνδεση και μετά στο Δημιουργία λογαριασμού: εισαγάγετε τον κωδικό, εγγραφείτε με το email που γράψατε στο ADMINISTRATORS και επιβεβαιώστε το με τον κωδικό του email επαλήθευσης.
  5. Συνδεθείτε: τα Διαγνωστικά, στο κάτω μέρος κάθε σελίδας, ανοίγουν την κονσόλα, όπου δημιουργούνται οι υπόλοιποι κωδικοί πρόσκλησης.

Συμβουλή Αν το email επαλήθευσης δεν φτάνει, ελέγξτε τον κωδικό του γραμματοκιβωτίου: η υπηρεσία σύνδεσης το αναφέρει κατά την εκκίνηση όταν λείπει.

Αναβάθμιση

Μια αναβάθμιση αντικαθιστά την εικόνα και κρατά τα δεδομένα: βρίσκονται στον τόμο του container, που ανήκει στο έργο και όχι στην εικόνα.

  1. Στον υπολογιστή ανάπτυξης, με ενημερωμένο αποθετήριο, δημιουργήστε τη νέα εικόνα: .\rebuild_container_release.ps1 -NoSeedData.
  2. Αντιγράψτε τη στον διακομιστή, ελέγξτε τη και φορτώστε τη όπως την πρώτη φορά: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Ξεκινήστε με την ίδια εντολή με την πρώτη φορά: το docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d αντιλαμβάνεται τη νέα εικόνα και ξαναδημιουργεί το container, με διακοπή λίγων δευτερολέπτων.
  4. Ανοίξτε την κονσόλα στην καρτέλα Αναβάθμιση: όπου μια γραμμή δείχνει Διαθέσιμη αναβάθμιση, κάντε κλικ στην Εκτέλεση αναβάθμισης — μέχρι τότε οι λειτουργίες δεδομένων εκείνης της υπηρεσίας μένουν απενεργοποιημένες.

Συμβουλή Πριν από κάθε αναβάθμιση, ελέγξτε στα διαγνωστικά ότι τα αντίγραφα των βάσεων δεδομένων είναι εντάξει (η κάρτα «Αντίγραφα των βάσεων δεδομένων») και αντιγράψτε τα αρχεία: η αναβάθμιση των βάσεων δεδομένων δουλεύει σε αντίγραφο και κρατά το πρωτότυπο μέχρι να επαληθευτεί το αντίγραφο, αλλά τα αντίγραφα είναι ο δικός σας δρόμος επιστροφής.

Αντίγραφα και επαναφορά

Κάθε υπηρεσία διατηρεί ένα συνεχές αντίγραφο των βάσεων δεδομένων που διαχειρίζεται — λογαριασμοί, ευρετήρια εγγράφων, αλληλογραφία, συνομιλίες — με καθυστέρηση το πολύ περίπου ενός δευτερολέπτου, και μπορεί να τις επαναφέρει στην κατάσταση οποιασδήποτε στιγμής των τελευταίων επτά ημερών. Τα ίδια τα αρχεία — έγγραφα, συνημμένα, προεπισκοπήσεις — γράφονται μία φορά και δεν αλλάζουν ποτέ: αντιγράφονται χωριστά ή φυλάσσονται σε ένα bucket S3.

  1. Μεταφέρετε τα αντίγραφα των βάσεων δεδομένων εκτός του υπολογιστή: καταχωρίστε έναν προορισμό της κλάσης backups σε ένα bucket S3 ή σε άλλον δίσκο και ενεργοποιήστε τον.
  2. Εικόνα: αντιγράψτε τα αρχεία, χωρίς τις βάσεις δεδομένων, ενώ εκτελείται: το 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 .' γράφει ένα χρονολογημένο αρχείο στον φάκελο files.
  3. Φάκελος: σταματήστε τον με .\stop.ps1, αντιγράψτε ολόκληρο τον φάκελο data και μετά ξεκινήστε τον ξανά.
  4. Αν ένας διαχειριστής έχει καταχωρίσει άλλον προορισμό για τα αρχεία, αντιγράψτε τον φάκελό του στον ίδιο γύρο: τα αρχεία που δημιουργήθηκαν μετά την ενεργοποίησή του βρίσκονται μόνο εκεί.
  5. Κρατήστε τα αντίγραφα μακριά από τον υπολογιστή που προστατεύουν.

Συμβουλή Για να επαναφέρετε μία βάση δεδομένων ή ολόκληρη την εγκατάσταση στην κατάσταση μιας στιγμής, σταματήστε την εγκατάσταση και εκτελέστε το merydion-storage copies restore (η διαδικασία «Αντίγραφα και επαναφορά» του runbook): η εντολή γράφει τις ανακτημένες βάσεις δεδομένων σε έναν νέο φάκελο, που έπειτα παίρνει τη θέση του παλιού.

Θέση του ιστότοπου σε coming soon

Το coming soon δείχνει σε κάθε επισκέπτη μόνο μια σελίδα προεπισκόπησης όσο προετοιμάζεται η εγκατάσταση: η πύλη, οι εφαρμογές, το Palatys και η κονσόλα περιμένουν πίσω της, και για τους διαχειριστές.

  1. Συνδεθείτε ως διαχειριστής και ανοίξτε το https://merydion.example.com/coming-soon.html?enabled=true: η σελίδα επιβεβαιώνει και ο ιστότοπος είναι σε coming soon.
  2. Για να ενεργοποιήσετε ξανά τον ιστότοπο, ανοίξτε το https://merydion.example.com/coming-soon.html?enabled=false: μετά την επιβεβαίωση η σελίδα σάς πηγαίνει στην αρχική.
  3. Αν δεν έχετε συνδεθεί, η σελίδα σάς το ζητά πρώτα· σε λογαριασμό που δεν είναι διαχειριστής το λέει, και τίποτα δεν αλλάζει.
  4. Η κατάσταση είναι το αρχείο site/coming-soon στον φάκελο δεδομένων: η αφαίρεσή του ενεργοποιεί ξανά τον ιστότοπο ακόμη και χωρίς τη σελίδα.

Συμβουλή Η σελίδα του coming soon υπάρχει στα αγγλικά και στα ιταλικά· ένας επισκέπτης άλλης γλώσσας λαμβάνει την αγγλική.

Ενεργοποίηση των στατιστικών επισκέψεων

Ο ιστότοπος μπορεί να μετρά τις επισκέψεις του με το Google Analytics 4, ζητώντας πρώτα τη συγκατάθεση κάθε επισκέπτη: μέχρι να αποδεχτεί ένας επισκέπτης, δεν φορτώνεται τίποτα από τη Google. Τα στατιστικά μένουν απενεργοποιημένα μέχρι η εγκατάσταση να δηλώσει το αναγνωριστικό μέτρησής της, και η κονσόλα διαχείρισης δεν τα έχει ποτέ.

  1. Στο Google Analytics, δημιουργήστε μια ιδιοκτησία και μια ροή ιστού για τη διεύθυνση του ιστότοπου, και αντιγράψτε το αναγνωριστικό μέτρησής της (ξεκινά με G-).
  2. Εικόνα: στο αρχείο .env δίπλα στο docker-compose.yml προσθέστε MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX και ξαναδημιουργήστε το container με docker compose up -d. Φάκελος: εξαγάγετε την ίδια μεταβλητή στη συνεδρία πριν από το start.ps1.
  3. Ανοίξτε τον ιστότοπο σε ιδιωτικό παράθυρο: κάτω αριστερά εμφανίζεται η ειδοποίηση για τα στατιστικά επισκέψεων, και στο κάτω μέρος κάθε σελίδας εμφανίζεται το «Προτιμήσεις cookies».
  4. Για να απενεργοποιήσετε τα στατιστικά, αδειάστε τη μεταβλητή και ξαναδημιουργήστε το container: η ειδοποίηση εξαφανίζεται, και οι περιηγητές όσων είχαν αποδεχτεί σταματούν να φορτώνουν το Google Analytics.

Συμβουλή Η πολιτική απορρήτου και η πολιτική για τα cookies περιγράφουν ήδη τα στατιστικά, σε κάθε γλώσσα, για την εγκατάσταση που τα ενεργοποιεί. Στην ιδιοκτησία, ορίστε τη διατήρηση δεδομένων που θέλετε — η Google κρατά τα δεδομένα μιας επίσκεψης το πολύ 14 μήνες — και αφήστε το Google signals απενεργοποιημένο: ο ιστότοπος το απενεργοποιεί και από τη δική του πλευρά.

Διάθεση του ιστότοπου στις μηχανές αναζήτησης

Κάθε εγκατάσταση λέει στις μηχανές αναζήτησης να μην την ευρετηριάζουν μέχρι να ενεργοποιήσει την ευρετηρίαση: ένα αντίγραφο του ιστότοπου που δεν είναι το επίσημο — μια δοκιμαστική εγκατάσταση, η εγκατάσταση ενός οργανισμού — δεν τον ανταγωνίζεται ποτέ στα αποτελέσματα. Οι διευθύνσεις που δηλώνουν οι σελίδες, οι προεπισκοπήσεις και οι χάρτες ιστότοπου παραπέμπουν στον επίσημο ιστότοπο, https://merydion.eu, και οι σελίδες του λογαριασμού, η κονσόλα και η σελίδα μιας διεύθυνσης που δεν υπάρχει δεν μπαίνουν ποτέ σε ευρετήριο.

  1. Μόνο στην εγκατάσταση που εξυπηρετεί τον επίσημο ιστότοπο. Εικόνα: στο αρχείο .env δίπλα στο docker-compose.yml προσθέστε MERYDION_SITE_INDEXING=1 και ξαναδημιουργήστε το container με docker compose up -d. Φάκελος: εξαγάγετε την ίδια μεταβλητή στη συνεδρία πριν από το start.ps1.
  2. Έλεγχος: το curl -I https://merydion.eu/ δεν δείχνει πλέον την κεφαλίδα X-Robots-Tag: noindex, και το https://merydion.eu/robots.txt παραπέμπει στο https://merydion.eu/sitemap.xml.
  3. Στο Google Search Console και στο Bing Webmaster Tools, επαληθεύστε τον τομέα με μια εγγραφή DNS και υποβάλετε το https://merydion.eu/sitemap.xml.
  4. Για να αφαιρέσετε ξανά τον ιστότοπο από τις μηχανές αναζήτησης, αδειάστε τη μεταβλητή και ξαναδημιουργήστε το container: κάθε απόκριση λέει ξανά noindex, και οι μηχανές αποσύρουν τις σελίδες στην επόμενη επίσκεψή τους.

Συμβουλή Μια πύλη που δημιουργείται για άλλη διεύθυνση ορίζει κατά τη δημιουργία της το MERYDION_SITE_ORIGIN (για παράδειγμα https://www.example.com): οι κανονικές διευθύνσεις, οι εναλλακτικές γλωσσικές εκδόσεις, οι προεπισκοπήσεις και οι χάρτες ιστότοπου παραπέμπουν τότε σε αυτή τη διεύθυνση. Η σελίδα μιας διεύθυνσης που δεν υπάρχει απαντά στη γλώσσα του φακέλου της, με κατάσταση 404.

Η Content-Security-Policy της πύλης

Οι σελίδες της πύλης λειτουργούν υπό αυστηρή Content-Security-Policy που στέλνει η πύλη δικτύου: μια σελίδα μπορεί να χρησιμοποιεί μόνο τα δικά της αρχεία, αιτήματα προς τη δική της προέλευση, εικόνες και από data: και blob:, και κανένα πλαίσιο άλλου ιστότοπου. Αυτό εμποδίζει ένα παρείσακτο κομμάτι σήμανσης να εκτελέσει κώδικα. Η μόνη εξαίρεση είναι τα στατιστικά επισκέψεων: οι σελίδες που μπορούν να μετρούν επισκέψεις δέχονται επίσης το gtag.js της Google, μόνο στη διαδρομή του, και τη συλλογή του Google Analytics, που φορτώνονται μόνο αφού ένας επισκέπτης αποδεχτεί.

  1. Μια προσαρμοσμένη πύλη με σενάρια ή στυλ γραμμένα μέσα στις σελίδες της δεν λειτουργεί: τα σενάρια και τα στυλ μπαίνουν σε δικά τους αρχεία.
  2. Τα window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE και window.MERYDION_DIAGNOSTICS_BASE μπορούν να μετακινήσουν μια οικογένεια αιτημάτων μόνο κάτω από άλλη διαδρομή της ίδιας προέλευσης· μια διεύθυνση σε άλλη προέλευση αγνοείται, με σφάλμα στην κονσόλα του περιηγητή.
  3. Οι σελίδες της κονσόλας της εγκατάστασης φέρουν την πολιτική χωρίς την εξαίρεση των στατιστικών και, επιπλέον, δεν μπορούν να εμφανιστούν μέσα σε πλαίσιο.
  4. Η πολιτική βρίσκεται στο apps/portal-csp.mjs και στα τρία Caddyfile, και ένα τεστ τα κρατά ίδια: αλλάξτε την και στα τέσσερα σημεία μαζί.

Συμβουλή Η φόρμα σύνδεσης της υπηρεσίας ταυτότητας και η σελίδα άρνησης της κονσόλας έρχονται με δική τους πολιτική, ακόμη πιο αυστηρή.

Επιστροφή στον οδηγό

Παραγωγικότητα, made in Italy.

Φέρτε ολόκληρη τη σουίτα στην ομάδα σας — απλή, ασφαλή και εξ ολοκλήρου δική σας.