Cadoles/bouncer
Cadoles
/
bouncer
10
0
Fork 0
Code Issues 2 Pull Requests Projects Releases 3 Wiki Activity
bouncer/doc/fr/getting-started.md

3.3 KiB
Raw Blame History

Premiers pas

Prérequis

  • Une machine Ubuntu 22.04

Étapes

Installation

  1. Installer le serveur Redis

    apt update
apt install redis

  2. Sur votre machine Ubuntu, télécharger les dernières versions disponibles du paquet Debian correspondant à votre architecture sur la page "Versions" du projet:

    • bouncer-bin_<version>_linux_<arch>.deb
    • bouncer-proxy_<version>_linux_<arch>.deb
    • bouncer-admin_<version>_linux_<arch>.deb

  3. Installer les paquets Debian

    # Commencer par le paquet bouncer-bin
dpkg -i "bouncer-bin_<version>_linux_<arch>.deb"

# Puis installer les paquets de services
dpkg -i "bouncer-proxy_<version>_linux_<arch>.deb"
dpkg -i "bouncer-admin_<version>_linux_<arch>.deb"

  4. Générer un jeton d'authentification pour le CLI d'administration

    bouncer --config /etc/bouncer/config.yml auth create-token --role writer --subject $(whoami) > .bouncer-token

  5. Tester que le CLI est en capacité d'interroger l'API d'administration

    bouncer admin query proxy

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

    +------+---------+--------+
| NAME | ENABLED | WEIGHT |
+------+---------+--------+
+------+---------+--------+

Créer un premier proxy

  1. Créer un proxy vers https://www.cadoles.com via le CLI

    # Création du proxy nommé 'cadoles' vers https://www.cadoles.com
bouncer admin proxy create --to https://www.cadoles.com --proxy-name cadoles

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

    +---------+-------+-------------------------+---------+--------+-------------------------+-------------------------+
| NAME    | FROM  | TO                      | ENABLED | WEIGHT | CREATEDAT               | UPDATEDAT               |
+---------+-------+-------------------------+---------+--------+-------------------------+-------------------------+
| cadoles | ["*"] | https://www.cadoles.com | false   | 0      | "2023-05-28T14:28:46... | "2023-05-28T14:28:46... |
+---------+-------+-------------------------+---------+--------+-------------------------+-------------------------+

  2. À ce stade, le proxy est créé mais encore inactif. Activer le proxy

    # Activation du proxy
bouncer admin proxy update --proxy-name cadoles --enabled=true

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

    +---------+-------+-------------------------+---------+--------+-------------------------+-------------------------+
| NAME    | FROM  | TO                      | ENABLED | WEIGHT | CREATEDAT               | UPDATEDAT               |
+---------+-------+-------------------------+---------+--------+-------------------------+-------------------------+
| cadoles | ["*"] | https://www.cadoles.com | true    | 0      | "2023-05-28T14:28:46... | "2023-05-28T14:28:55... |
+---------+-------+-------------------------+---------+--------+-------------------------+-------------------------+

  3. Ouvrir la page https://<ip_serveur>:8080/ dans un navigateur. Le site Cadoles s'affiche !

Bravo, vous avez créé votre premier proxy avec Bouncer !