Guide d'installation

Première connexion et exploitation

Le premier administrateur, les mises à niveau, les sauvegardes, le coming soon et la politique de sécurité.

Le premier administrateur

L'inscription n'est ouverte qu'à qui détient un code d'invitation, et les codes se génèrent dans la console — que personne ne peut encore ouvrir. Le premier code se génère sur la machine elle-même.

  1. Image : sur le serveur, à la racine du dépôt, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Dossier : dans PowerShell, dans le dossier, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. La commande affiche un code de la forme XXXX-XXXX-XXXX ; invite-code 5 en affiche cinq.
  4. Sur le portail, cliquez sur Se connecter, puis sur Créer un compte : saisissez le code et inscrivez-vous avec l'adresse écrite dans ADMINISTRATORS, puis confirmez-la avec le code de l'e-mail de vérification.
  5. Connectez-vous : Diagnostic, en bas de chaque page, ouvre la console, où se génèrent les autres codes d'invitation.

Conseil Si l'e-mail de vérification n'arrive pas, vérifiez le mot de passe de la boîte : le service de connexion signale au démarrage quand il manque.

Mettre à niveau

Une mise à niveau remplace l'image et garde les données : elles vivent dans le volume du conteneur, qui appartient au projet et non à l'image.

  1. Sur la machine de développement, avec le dépôt à jour, construisez la nouvelle image : .\rebuild_container_release.ps1 -NoSeedData.
  2. Copiez-la sur le serveur, vérifiez-la et chargez-la comme la première fois : sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Démarrez avec la même commande que la première fois : docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d remarque la nouvelle image et recrée le conteneur, avec une interruption de quelques secondes.
  4. Ouvrez la console sur l'onglet Mise à niveau : là où une ligne indique Mise à niveau disponible, cliquez sur Lancer la mise à niveau — jusque-là, les fonctions de données de ce service restent coupées.

Conseil Avant chaque mise à niveau, contrôlez dans le diagnostic que les copies des bases de données sont en ordre (la carte « Copies des bases de données ») et copiez les fichiers : la mise à niveau des bases de données travaille sur une copie et garde l'original tant que la copie n'est pas vérifiée, mais les copies sont votre propre chemin de retour.

Copies et restauration

Chaque service tient une copie continue des bases de données qu'il gère — comptes, index des documents, messagerie, discussions — avec au plus une seconde de retard environ, et peut la restaurer à n'importe quel instant des sept derniers jours. Les fichiers eux-mêmes — documents, pièces jointes, aperçus — sont écrits une fois et ne changent jamais : ils sont copiés à part, ou conservés dans un bucket S3.

  1. Sortez les copies des bases de données de la machine : enregistrez une destination de la classe backups sur un bucket S3 ou sur un autre disque, et activez-la.
  2. Image : copiez les fichiers, sans les bases de données, pendant qu'elle tourne : 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 .' écrit une archive datée dans le dossier files.
  3. Dossier : arrêtez-le avec .\stop.ps1, copiez le dossier data en entier, puis redémarrez-le.
  4. Si un administrateur a enregistré une autre destination pour les fichiers, copiez son dossier dans le même tour : les fichiers nés après son activation ne sont que là.
  5. Gardez les copies loin de la machine qu'elles protègent.

Conseil Pour ramener une base de données ou l'installation entière à un instant donné, arrêtez l'installation et lancez merydion-storage copies restore (la procédure « Copies et restauration » du runbook) : la commande écrit les bases de données restaurées dans un nouveau dossier, qui prend ensuite la place de l'ancien.

Mettre le site en coming soon

Le coming soon ne montre à chaque visiteur qu'une page d'aperçu pendant que l'installation se prépare : le portail, les applications, Palatys et la console attendent derrière elle, administrateurs compris.

  1. Connectez-vous en tant qu'administrateur et ouvrez https://merydion.example.com/coming-soon.html?enabled=true : la page confirme et le site est en coming soon.
  2. Pour rallumer le site, ouvrez https://merydion.example.com/coming-soon.html?enabled=false : après la confirmation, la page vous ramène à l'accueil.
  3. Si vous n'êtes pas connecté, la page vous le demande d'abord ; à un compte qui n'est pas administrateur, elle le dit, et rien ne change.
  4. L'état est le fichier site/coming-soon dans le dossier de données : le retirer rallume le site même sans la page.

Conseil La page du coming soon existe en anglais et en italien ; un visiteur d'une autre langue reçoit la version anglaise.

Activer les statistiques de fréquentation

Le site peut compter ses visites avec Google Analytics 4, en demandant d'abord son consentement à chaque visiteur : tant qu'un visiteur n'accepte pas, rien de Google ne se charge. Les statistiques restent désactivées tant que l'installation n'indique pas son ID de mesure, et la console d'administration ne les a jamais.

  1. Dans Google Analytics, créez une propriété et un flux de données Web pour l'adresse du site, et copiez son ID de mesure (il commence par G-).
  2. Image : dans le fichier .env à côté de docker-compose.yml, ajoutez MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX et recréez le conteneur avec docker compose up -d. Dossier : exportez la même variable dans la session avant start.ps1.
  3. Ouvrez le site dans une fenêtre de navigation privée : l'avis sur les statistiques de fréquentation apparaît en bas à gauche, et « Préférences de cookies » apparaît en bas de chaque page.
  4. Pour désactiver les statistiques, videz la variable et recréez le conteneur : l'avis disparaît, et les navigateurs de ceux qui avaient accepté cessent de charger Google Analytics.

Conseil La politique de confidentialité et la politique relative aux cookies décrivent déjà les statistiques, dans toutes les langues, pour l'installation qui les active. Dans la propriété, définissez la conservation des données que vous voulez — Google garde les données d'une visite au maximum 14 mois — et laissez les signaux Google désactivés : le site les désactive aussi de son côté.

Ouvrir le site aux moteurs de recherche

Chaque installation demande aux moteurs de recherche de ne pas l'indexer tant qu'elle n'a pas activé l'indexation : une copie du site qui n'est pas l'officielle — une installation de test, celle d'une organisation — ne lui fait jamais concurrence dans les résultats. Les adresses que déclarent les pages, les aperçus et les plans de site désignent le site officiel, https://merydion.eu, et les pages du compte, la console et la page d'une adresse qui n'existe pas n'entrent jamais dans un index.

  1. Uniquement sur l'installation qui sert le site officiel. Image : dans le fichier .env à côté de docker-compose.yml, ajoutez MERYDION_SITE_INDEXING=1 et recréez le conteneur avec docker compose up -d. Dossier : exportez la même variable dans la session avant start.ps1.
  2. Pour vérifier : curl -I https://merydion.eu/ n'affiche plus l'en-tête X-Robots-Tag: noindex, et https://merydion.eu/robots.txt indique https://merydion.eu/sitemap.xml.
  3. Dans Google Search Console et dans Bing Webmaster Tools, vérifiez le domaine avec un enregistrement DNS et soumettez https://merydion.eu/sitemap.xml.
  4. Pour retirer de nouveau le site des moteurs de recherche, videz la variable et recréez le conteneur : chaque réponse indique de nouveau noindex, et les moteurs retirent les pages à leur prochain passage.

Conseil Un portail généré pour une autre adresse définit MERYDION_SITE_ORIGIN (par exemple https://www.example.com) au moment de sa génération : les adresses canoniques, les versions linguistiques, les aperçus et les plans de site désignent alors cette adresse. La page d'une adresse qui n'existe pas répond dans la langue de son dossier, avec le statut 404.

La Content-Security-Policy du portail

Les pages du portail tournent sous une Content-Security-Policy stricte qu'envoie la passerelle : une page ne peut utiliser que ses propres fichiers, des requêtes vers sa propre origine, des images aussi depuis data: et blob:, et aucun cadre d'un autre site. C'est ce qui empêche un fragment de balisage intrus d'exécuter du code. La seule exception, ce sont les statistiques de fréquentation : les pages qui peuvent compter les visites admettent aussi gtag.js de Google, sur son seul chemin, et la collecte de Google Analytics, qui ne se chargent qu'après qu'un visiteur a accepté.

  1. Un portail personnalisé avec des scripts ou des styles écrits dans ses pages ne fonctionne pas : scripts et styles vont dans des fichiers à eux.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE et window.MERYDION_DIAGNOSTICS_BASE ne peuvent déplacer une famille de requêtes que sous un autre chemin de la même origine ; une adresse sur une autre origine est ignorée, avec une erreur dans la console du navigateur.
  3. Les pages de la console de l'installation portent la politique sans l'exception des statistiques et, en plus, ne peuvent pas s'afficher dans un cadre.
  4. La politique vit dans apps/portal-csp.mjs et dans les trois Caddyfile, et un test les garde identiques : changez-la dans les quatre endroits à la fois.

Conseil Le formulaire de connexion du service d'identité et la page de refus de la console arrivent avec une politique à eux, plus stricte encore.

Retour au guide

La productivité, made in Italy.

Offrez toute la suite à votre équipe : simple, sûre et entièrement à vous.