Installation
Image DNS, API et console ; trois conteneurs ou une pile haute disponibilité.
Le guide est écrit pour un opérateur : chaque page contient une commande qui marche, un tableau qui correspond au code, et une limite assumée.
Le guide est en anglais, comme la console et le produit. Il est servi par GitLab Pages, sur un domaine distinct de ce site.
Un fichier YAML décrit la zone, les pools et les règles ; le processus DNS le lit et répond.
zone: app.example.com.
ttl: 30
default_pool: paris
health:
interval: 5
timeout: 2
pools:
paris:
- name: paris-1
ip: 192.0.2.10
healthcheck_url: https://192.0.2.10/health
- name: paris-2
ip: 192.0.2.11
healthcheck_url: https://192.0.2.11/health
network_rules:
- cidr: 198.51.100.0/24
pool: parisUne sonde plus riche remplace healthcheck_url : méthode, en-têtes par variable d'environnement, corps JSON, statut attendu, extraction d'un champ, ou une requête PromQL comparée à un seuil.
La question qui revient en exploitation : « pourquoi ce poste reçoit-il cette adresse ? ».
python -m gslb routes --ip 192.0.2.21
python -m gslb check
dig @192.0.2.53 _whoami.app.example.com TXT +shortroutes affiche la règle gagnante et les adresses qui peuvent répondre ; check valide le fichier servi et sort en erreur s'il est refusé ; _whoami dit quelle adresse le service voit réellement pour le poste d'où vous interrogez.
Huit chapitres, dans l'ordre où on les ouvre : installer, décrire, surveiller, tenir en double, restaurer.
Image DNS, API et console ; trois conteneurs ou une pile haute disponibilité.
Zone, pools, règles CIDR, santé, pondération et multi-zone : le YAML complet.
HTTP, TCP, PromQL, secrets par environnement et verdict unknown.
VIP, keepalived en exemple, accusés de réception et compteurs agrégés.
OIDC code + PKCE, trois rôles, compte local et jetons pour les machines.
Routes versionnées, /metrics Prometheus et journaux JSON en option.
check, routes, probe, init : vérifier sans modifier.
Intégrité SQLite, YAML revalidé, empreinte de la configuration attendue.