SEC.01
Le playbook
Le run démarre en lecture seule : les sondes de reconnaissance décident de la suite. Les étapes qui suivent sont adaptées à la distribution et à l'état trouvés — une vraie machine est rarement propre.
- 01recondistro (apt ou dnf) et architecture (amd64/arm64)
- 02reconPrometheus déjà installé (paquet ou binaire) ? service actif ?
- 03reconconfig ou données existantes à préserver
- 04reconport 9090 libre ? sinon qui l’occupe
- 05reconnode_exporter local à scraper (9100) ? disque libre pour la TSDB
- 06agirUtilisateur et dossiersvérif
- 07agirInstaller les binaires (dernière release, checksum vérifié)vérif
- 08agirConfig de scrape (seulement si absente)vérif
- 09agirService systemd (écoute 127.0.0.1:9090)vérif
- 10agirRépond sur :9090vérif
SEC.02
Ce qu'elle vérifie
Chaque étape embarque sa propre vérification. Le run ne continue que si elle passe, donc ce que la recette annonce comme fait est ce qui est réellement sur le serveur.
- 01vérifUtilisateur et dossiersVérifié par
stat -c '%U' /var/lib/prometheusattendu : prometheus - 02vérifInstaller les binaires (dernière release, checksum vérifié)Vérifié par
/usr/local/bin/prometheus --version 2>&1 | head -1attendu : prometheus, version 3.x - 03vérifConfig de scrape (seulement si absente)Vérifié par
/usr/local/bin/promtool check config /etc/prometheus/prometheus.ymlattendu : SUCCESS - 04vérifService systemd (écoute 127.0.0.1:9090)Vérifié par
systemctl is-active prometheusattendu : active - 05vérifRépond sur :9090Vérifié par
curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:9090/-/readyattendu : 200
SEC.03
Les garde-fous
Les consignes non négociables que le run doit respecter, quoi qu'il trouve sur le serveur.
Ne touche jamais aux données de /var/lib/prometheus ni à un prometheus.yml existant. Prometheus n’a pas d’authentification : il écoute sur 127.0.0.1, ne l’expose pas sans reverse proxy protégé.
SEC.04
Les variables
Ce que vous choisissez avant de lancer — la recette s'occupe du reste.
| Nom | Signification |
|---|---|
| ${retention} | Rétention des métriques |
SEC.05
Comment une recette s'exécute dans Servor
Servor est zero-knowledge : la plateforme ne peut rien exécuter seule. Quand vous lancez cette recette, un run lit la reconnaissance, planifie les étapes et demande votre validation. Chaque commande approuvée est signée par votre navigateur — avec une clé que le serveur ne voit jamais — puis relayée telle quelle à l'agent, qui vérifie la signature localement avant d'exécuter.
recherche par intention — tapez « firewall », obtenez ufw
- 01Reconnaissance en lecture seule avant tout changement
- 02Chaque commande signée par votre navigateur, validée par vous
- 03Chaque étape vérifiée avant de continuer, chaque run conservé dans l'historique
SEC.06
Bouton Deploy on Servor
Vous maintenez Prometheus ou un projet qui en dépend ? Ajoutez ce bouton à votre README ou à votre site : en un clic, vos utilisateurs l'installent sur leur propre serveur.
SEC.07
D'autres recettes observabilité
- 01node_exporterExportateur de métriques système Prometheus, en service systemd.
- 02NetdataMonitoring temps réel Netdata (canal stable), interface locale sur :19999.
- 03GrafanaGrafana OSS (dépôt officiel), local sur :3000, admin à mot de passe aléatoire.
- 04Grafana LokiAgrégation de logs Loki 3.7 via Docker, locale sur :3100.
- 05Stack Grafana + PrometheusGrafana + Prometheus + node_exporter via Docker Compose, datasource préconfigurée, tout en local.
Recette vérifiée
Lancez cette recette sur votre serveur
Connectez un serveur, lancez la recette, et validez chaque étape pendant que Servor exécute et vérifie. Plan gratuit, sans carte bancaire.