48 lines
2.9 KiB
Markdown
48 lines
2.9 KiB
Markdown
# 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"](../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 --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](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 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. |