Exploiter une installation Mirket
Comprendre l’exécution isolée par établissement, la frontière de configuration, les contrôles de santé et les attentes en matière de reprise.
- Pour
- Opérateur
- Temps de lecture
- 11 min
- Mis à jour
- 22 octobre 2026

Avant de commencer
- Un accès shell à l’hôte de l’installation, la version immuable extraite et le fichier d’environnement de l’installation.
- L’accès aux journaux des services, à la destination de sauvegarde et à un fichier de phrase secrète protégé.
Vous avez terminé quand
- docker compose --env-file .env -f compose.yml ps indique que les services attendus tournent et que ceux dotés d’un contrôle de santé sont sains.
- Les contrôles /health/live et /health/ready de l’API et du service de sockets répondent correctement.
- La sauvegarde chiffrée la plus récente a réussi l’exercice de restauration du dépôt.
- Chaque profil de service facultatif correspond à son indicateur d’application ; les modules qui n’utilisent qu’un indicateur et l’activation par l’organisation sont vérifiés séparément.
Si quelque chose ne va pas
- N’écrasez pas un déploiement ou une sauvegarde en échec. Conservez les journaux, l’empreinte exacte de la version, le chemin d’environnement et la sortie des commandes.
- Ne restaurez qu’à partir d’une archive chiffrée vérifiée et respectez la fenêtre de reprise et la procédure convenues par votre établissement.
- Si un service facultatif échoue, maintenez le LMS de base et vérifiez l’état, les identifiants, l’origine et les journaux de ce service avant de le redémarrer. Ne copiez jamais de jetons d’accès, d’en-têtes de requête, d’adresses e-mail ni d’informations sur les enfants dans les diagnostics.
Connaître la frontière de déploiement
- Une installation sert un établissement.
- Les processus applicatifs, PostgreSQL, Redis et les espaces de stockage d’objets sont isolés entre établissements.
- La configuration client est montée à l’exécution plutôt qu’intégrée aux artefacts applicatifs immuables.
Répondre à un signalement d’exploitation
Validez la configuration avant de changer l’état
Lancez docker compose --env-file .env -f compose.yml config --quiet, puis inspectez docker compose --env-file .env -f compose.yml ps ainsi que les points de santé live et ready de l’API et du service de sockets.
Identifiez le service touché et la fenêtre concernée
Recueillez l’application, le rôle, la route, l’horodatage, l’état de reprise visible et les journaux pertinents, sans demander de contenu utilisateur inutile.
Utilisez les commandes de sauvegarde du dépôt
Lancez pnpm ops:check, puis créez la sauvegarde chiffrée coordonnée avec pnpm ops:backup en indiquant explicitement les chemins absolus d’environnement, de sortie et de phrase secrète.
Prouvez la capacité de reprise
Lancez pnpm ops:restore-drill sur l’archive produite avec les mêmes entrées explicites de phrase secrète et d’environnement. L’exercice n’est complet qu’avec des sommes de contrôle vérifiées et des restaurations PostgreSQL jetables réussies.
Rétablissez par des actions réversibles
Préférez les procédures documentées de redémarrage, de nouvelle tentative et de restauration vérifiée. Conservez les preuves et prenez une sauvegarde vérifiée avant une mise à niveau ou une intervention sur le schéma.
Choisir explicitement les modules facultatifs
Les modules reposant sur un service nécessitent à la fois leur profil Compose et l’indicateur d’application correspondant. La certification, l’intégrité académique et les connecteurs institutionnels utilisent une configuration privée sans profil Compose distinct. Exécutez config --quiet avant le démarrage et vérifiez l’état de chaque module avant son activation pour une organisation.
- L’accès des parents utilise le profil parents avec PARENT_MODULE_ENABLED=true. L’administration doit encore choisir « Activer le portail parents » ; le rétablissement du service ne réactive jamais ce réglage de l’établissement.
- La messagerie utilise le profil chat avec CHAT_ENABLED=true. Une panne de Matrix doit laisser disponibles la connexion au LMS et les tâches hors messagerie, tandis que la messagerie affiche les options de reprise.
- La modification de documents utilise le profil documents avec ONLYOFFICE_ENABLED=true. Une panne doit préserver les fichiers protégés des cours et leur téléchargement d’origine, tandis que l’espace de travail propose « Réessayer ».
- Les visioconférences utilisent le profil live avec LIVEKIT_ENABLED=true. Un refus d’admission ou une panne du service doit bloquer l’accès à la conférence sans affaiblir les contrôles actuels du compte, du rôle, du cours ou de la séance.
- La certification utilise le paramètre privé CERTIFICATION_MODULE_ENABLED=true sans profil Compose. L’administrateur doit encore choisir Activer la certification ; rétablir la disponibilité côté exploitant ne réactive pas le module.
- L’intégrité académique nécessite ACADEMIC_INTEGRITY_ENABLED=true, un mode fournisseur et des identifiants explicites, puis une activation distincte par l’administrateur et l’accord de l’enseignant pour le devoir. Le mode bac à sable sert au développement ou aux tests, pas aux décisions concernant les clients.
- Les connecteurs de connexion institutionnelle, de listes et de fichiers cloud utilisent des configurations de fournisseur privées distinctes. La désactivation d’un connecteur doit préserver la connexion locale, la création manuelle de comptes et le téléversement ordinaire de fichiers du cours.
Poursuivre avec
Gérer les personnes, les cours, la communication et la visibilité opérationnelle en préservant les limites d’établissement et de rôle.
Prendre ses repères dans MirketComprendre les applications de rôle, la navigation, les préférences et les limites qui déterminent ce que vous pouvez voir.
Suivre les informations scolaires d’un enfantUtilisez l’application Parents pour consulter les travaux autorisés, les notes publiées, les présences confirmées par les enseignants et les choix de notification pour chaque enfant lié.