Environnement de tests

Tester hiboo nécessite le déploiement de multiples composants pour simuler des applications interagissant avec. La configuration suivante permet de déployer localement :

• un serveur Matrix
• un serveur Mastodon
• un serveur Writefreely

L’environnement de tests ne contient pas d’instance de hiboo. Il est nécessaire d’employer votre environnement de développement hiboo en complément.

Installer Docker et Compose

Installer Docker depuis la configuration sur Docker CE : https://docs.docker.com/engine/install/ .

Installer Docker Compose depuis le projet Github : https://docs.docker.com/compose/install/ .

A défaut, installer Docker et Docker commpose depuis des sources alternatives, par exemple les dépôts de la distribution.

Préparer le lab

Récupérer le projet de tests :

git clone https://forge.tedomum.net/acides/hiboo/lab
cd lab

Télécharger les images Docker :

docker-compose pull

Initialiser les serveurs

Initialiser le serveur Matrix :

docker-compose run --rm synapse generate

Initialiser le serveur Mastodon :

docker-compose up -d db redis
docker-compose run --rm mastodon rails db:migrate
docker-compose run --rm mastodon rails assets:precompile

Initialiser le serveur Writefreely :

mkdir writefreely/{db,keys}
chown 2:2 writefreely/{db,keys}
docker-compose run --rm writefreely keys gen
docker-compose run --rm writefreely db init

Démarrer et arrêter les serveurs

Pour démarrer l’ensemble des services :

docker-compose up -d

Ou bien démarrer simplement hiboo et synapse :

docker-compose up -d hiboo synapse

Pour stopper le tout :

docker-compose down

Accéder aux serveurs

Afin d’accéder aux services et de les configurer dans hiboo, il est nécessaire d’employer non pas 127.0.0.1 mais l’adresse hôte de la carte virtuelle Docker, afin que le navigateur utilisateur, hiboo et les applications puissent se joindre à une adresse unique. Pour cela, remplacez dans les URL à suivre <address> par l’adresse de la carte virtuelle Docker.

• Synapse : http://<address>:8008
• Element : http://<address>:8009
• Mastodon : http://<address>:3000
• Writefreely : http://<address>:8080

Afin de démarrer Hiboo localement, employez l’adresse de votre carte virtuelle Docker :

flask run --host <address>