William Petit
d12ebfc642
All checks were successful
Cadoles/bouncer/pipeline/pr-develop This commit looks good
48 lines
2.3 KiB
Markdown
48 lines
2.3 KiB
Markdown
# 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** 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é.
|
|
|
|
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
|
|
# 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
|
|
```
|