pygslbpygslbconsole d'exploitation
Guide opérateur

Documentation

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.

Ouvrir le guide

Le guide est en anglais, comme la console et le produit. Il est servi par GitLab Pages, sur un domaine distinct de ce site.

Premiers pas

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: paris

Une 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.

Vérifier une décision

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 +short

routes 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.

Table des matières

Thèmes du guide

Huit chapitres, dans l'ordre où on les ouvre : installer, décrire, surveiller, tenir en double, restaurer.

Installation

Image DNS, API et console ; trois conteneurs ou une pile haute disponibilité.

Configuration

Zone, pools, règles CIDR, santé, pondération et multi-zone : le YAML complet.

Sondes

HTTP, TCP, PromQL, secrets par environnement et verdict unknown.

Haute disponibilité

VIP, keepalived en exemple, accusés de réception et compteurs agrégés.

Identité et rôles

OIDC code + PKCE, trois rôles, compte local et jetons pour les machines.

API et métriques

Routes versionnées, /metrics Prometheus et journaux JSON en option.

Ligne de commande

check, routes, probe, init : vérifier sans modifier.

Restauration

Intégrité SQLite, YAML revalidé, empreinte de la configuration attendue.