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

# Ajouter un layer 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"](../getting-started.md).

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

    ```bash
    bouncer admin layer update --proxy-name cadoles --layer-name my-queue --layer-enabled=true --layer-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](https://json-schema.org/).
    > 
    > Par exemple, le schéma du calque type 'queue' est consultable [ici](../../../internal/queue/schema/layer-options.json).

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 une page indiquant qu'on est en file d'attente.

    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.