docs(ops): ne jamais éditer le script de cycle de vie pendant son exécution

Bash lit ses scripts au fil de l'eau. Éditer le fichier en cours de route décale les offsets et corrompt l'exécution : un refresh-from-prod en cours s'est mis à afficher les messages de blank_sandbox, puis a fini sur « syntax error ». Le travail avait bien abouti — sandbox restaurée, 295 tables, 10 factures, 12 tiers — mais la trace mentait sur la fonction qui tournait. Sur un script qui purge des bases, une trace qui ment est inacceptable. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
2026-08-14 19:13:57 +02:00
parent a3540982a9
commit bc5e0603d1
1 changed files with 8 additions and 0 deletions
@@ -35,6 +35,14 @@ PG_IMAGE="postgres:16-alpine"
 DOC_ROOT="/var/www/documents"       # dolibarr_main_data_root
 TMP_PROD_SECRET="prod-db-ro-temp"   # transient copy of prod creds, deleted on exit

+# ATTENTION — NE JAMAIS ÉDITER CE FICHIER PENDANT QU'IL S'EXÉCUTE.
+# Bash lit ses scripts au fil de l'eau : modifier le fichier en cours de route
+# décale les offsets et corrompt l'exécution. Constaté le 2026-08-14 — un
+# refresh-from-prod en cours s'est mis à afficher les messages de blank_sandbox
+# puis a fini sur « syntax error ». Le travail était fait, mais la trace mentait
+# sur ce qui tournait : sur un script qui purge des bases, c'est inacceptable.
+# Attendre la fin, ou éditer une copie.
+
 log() { printf '\033[1;36m==>\033[0m %s\n' "$*"; }
 die() { printf '\033[1;31mABORT:\033[0m %s\n' "$*" >&2; exit 1; }