Synchronisation automatique
DoliClone propose un mécanisme de synchronisation automatique qui permet de maintenir le serveur de destination à jour sans intervention manuelle.
Principe
L'endpoint sync.php de l'installeur autonome est appelé périodiquement via une tâche cron. Il se connecte au serveur source, vérifie les modifications et synchronise les éléments configurés.
Configuration
Générer une clé de synchronisation
Sur l'installeur autonome du serveur de destination :
- Accédez à la section Configuration de la synchronisation automatique
- Cliquez sur Générer une clé de synchronisation
- La clé générée et l'URL cron sont affichées
Sécurité : La clé de synchronisation protège l'accès à l'endpoint. Conservez-la en lieu sûr et ne la partagez pas.
Pour régénérer une clé, cliquez sur Régénérer la clé. L'ancienne clé est immédiatement invalidée.
Options de synchronisation
| Option | Description |
|---|---|
| Activer la synchronisation automatique | Active ou désactive la synchronisation automatique |
| Synchroniser les documents | Copie les fichiers du dossier documents/ |
| Synchroniser les modules | Copie les modules complémentaires de htdocs/custom/ |
| Synchroniser la base de données | Restaure la sauvegarde SQL depuis le serveur source |
| Synchroniser le coeur Dolibarr | Télécharge et met à jour le coeur Dolibarr depuis GitHub |
| Intervalle minimum entre deux syncs | Durée minimale entre deux synchronisations (par défaut : 1 heure) |
| Email de notification | Adresse email recevant un rapport après chaque synchronisation |
Mise en place du cron
URL d'appel
L'URL à configurer dans votre crontab a la forme suivante :
https://clone.example.com/installclone/sync.php?key=VOTRE_CLE_DE_SYNCHRONISATIONParamètres optionnels
| Paramètre | Valeurs | Description |
|---|---|---|
type |
files, modules, sql, all |
Type de synchronisation à effectuer (par défaut : all) |
force |
0, 1 |
Ignorer l'intervalle minimum entre deux synchronisations |
Exemple de crontab
Pour une synchronisation complète toutes les nuits à 3h00 :
0 3 * * * curl -s "https://clone.example.com/installclone/sync.php?key=VOTRE_CLE" > /dev/null 2>&1Pour synchroniser uniquement la base de données toutes les 6 heures :
0 */6 * * * curl -s "https://clone.example.com/installclone/sync.php?key=VOTRE_CLE&type=sql" > /dev/null 2>&1Comportement
Intervalle minimum
L'intervalle minimum empêche les synchronisations trop fréquentes. Si le cron est appelé avant l'expiration de l'intervalle, la synchronisation est refusée avec un message indiquant le temps d'attente restant.
Pour ignorer cette restriction, ajoutez &force=1 à l'URL.
Vérification de version
Avant chaque synchronisation, l'installeur vérifie la version de Dolibarr sur le serveur source. Si la version a changé, la synchronisation du coeur Dolibarr est proposée.
Résultat de la synchronisation
La réponse JSON contient :
- L'état de réussite ou d'échec
- Le détail des opérations effectuées
- La date de début et de fin
- La durée totale
Dernière synchronisation
La date et le résultat de la dernière synchronisation sont affichés sur la page de configuration de l'installeur.
Tableau de bord
La page dashboard.php de l'installeur affiche l'historique des synchronisations avec des statistiques globales :
- Nombre total de synchronisations
- Nombre de fichiers synchronisés
- Nombre d'erreurs
- Synchronisations en cours
