bouncer/doc/fr/tutorials/add-queue-layer.md

Ajouter un calque de type "file d'attente"

Étapes

1. Sur le serveur hébergeant les services Bouncer, utiliser le CLI pour créer un nouveau calque ("layer") pour votre proxy. Dans l'exemple, nous utiliserons le proxy cadoles créé dans le cadre du tutoriels "Premiers pas".

   # Création d'un calque nommé 'my-queue' pour le proxy 'cadoles' de type 'queue'
   bouncer admin layer create --proxy-name cadoles --layer-name my-queue --layer-type queue
   

   Un message équivalent à celui ci devrait s'afficher:

   +----------+-------+---------+--------+---------+-------------------------+-------------------------+
   | NAME     | TYPE  | ENABLED | WEIGHT | OPTIONS | CREATEDAT               | UPDATEDAT               |
   +----------+-------+---------+--------+---------+-------------------------+-------------------------+
   | my-queue | queue | false   | 0      | {}      | "2023-05-28T14:40:25... | "2023-05-28T14:40:25... |
   +----------+-------+---------+--------+---------+-------------------------+-------------------------+
   

2. À ce stade, le calque est encore inactif. Définir la capacité de la file d'attente à 1 et activer le calque en utilisant le CLI

   bouncer admin layer update --proxy-name cadoles --layer-name my-queue --enabled=true --options '{"capacity": 1}'
   

   Un message équivalent à celui ci devrait s'afficher:

   +----------+-------+---------+--------+----------------+-------------------------+-------------------------+
   | NAME     | TYPE  | ENABLED | WEIGHT | OPTIONS        | CREATEDAT               | UPDATEDAT               |
   +----------+-------+---------+--------+----------------+-------------------------+-------------------------+
   | my-queue | queue | true    | 0      | {"capacity":1} | "2023-05-28T14:51:45... | "2023-05-28T14:52:21... |
   +----------+-------+---------+--------+----------------+-------------------------+-------------------------+
   

   Astuce

   Les options de chaque type de calque répondent à un schéma spécifique, défini au format JSON Schema.

   Par exemple, le schéma du calque type 'queue' est consultable ici.

3. Le proxy cadoles a désormais une file d'attente avec une capacité d'un seul utilisateur. Vous pouvez effectuer le test en ouvrant votre navigateur sur l'adresse http://<ip_serveur>:8080/ puis en ouvrant une fenêtre de navigation privée sur la même adresse:

   • La première fenêtre devrait afficher le site Cadoles;
   • La seconde fenêtre devrait afficher le message suivant: queued (rank: 2, status: 2/1).

   Si vous laissez expirer la "session" de la première fenêtre (environ 1 minute par défaut) et que vous rafraîchissez la seconde, vous devriez avoir une inversion des états.