Maintenance & Mise à jour
Le maintien en conditions opérationnelles de Directus YFI repose sur quelques scripts et procédures standard.
Scripts de Maintenance
Situés à la racine /home/ubuntu/, ils permettent de gérer l'ensemble des services.
Relance simple (relance.sh)
Purger les anciens caches et redémarrer les conteneurs :
./relance.sh
Mise à jour complète (maj.sh)
Mise à jour système + Docker + Application :
./maj.sh --backup
- Sauvegarde : Crée un tar.gz de tous les volumes Docker.
- Purge : Nettoie les anciennes images Docker orphelines.
Procédure de déploiement de l'extension
- Modifier le code dans
apps/directus-extension-you-find-it/src. - Lancer le build :
pnpm -C apps/directus-extension-you-find-it run build. - Redémarrer Directus pour charger le nouveau bundle.
Logs & Debugging
- Logs Docker :
docker logs -f yfi - Logs SQL : Accessibles via phpMyAdmin sur
123yfi.you-find-it.com. - Mode Debug : Modifier
LOG_LEVEL=debugdans ledocker-compose.yml.
Troubleshooting (Problèmes courants)
Erreur 502 Bad Gateway
- Vérifier que le conteneur
yfiest bien "Up" :docker ps. - Vérifier que le réseau
nginx-proxyest bien connecté.
L'extension ne se charge pas
- Vérifier le montage du volume dans
docker-compose.yml. - Consulter les logs au démarrage de Directus pour voir les erreurs de compilation/chargement.
Tuer / Redémarrer le process Node.js (you-find-it.com)
Sur le serveur ndigital-cpi1-prod-web1, le front-end Nuxt tourne en tant que process Node.js indépendant. En cas de blocage, il faut l'identifier et le tuer manuellement.
1. Trouver le PID du process
ps aux | grep node
Exemple de sortie :
prod_yo+ 2519270 1.4 3.5 22771516 288576 ? Ssl 14:15 0:16 node /var/www/you-find-it.com/web/.output/server/index.mjs
2. Tuer le process
kill <PID>
Exemple :
kill 2519270
warning
Après le kill, le process doit être relancé par le service qui le supervise (systemd, PM2, etc.). Vérifier que le site est bien remonté après l'opération.