Boîte à outils
Docker Compose — Frappe Framework 16.32.0
Le modèle directement importable dans un service Docker Compose Coolify pour Frappe Framework 16.32.0.
- 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 MariaDB, deux Redis, configurateur, bootstrap, migrateur, backend, WebSocket, workers, scheduler et frontend. Profil retenu : site frappe mono-instance sans activation erpnext. Elle accompagne le guide complet de déploiement.
Architecture
Mariadb, deux redis, configurateur, bootstrap, migrateur, backend, websocket, workers, scheduler et frontend. 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. Frappe Framework sert à construire des applications pilotées par les métadonnées : DocTypes, formulaires, vues, permissions, rapports, pièces jointes et API sont réunis dans un même cadre.
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 MariaDB, le répertoire sites, les fichiers publics et privés et la configuration générée.
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 : installation fraîche, bootstrap automatique, HTTPS, authentification, écriture et lecture, fichiers, workers, scheduler, temps réel, redémarrage, redéploiement, sauvegarde et restauration isolée.
Sauvegarde, restauration et mise à jour
Restaurer la sauvegarde frappe, les fichiers et la configuration avec des secrets cohérents. 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. Il convient à une organisation qui accepte de gouverner un produit applicatif dans la durée.
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. Le modèle fonctionnel, les rôles et les règles de validation doivent être définis avec les équipes métier.
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. La topologie suit Frappe Docker : MariaDB, Redis cache, Redis queue, configurateur, bootstrap de site, migrateur, backend, WebSocket, workers, scheduler et frontend.
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. Le frontend Nginx demeure la passerelle sémantique derrière le proxy Coolify.
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. Cette page porte sur un site Frappe sans activation ERPNext, différence qui doit rester visible jusque dans les tests d’acceptation.
Points de contrôle du modèle
L’opérateur doit confirmer le domaine du frontend, le nom du site, les secrets de base, les trois volumes durables et la fin des tâches configurator, site-bootstrap et migrator. Ces services one-shot ont des post-conditions distinctes. Les relancer aveuglément sur un site partiellement initialisé peut masquer l’état réel ; il faut d’abord examiner le répertoire sites et la base.