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

```yaml
# 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
```