From c84d3d3838cb0ada0c88b6f89365a62e83d9b6b2 Mon Sep 17 00:00:00 2001 From: Valentin Lab Date: Tue, 29 Aug 2023 22:41:40 +0200 Subject: [PATCH] new: doc: updated troubleshooting doc phrasing and adding cache clearing entry --- README.org | 46 +++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 41 insertions(+), 5 deletions(-) diff --git a/README.org b/README.org index ddf3370..017ed1f 100644 --- a/README.org +++ b/README.org @@ -1041,8 +1041,9 @@ suivants: =mailcow=, =postfix=, =rspamd=, =redis=, =crypt=, =vmail=, ** Troubleshooting -S'il semble qu'il y ait un soucis, tu peux visualiser le =docker-compose.yml= qui est -généré à la fin via l'ajout de =--debug= AVANT la commande: +S'il semble qu'il y a un soucis, il est possible de visualiser le +=docker-compose.yml= qui est généré à la fin via l'ajout de =--debug= +AVANT la commande: #+begin_src sh compose --debug up odoo frontend @@ -1050,16 +1051,49 @@ compose --debug up odoo frontend *** en cas de soucis important ou inédit +**** Lancer un ~compose --debug up~ + +La simple action de relancer un ~compose --debug up~ permet à compose +de repasser sur tous les scripts et notamment cela permet de recréer +toutes les configurations, aussi certains des containers peuvent être +également recréés et relancés. Notamment si de nouvelles images de +services ont été ~pull~ récemment. + +#+begin_src sh +compose --debug up +#+end_src + +Si cette commande ne fonctionne pas, prendre le temps de bien lire le +message d'erreur. + +**** Vider les cache de ~/var/cache/compose~ + +En cas de problème non expliqués et inédits, il est bon de vérifier si +l'effacement des caches de compose ne permet pas de corriger le +problème : + +#+begin_src sh +rm /var/cache/compose/* +#+end_src + +Puis relancer la commande qui ne fonctionne pas (par exemple ~compose +--debug up~). + **** Redémarrage du service =docker= -Il y a de nombreux bugs répertoriés sur docker qui n'ont pas été -réglés depuis de nombreuses années qui sont corrigés par un restart de + +Il y a de nombreux bugs répertoriés sur ~docker~ qui n'ont pas été +réglés depuis de nombreuses années qui sont corrigés par un ~restart~ de tous les containers et du service docker lui-même. #+begin_src sh systemctl restart docker.service #+end_src -va redémarrer le service docker sur la machine et donc tous les services gérés par docker (tous les services en sommes). +va redémarrer le service docker sur la machine et donc tous les +services gérés par docker (tous les services en somme). + +La coupure de service de cette commande est relativement courte +(inférieure à la minute). **** Redéploiement des services @@ -1068,6 +1102,8 @@ l'être dans certains cas. Cela va stopper et effacer tous les containers des services, puis reconstruire toute leur configuration et les relancer. +Attention cela engendre une coupure de service qui peut être longue (le temps +d'un ~compose up~ complet). #+begin_src sh compose --debug down &&