(Facultatif) Essayez avec Docker
Exigences
Matériel
Si vous souhaitez construire l'image Docker vous-même, veuillez vous assurer que votre machine dispose d'au moins 2GB de mémoire. Le frontend de Casdoor est un projet NPM de React. La construction du frontend nécessite au moins 2GB de mémoire. Avoir moins de 2GB de mémoire peut entraîner un échec de la construction du frontend.
Si vous avez seulement besoin d'exécuter l'image pré-construite, veuillez vous assurer que votre machine dispose d'au moins 100MB de mémoire.
OS
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.
Quel que soit le système d'exploitation, les utilisateurs doivent s'assurer qu'ils ont version docker-engine >= 17.05. C'est parce que nous utilisons la fonctionnalité de construction multi-étapes dans le docker-compose.yml, qui est prise en charge dans les versions 17.05 et ultérieures. Pour plus d'informations, consultez https://docs.docker.com/develop/develop-images/multistage-build/.
Si vous utilisez également docker-compose, veuillez vous assurer que vous avez version docker-compose >= 2.2. Pour les utilisateurs de Linux, vous devez également vous assurer que docker-compose est installé, car il est séparé de docker-engine.
Obtenir l'image
Nous avons fourni deux images DockerHub :
| Nom | Description | Suggestion |
|---|---|---|
| casdoor-all-in-one | L'image comprend à la fois Casdoor et une base de données MySQL | Cette image comprend déjà une base de données jouet et est uniquement destinée à des fins de test |
| casdoor | Seul Casdoor est inclus dans l'image | Cette image peut être connectée à votre propre base de données et utilisée en production |
- casbin/casdoor-all-in-one : Cette image comprend le binaire casdoor, une base de données MySQL et toutes les configurations nécessaires. Elle est conçue pour les nouveaux utilisateurs qui souhaitent essayer Casdoor rapidement. Avec cette image, vous pouvez démarrer Casdoor immédiatement avec juste une ou deux commandes, sans aucune configuration complexe. Cependant, veuillez noter que nous ne recommandons pas d'utiliser cette image dans un environnement de production.
Option-1 : Utilisez la base de données jouet
Exécutez le conteneur avec le port 8000 exposé à l'hôte. L'image sera automatiquement téléchargée si elle n'existe pas sur l'hôte local.
docker run -p 8000:8000 casbin/casdoor-all-in-one
Visitez http://localhost:8000 dans votre navigateur. Connectez-vous au tableau de bord Casdoor avec le compte administrateur global par défaut : built-in/admin
admin
123
Option-2 : Essayez directement avec l'image standard
Si ce n'est pas pratique de monter le fichier de configuration dans un conteneur, l'utilisation de variables d'environnement est également une solution possible.
docker run \
-e driverName=mysql \
-e dataSourceName='user:password@tcp(x.x.x.x:3306)/' \
-p 8000:8000 \
casbin/casdoor:latest
Créez conf/app.conf. Vous pouvez le copier depuis conf/app.conf de Casdoor. Pour plus de détails sur app.conf, vous pouvez consulter Via Ini file.
Puis exécutez
docker run -p 8000:8000 -v /folder/of/app.conf:/conf casbin/casdoor:latest
Quoi qu'il en soit, il suffit de monter le app.conf sur /conf/app.conf et de démarrer le conteneur.
Visitez http://localhost:8000 dans votre navigateur. Connectez-vous au tableau de bord Casdoor avec le compte administrateur global par défaut : built-in/admin
admin
123
Option-3 : Essayez avec docker-compose
Créez un répertoire conf/app.conf au même niveau que le fichier docker-compose.yml. Ensuite, copiez app.conf de Casdoor. Pour plus de détails sur app.conf, vous pouvez consulter Via Ini file.
Créez une base de données séparée en utilisant docker-compose :
docker-compose up
C'est tout ! 🛩️
Visitez http://localhost:8000 dans votre navigateur. Connectez-vous au tableau de bord Casdoor avec le compte administrateur global par défaut : built-in/admin
admin
123
Si vous approfondissez le fichier docker-compose.yml, vous pourriez être perplexe face à la variable d'environnement que nous avons créée appelée "RUNNING_IN_DOCKER". 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 Casdoor. Pour vous éviter de rencontrer des problèmes causés par la modification de app.conf, ce qui peut être assez difficile pour un nouvel utilisateur, nous avons fourni cette variable d'environnement et l'avons pré-assignée dans le docker-compose.yml. Lorsque cette variable d'environnement est définie sur true, localhost sera remplacé par host.docker.internal afin que Casdoor puisse accéder à la base de données.