HTTP
Méthode, en-têtes (dont les secrets par variable d'environnement, jamais dans le YAML), corps JSON borné, statut attendu, extraction d'un champ dans la réponse.
Le périmètre complet, y compris ce qui n'est pas fait. Si une ligne manque à votre besoin, dites-le avant de choisir l'outil.
La décision tient dans une table : un réseau source, un pool. La règle au préfixe le plus long gagne, une seule fois, à chaque requête.
| Choix du pool | Règle CIDR sur l'adresse source du client, préfixe le plus long d'abord ; pool par défaut quand aucune règle ne correspond. |
|---|---|
| Répartition | Round-robin pondéré entre les backends sains d'un pool ; un poids nul retire un backend de la rotation sans le supprimer. |
| A et AAAA | Un backend peut porter une adresse IPv6 en plus de son IPv4 ; sans adresse IPv6, la réponse AAAA est vide plutôt que fausse. |
| Zones | Plusieurs zones dans un même fichier, pools isolés : une zone ne peut pas référencer le pool d'une autre. |
| Client inconnu | Toutes les règles ratent : le pool par défaut répond, et le compteur l'enregistre sous no_rule pour que vous le voyiez. |
Trois types de sondes, et une règle : une sonde qui ne peut pas conclure ne retire pas un backend.
unknown : le backend garde son état, un avertissement est écrit.Méthode, en-têtes (dont les secrets par variable d'environnement, jamais dans le YAML), corps JSON borné, statut attendu, extraction d'un champ dans la réponse.
La connexion s'ouvre ou elle ne s'ouvre pas. Utile pour un port applicatif qui n'a pas d'endpoint de santé.
Une requête sur le Prometheus que vous exploitez déjà, comparée à un seuil. C'est aussi la base du mode « dégradé » : un nœud peut sortir de la rotation avant de tomber.
Deux échecs consécutifs retirent un backend ; un succès le remet. Une supervision injoignable, un JSON illisible ou une variable absente laissent l'état précédent et écrivent un avertissement : une panne de supervision ne devient pas une panne DNS.
Les gestes de la journée : modifier, surveiller, restaurer, et vérifier une décision sans attendre une fenêtre de changement.
Modifier la zone sans redémarrer : validation, écriture atomique, accusé de réception de chaque nœud, retour au fichier précédent si un nœud refuse. Historique versionné avec diff, restauration, export CSV.
OIDC (code + PKCE) avec trois rôles — lecteur, opérateur, administrateur — ou un compte local et des jetons pour les machines. Les écritures par cookie exigent l'en-tête de la console et une origine connue.
/metrics au format Prometheus, journaux JSON en option, latence DNS p50/p95/p99 dans la console. Aucun serveur de métriques à déployer de notre côté.
python -m gslb check
python -m gslb routes --ip 192.0.2.21
python -m gslb probe --all
python -m gslb init --zone app.example.com. \
--backend dal=192.0.2.10 --backend lyo=192.0.2.11check valide le fichier servi et sort en erreur s'il est refusé ; routes dit quelle décision le resolver prendrait pour une adresse, sans rien modifier.
Une sauvegarde ne vaut que relue : le script vérifie l'intégrité de la base, revalide le YAML avec le même binaire et compare l'historique à l'empreinte attendue. Le test correspondant tourne en CI.
Deux nœuds ou plus derrière une adresse flottante, et aucun état partagé à administrer.
Chaque nœud sert le DNS ; l'adresse flottante se déplace (keepalived en exemple, pas en dépendance). Chaque nœud sonde et répond seul.
Un enregistrement attend l'accusé de réception de tous les nœuds vivants ; un nœud muet est signalé sans bloquer éternellement.
L'API additionne les instantanés de la flotte, garde l'état de santé le plus pessimiste et signale les nœuds désaccordés.
Ces limites sont documentées et assumées ; elles ne sont pas au calendrier. Dites-nous si l'une d'elles est rédhibitoire, c'est plus utile qu'une démonstration.