(Опціонально) Спробуйте з Docker
Вимоги
Апаратне забезпечення
Якщо ви хочете створити Docker образ самостійно, переконайтеся, що ваша машина має принаймні 2GB пам'яті. Фронтенд Casibase є проектом NPM на базі React. Для збірки фронтенду потрібно принаймні 2GB пам'яті. Якщо пам'яті менше 2GB, збірка фронтенду може зазнати невдачі.
Якщо вам потрібно лише запустити попередньо зібраний образ, переконайтеся, що ваша машина має принаймні 100 МБ пам'яті.
Операційна система
Підтримуються всі операційні системи (Linux, Windows та macOS).
Docker
Ви можете використовувати Docker (версія docker-engine >= 17.05) на Linux або Docker Desktop на Windows та macOS.
Незалежно від операційної системи, користувачі повинні переконатися, що у них встановлена версія docker-engine version >= 17,05. Це тому, що ми використовуємо функцію багатоступінчової збірки у docker-compose.yml, яка підтримується версіями 17,05 та вище. Для отримання додаткової інформації дивіться https://docs.docker.com/develop/develop-images/multistage-build/.
Якщо ви використовуєте docker-compose, переконайтеся, що у вас встановлена версія docker-compose version >= 2,2. Користувачам Linux зверніть увагу, що docker-compose потрібно встановлювати окремо від docker-engine.
Отримання образів
Ми надаємо два образи на DockerHub:
Назва | Опис | Рекомендація |
---|---|---|
casibase-all-in-one | Образ містить Casibase та базу даних MySQL | Цей образ вже містить тестову базу даних і призначений лише для тестування |
casibase | Образ містить лише Casibase | Цей образ може підключатися до вашої власної бази даних і використовуватися у виробничому середовищі |
- casbin/casibase-all-in-one: Цей образ включає виконуваний файл casibase, базу даних MySQL та всі необхідні конфігурації. Він розроблений для нових користувачів, які хочуть швидко опробувати Casibase. За допомогою цього образу ви можете запустити Casibase негайно, виконавши лише одну або дві команди, без будь-якої складної конфігурації. Однак, зверніть увагу, що ми не рекомендуємо використовувати цей образ у виробничому середовищі.
Варіант-1: Використання тестової бази даних
Запустіть контейнер з відкритим портом 14000
для хоста. Якщо образ відсутній на локальному хості, він буде автоматично завантажено.
docker run -p 14000:14000 casbin/casibase-all-in-one
Відвідайте http://localhost:14000 у вашому браузері. Увійдіть у панель управління Casibase, використовуючи обліковий запис глобального адміністратора за замовчуванням: built-in/admin
admin
123
Варіант-2: Спроба з docker-compose
Створіть директорію conf/app.conf
на тому ж рівні, що й файл docker-compose.yml
. Потім скопіюйте app.conf з Casibase. Для докладнішої інформації про app.conf
дивіться Via Ini file.
Використовуйте docker-compose для створення окремої бази даних:
docker-compose up
От і все! 🛩️
Відвідайте http://localhost:14000 у вашому браузері. Увійдіть у панель управління Casibase, використовуючи обліковий запис глобального адміністратора за замовчуванням: built-in/admin
admin
123
Примітка: Якщо ви уважно розглянете файл docker-compose.yml, вас може збентежити змінна оточення, яку ми створили під назвою "RUNNING_IN_DOCKER". Коли база даних 'db' створюється через docker-compose, вона доступна на localhost вашого ПК, але не в контейнері Casibase. Щоб уникнути проблем, пов'язаних зі зміною app.conf, що може бути досить складним для нового користувача, ми надали цю змінну оточення та попередньо призначили її у файлі docker-compose.yml. Коли ця змінна оточення встановлена в true, localhost буде замінено на host.docker.internal, щоб Casibase міг отримати доступ до бази даних.
Варіант-3: Пряме використання стандартного образу
Якщо незручно монтувати файли конфігурації в контейнер, використання змінних середовища також може бути рішенням.
docker run \
-e driverName=mysql \
-e dataSourceName='user:password@tcp(x.x.x.x:3306)/' \
-p 14000:14000 \
casbin/casibase:latest
Створіть conf/app.conf
. Ви можете скопіювати його з conf/app.conf у Casibase. Для докладнішої інформації про app.conf
дивіться Via Ini file.
Потім запустіть
docker run -p 14000:14000 -v /folder/of/app.conf:/conf casbin/casibase:latest
В цілому, вам просто потрібно змонтувати app.conf в /conf/app.conf і запустити контейнер.
Відвідайте http://localhost:14000 у вашому браузері. Увійдіть у панель управління Casibase, використовуючи обліковий запис глобального адміністратора за замовчуванням: built-in/admin
admin
123