bouncer/doc/fr/tutorials/bootstrapping.md

Amorçage d'un serveur Bouncer via la configuration

Il est possible d'amorcer des données par défaut (i.e. des "proxies" et "layers" associés) via la configuration du serveur d'administration.

Attention Par défaut ce mécanisme de modifiera pas des proxies déjà existants dans la base de données du serveur Bouncer. Autrement dit, si un proxy est déjà pré-existant lors du démarrage du serveur Bouncer, il ne sera pas modifié. Vous pouvez utiliser l'attribut recreate: true pour modifier ce comportement.

La définition des proxies et layers par défaut s'effectue dans la section bootstrap du fichier de configuration. Deux possibilités pour définir les proxys à charger par défaut:

• Utiliser un répertoire contenant des fichiers YAML (un par proxy) en définissant le chemin du répertoire via l'attribut bootstrap.dir;
• Définir directement la liste des proxies via l'attribut bootstrap.proxies.

# Configuration d'une série de proxy/layers
# à créer par défaut par le serveur d'administration
bootstrap:
  # Répertoire contenant les définitions de proxy à créer
  # par défaut. Les fichiers seront récupérés si ils
  # correspondent au patron de nommage suivant:
  #
  # <bootstrap_dir>/<proxy_name>.yml
  #
  # Voir ci-dessous pour les attributs possibles dans les fichiers.
  #
  # Si l'attribut est vide ou absent le chargement des fichiers
  # est désactivé.
  dir: /etc/bouncer/bootstrap.d

  # Tableau associatif de définition de proxies à créer par
  # défaut par le serveur d'administration.
  # Si `proxies` et `dir` sont tous les deux définis, les fichiers
  # présents dans le répertoire `dir` surchargeront les valeurs définies
  # dans `proxies`.
  #
  # Par défaut vide.
  proxies:
  #     my-proxy:
  #         enabled: true                       # Activer/désactiver le proxy
  #         recreate: false                     # Forcer ou non la recréation du proxy même si celui existe
  #         from: ["*"]                         # Filtre d'origine d'activation du proxy
  #         to: "https://example.net"           # Destination du proxy
  #         weight: 0                           # Priorité du proxy
  #         layers:                             # Layers associés au proxy
  #             my-layer:
  #                 type: queue                 # Type du proxy
  #                 enabled: false              # Activer/désactiver le layer
  #                 weight: 0                   # Priorité du layer
  #                 options: {"capacity": 100}  # Options associées au layer