Boîte à outils

Docker Compose — OpenMRS 3.7.1

Le modèle directement importable dans un service Docker Compose Coolify pour OpenMRS 3.7.1.

Publication
septembre 2026
Langue
FR
Thématiques
Données pour le développement, Technologies pour le développement

Résumé

Cette ressource met en place passerelle, frontend O3, backend OpenMRS et MariaDB. Profil retenu : application de référence o3 à quatre services. Elle accompagne le guide complet de déploiement.

Architecture

Passerelle, frontend o3, backend openmrs et mariadb. Le domaine public est attribué au service d’entrée ; les autres composants communiquent sur le réseau interne.

Prérequis

Un serveur compatible avec les besoins de la solution, Docker géré par Coolify, un domaine pointé vers le serveur, un espace de stockage persistant et un accès administrateur à la plateforme. La mémoire, le processeur et le disque doivent être dimensionnés selon les utilisateurs, les données et les tâches de fond. OpenMRS est une plateforme modulaire de dossier médical conçue pour être adaptée aux pratiques et aux terminologies d’un système de santé.

Variables, secrets et volumes

Les variables décrivent les domaines et le comportement de l’application. Les secrets sont générés une fois et partagés avec les services qui utilisent la même identité. L’état durable comprend la base clinique MariaDB et les données applicatives persistantes du backend.

Installation et validation

Créer un service Docker Compose, importer le fichier, attribuer le domaine, compléter les paramètres puis lancer le déploiement. Attendre les initialisations et exercer le parcours suivant : démarrage complet, routage public, authentification, parcours clinique représentatif, redémarrage et conservation des données.

Sauvegarde, restauration et mise à jour

Sauvegarder la base de façon cohérente et vérifier les migrations et la configuration de la distribution lors de la restauration. Avant une mise à jour, produire un point de reprise, tester la nouvelle version dans un environnement isolé et rejouer le parcours d’acceptation.

Lecture du fichier

Le bloc services décrit les conteneurs et leurs responsabilités. Les ancres réutilisent les variables communes sans dupliquer leur définition. Les volumes nommés identifient les états qui survivent aux redéploiements. Les contrôles de santé et les conditions de dépendance organisent le passage de la base vers l’initialisation, puis vers le service courant. La distribution de référence O3 assemble une interface récente et le cœur clinique.

Avant toute adaptation, repérer le service exposé, le propriétaire des migrations, les travailleurs, les magasins d’état et les fichiers gérés. Modifier ensuite une responsabilité à la fois et conserver un parcours de validation reproductible. Une mise en œuvre doit préparer concepts, formulaires, identifiants, rôles et interopérabilité, puis valider ces choix avec les équipes de soins.

Exploitation

Après installation, suivre le domaine public, les certificats, la santé des services, l’espace disque, les files et la croissance des bases. Les comptes administrateurs nominatifs remplacent les accès partagés. Les changements de configuration sont relus, datés et accompagnés d’un contrôle fonctionnel. Le déploiement conserve quatre responsabilités : gateway, frontend O3, backend OpenMRS et MariaDB.

Adapter sans casser le contrat

Une nouvelle version peut modifier les images, variables, migrations ou chemins persistants. Comparer la composition avec la documentation de la version ciblée, mettre à jour dans un environnement isolé et vérifier les fonctions réellement utilisées. Le modèle reste un point de départ opérationnel, pas un substitut à l’administration du service. La passerelle reste derrière le proxy Coolify parce qu’elle connaît les routes du produit.

Contrôles avant partage

Vérifier que le fichier ne contient aucun mot de passe ni domaine privé, que les images sont versionnées, que tous les volumes utiles sont nommés et que le service public possède un contrôle de santé. Relire ensuite les instructions d’installation avec une personne qui n’a pas participé à la conception. Le premier démarrage du backend peut être long pendant la création du schéma et le chargement des modules ; le délai du healthcheck doit refléter cette réalité.

Points de contrôle du modèle

Le Compose attache le domaine au gateway et relie frontend, backend et base sur le réseau interne. Les identités MYSQL, MYSQLROOT et ADMIN sont réutilisées exactement par les services concernés. Modifier un mot de passe après initialisation ne réécrit pas l’état persistant ; la rotation doit suivre une procédure coordonnée avec MariaDB et OpenMRS.