Installer et exploiter Prudence
Tout ce qu'il faut pour installer Prudence sur votre hébergement sans terminal, superviser vos machines et garder l'application à jour. Version actuelle : 1.2.0.
1. Prérequis
- PHP 8.3, 8.4 ou 8.5 avec les extensions
pdo_mysql,mbstring,openssl,curl(etzippour l'import Excel). - Une base MySQL 8 ou MariaDB 10.6 vide, avec un utilisateur dédié et son mot de passe (depuis votre panneau, par exemple Plesk : Bases de données → Ajouter une base ; cPanel : Bases de données MySQL).
- Les dossiers
storage/etbootstrap/cache/et le fichier.envinscriptibles par PHP. L'assistant le vérifie avant de commencer.
2. Installation sans terminal (hébergement mutualisé : Plesk, cPanel, Webmin, Virtualmin…)
- Récupérez l'archive
prudence-vX.Y.Z.zip. Elle contient toutes les dépendances : Composer n'est pas nécessaire sur le serveur. - Téléversez-la et extrayez-la dans votre abonnement (gestionnaire de fichiers du panneau), puis pointez la racine du document du domaine ou sous-domaine sur
prudence/publicet activez Let's Encrypt. - Ouvrez le site : l'application prépare sa configuration et affiche le diagnostic du serveur.
- Suivez l'assistant : base de données (connexion testée, tables créées), application (nom, URL, fuseau), premier administrateur, messagerie (facultative), finalisation. L'assistant se ferme ensuite définitivement.
- Créez la tâche planifiée indiquée à la dernière étape (section suivante).
3. Planificateur (indispensable)
La supervision repose sur une tâche lancée chaque minute.
- Plesk : Tâches planifiées → Ajouter → Exécuter un script PHP : script
…/prudence/artisan, argumentsschedule:run, toutes les minutes. - cPanel : Tâches Cron → toutes les minutes, commande
cd /home/UTILISATEUR/prudence && php artisan schedule:run >> /dev/null 2>&1. - Webmin / Virtualmin : Tâches planifiées (cron) → toutes les minutes, même commande avec le chemin de votre installation.
- Certains hébergeurs limitent la fréquence des tâches : vérifiez que la vôtre peut tourner chaque minute.
- Linux (cron) :
* * * * * cd /var/www/prudence && php artisan schedule:run >> /dev/null 2>&1
Son état est visible dans Paramètres → Application (dernière exécution).
4. Superviser une machine avec l'agent
- Dans Prudence : Infrastructure → Ajouter une machine. Un jeton unique est généré et affiché une seule fois.
- Sur la machine, installez l'agent (Python) et son service :
- Linux : service systemd
prudence-agent; - Windows :
install-windows.ps1en PowerShell administrateur ; - macOS :
install-macos.sh(launchd).
- Linux : service systemd
- La machine apparaît dans Infrastructure dès la première remontée.
5. Clé API Plesk
Sur le serveur Plesk, créez une clé limitée à l'adresse IP de Prudence :
plesk bin secret_key -c -ip-address <IP_DE_PRUDENCE> -description "Prudence"
Puis, dans Prudence : Recensement Plesk → Ajouter un serveur. Si Prudence est installé sur le serveur Plesk lui-même, cochez « Le dashboard tourne sur ce serveur Plesk » : aucune clé n'est nécessaire.
6. Mise à jour
- Remplacez les fichiers par ceux de la nouvelle archive, en conservant
.envetstorage/. - Dans Paramètres → Maintenance : « Mettre à jour la base », puis « Vider tous les caches ».
7. Licence
Évaluation gratuite de 30 jours après l'installation. Ensuite, sans licence, Prudence passe en mode dégradé : collectes, contrôles et alertes critiques sont maintenus, les modifications sont verrouillées. Un super-administrateur saisit la clé dans Paramètres → Licence. La clé est liée à votre domaine et vérifiée hors ligne.
Une question ? Contactez-nous ou consultez la FAQ.