Daniel Allaire
1832530f29
Ajout de meta/supervision.yml a six roles, chacun deposant sa propre sonde selon le contrat des greffons Nagios. DEUX PRINCIPES POSES AU DOCUMENT DE CONCEPTION, parce que la premiere sonde les a imposes : 1. UNE SONDE DOIT POUVOIR ETRE MISE EN DEFAUT PAR PARAMETRE. Cible et seuils sont des variables du role : on la prouve rouge avec un port ferme ou un seuil impossible, sur une machine reelle, sans rien casser, et aussi souvent qu on veut. Une sonde qu on ne peut prouver qu en cassant un service ne sera prouvee qu une fois. 2. LA SONDE VIT LA OU VIT LA VERITE. « Ce noeud est-il collecte ? » est une sonde de serveur_prometheus, pas de client_metrique : une seule y voit les N noeuds, et surtout elle voit le cas SILENCIEUX — celui qui a cesse d etre collecte ne peut pas s en plaindre. LES SIX : cache-apt (artefacts, repond + place), resolution (resolveur, zone interne ET Internet — deux chemins distincts), forge (forgejo, son propre /api/healthz), collecte (prometheus, 15/15 cibles), tableaux (grafana, base ok), ingestion (loki, PRET a ingerer, pas seulement en ecoute). TROIS FOIS J AI ECRIT LA SONDE AVANT DE MESURER, ET TROIS FOIS ELLE A EU TORT. La forge : port 443 et chemin des depots INVENTES — elle ecoute en 3000 derriere l edge et n a legitimement aucun depot. Loki : j ai conclu « panne persistante » sur deux lectures prises a quelques secondes d intervalle, juste apres un redemarrage ; l anneau etait ACTIVE et la reponse est passee a ready moins d une minute plus tard. Le delai de stabilisation est desormais un AVERTISSEMENT nomme, pas une panne. On demande au service ce qu il pense de lui-meme quand il sait le dire (healthz, /ready, /api/health) plutot que d inventer un critere de l exterieur. make prouver : CONFORME. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Crgis8CxCWkAGFA1ecBz3q
50 lines
2 KiB
Django/Jinja
50 lines
2 KiB
Django/Jinja
#!/bin/bash
|
|
# GENERE par Set-OPS (role serveur_forgejo). Ne pas editer a la main.
|
|
#
|
|
# SONDE « forge » — la forge est-elle en etat de servir ?
|
|
#
|
|
# Contrat : docs/supervision-conception.md (API des greffons Nagios) — une ligne, 0/1/2.
|
|
# Mise en defaut PAR PARAMETRE : `serveur_forgejo_sonde_url` (port ferme).
|
|
#
|
|
# ON DEMANDE A FORGEJO CE QU'IL PENSE DE LUI-MEME. `/api/healthz` verifie sa BASE et son
|
|
# CACHE et rend `pass` ou non. C'est plus juste que tout ce qu'on inventerait de
|
|
# l'exterieur : une forge dont la base est tombee sert encore ses pages statiques et
|
|
# repond a `/api/v1/version` — elle a l'air vivante et ne peut plus rien faire.
|
|
#
|
|
# PREMIERE VERSION FAUSSE, ET INSTRUCTIVE (2026-09-10). Elle visait le port 443 et
|
|
# comptait les depots sous `/var/lib/forgejo/repositories`. Les deux etaient INVENTES :
|
|
# la forge du tenant ecoute en 3000 derriere l'edge, et elle n'a legitimement AUCUN depot
|
|
# — elle est neuve. La sonde criait donc deux fois sur un service sain. On lit la verite
|
|
# du role, on ne la suppose pas.
|
|
set -uo pipefail
|
|
|
|
URL={{ serveur_forgejo_sonde_url }}
|
|
|
|
sortie=$(curl -s --max-time 10 "${URL}/api/healthz" 2>/dev/null)
|
|
[[ -n "${sortie}" ]] || { echo "La forge ne repond pas sur ${URL}."; exit 2; }
|
|
|
|
verdict=$(printf '%s' "${sortie}" | python3 -c '
|
|
import json, sys
|
|
try:
|
|
d = json.load(sys.stdin)
|
|
except Exception:
|
|
print("2|reponse illisible de /api/healthz"); raise SystemExit
|
|
etat = d.get("status")
|
|
mauvais = sorted(n for n, v in (d.get("checks") or {}).items()
|
|
if any((c or {}).get("status") != "pass" for c in (v or [])))
|
|
if etat == "pass" and not mauvais:
|
|
print("0|" + ", ".join(sorted(d.get("checks") or {})) + " : pass")
|
|
else:
|
|
print("2|statut " + str(etat) + (" ; en defaut : " + ", ".join(mauvais) if mauvais else ""))
|
|
' 2>/dev/null)
|
|
|
|
code=${verdict%%|*}
|
|
texte=${verdict#*|}
|
|
[[ -n "${code}" ]] || { echo "Verdict de sante illisible."; exit 2; }
|
|
|
|
if [[ "${code}" == "0" ]]; then
|
|
echo "Forge en etat de servir — ${texte}."
|
|
exit 0
|
|
fi
|
|
echo "Forge EN DEFAUT — ${texte}."
|
|
exit 2
|