Перейти до основного контенту

(Опціонально) Спробуйте з 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Цей образ може підключатися до вашої власної бази даних і використовуватися у виробничому середовищі
  1. 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: Пряме використання стандартного образу

порада

Якщо незручно монтувати файли конфігурації в контейнер, використання змінних середовища також може бути рішенням.

example

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