From c84d3d3838cb0ada0c88b6f89365a62e83d9b6b2 Mon Sep 17 00:00:00 2001
From: Valentin Lab <valentin.lab@kalysto.org>
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 &&