(Optionnel) Essayer avec Docker

Exigences

Matériel

Si vous souhaitez construire l'image Docker vous-même, assurez-vous que votre machine dispose d'au moins 2 Go de mémoire. Le frontend de Casibase est un projet NPM basé sur React. La construction du frontend nécessite au moins 2 Go de mémoire. Une mémoire inférieure à 2 Go peut entraîner l'échec de la construction du frontend.

Si vous avez seulement besoin d'exécuter l'image préconstruite, assurez-vous que votre machine dispose d'au moins 100 Mo de mémoire.

Système d'exploitation

Tous les systèmes d'exploitation (Linux, Windows et macOS) sont pris en charge.

Docker

Vous pouvez utiliser Docker (version docker-engine >= 17.05) sous Linux ou Docker Desktop sous Windows et macOS.

• Docker

Quel que soit le système d'exploitation, les utilisateurs doivent s'assurer qu'ils disposent de la version docker-engine >= 17.05. C'est parce que nous utilisons la fonctionnalité de construction multi-étapes dans docker-compose.yml, qui est prise en charge dans la version 17.05 et supérieure. Pour plus d'informations, voir https://docs.docker.com/develop/develop-images/multistage-build/.

Si vous utilisez docker-compose, assurez-vous d'avoir docker-compose version >= 2.2. Pour les utilisateurs Linux, notez que docker-compose doit être installé séparément de docker-engine.

Obtenir les images

Nous fournissons deux images sur DockerHub :

Nom	Description	Recommandation
casibase-all-in-one	L'image contient Casibase et la base de données MySQL	Cette image contient déjà une base de données de test et est uniquement destinée aux tests
casibase	L'image contient uniquement Casibase	Cette image peut se connecter à votre propre base de données et être utilisée en production

1. casbin/casibase-all-in-one: cette image contient l'exécutable casibase, une base de données MySQL et toutes les configurations nécessaires. Elle est conçue pour les nouveaux utilisateurs qui souhaitent essayer rapidement Casibase. Avec cette image, vous pouvez démarrer Casibase immédiatement avec seulement une ou deux commandes sans configuration complexe. Cependant, notez que nous ne recommandons pas d'utiliser cette image en production.

Option-1 : Utiliser la base de données de test

Exécutez le conteneur en exposant le port 14000 à l'hôte. Si l'image n'existe pas sur l'hôte local, elle sera automatiquement téléchargée.

docker run -p 14000:14000 casbin/casibase-all-in-one

Visitez http://localhost:14000 dans votre navigateur. Connectez-vous au tableau de bord Casibase avec le compte administrateur global par défaut : built-in/admin

admin
<b>123</b>

Option-2 : Essayer avec docker-compose

Créez un répertoire conf/app.conf au même niveau de répertoire que le fichier docker-compose.yml. Ensuite, copiez app.conf depuis Casibase. Pour plus de détails sur app.conf, vous pouvez consulter Via le fichier Ini.

Utilisez docker-compose pour créer une base de données séparée :

docker-compose up

C'est tout ! 🛩️

Visitez http://localhost:14000 dans votre navigateur. Connectez-vous au tableau de bord Casibase avec le compte administrateur global par défaut : built-in/admin

admin
<b>123</b>

Remarque : Si vous examinez attentivement le fichier docker-compose.yml, vous pourriez être confus par la variable d'environnement nommée "RUNNING_IN_DOCKER" que nous avons créée. Lorsque la base de données 'db' est créée via docker-compose, elle est disponible sur le localhost de votre PC, mais pas sur le localhost du conteneur Casibase. Pour éviter les problèmes causés par la modification de app.conf (ce qui peut être assez difficile pour les nouveaux utilisateurs), nous avons prévu cette variable d'environnement et l'avons préallouée dans docker-compose.yml. Lorsque cette variable d'environnement est définie sur true, localhost sera remplacé par host.docker.internal afin que Casibase puisse accéder à la base de données.

Option-3 : Utiliser directement l'image standard

conseil

S'il n'est pas pratique de monter des fichiers de configuration dans le conteneur, l'utilisation de variables d'environnement peut également être une solution.

example

docker run \
  -e driverName=mysql \
  -e dataSourceName='user:password@tcp(x.x.x.x:3306)/' \
  -p 14000:14000 \
  casbin/casibase:latest

Créez conf/app.conf. Vous pouvez le copier depuis conf/app.conf de Casibase. Pour plus de détails sur app.conf, vous pouvez consulter Via le fichier Ini.

Ensuite, exécutez

docker run  -p 14000:14000 -v /folder/of/app.conf:/conf casbin/casibase:latest

En résumé, vous devez simplement monter app.conf dans /conf/app.conf et démarrer le conteneur.

Visitez http://localhost:14000 dans votre navigateur. Connectez-vous au tableau de bord Casibase avec le compte administrateur global par défaut : built-in/admin

admin
<b>123</b>