(اختياري) التجربة باستخدام Docker
المتطلبات
الأجهزة
إذا كنت ترغب في بناء صورة Docker الخاصة بك، تأكد من أن جهازك يحتوي على ذاكرة 2 جيجابايت على الأقل. واجهة Casibase الأمامية هي مشروع React NPM. يتطلب بناء الواجهة الأمامية ذاكرة 2 جيجابايت على الأقل. قد تؤدي الذاكرة الأقل من 2 جيجابايت إلى فشل بناء الواجهة الأمامية.
إذا كنت تحتاج فقط إلى تشغيل الصور الجاهزة، تأكد من أن جهازك يحتوي على ذاكرة 100 ميجابايت على الأقل.
نظام التشغيل
جميع أنظمة التشغيل (Linux وWindows وmacOS) مدعومة.
دوكر
يمكنك استخدام إما Docker (إصدار docker-engine >= 17.05) في Linux أو Docker Desktop في Windows وmacOS.
بغض النظر عن نظام التشغيل، يجب على المستخدمين التأكد من وجود إصدار docker-engine >= 17.05. هذا لأننا نستخدم ميزة البناء متعدد المراحل في docker-compose.yml، والتي يتم دعمها في الإصدار 17.05 وما فوق. لمزيد من المعلومات، راجع https://docs.docker.com/develop/develop-images/multistage-build/.
إذا كنت تستخدم docker-compose، تأكد من وجود إصدار docker-compose >= 2.2. بالنسبة لمستخدمي Linux، يرجى ملاحظة أنه يجب تثبيت docker-compose بشكل منفصل عن docker-engine.
الحصول على الصور
نقدم صورتين على DockerHub:
| الاسم | الوصف | التوصية |
|---|---|---|
| casibase- الكل في واحد | تحتوي الصورة على Casibase وقاعدة بيانات MySQL | تحتوي هذه الصورة بالفعل على قاعدة بيانات اختبار وهي مخصصة لأغراض الاختبار فقط |
| كاسيبيس | تحتوي الصورة على Casibase فقط | يمكن ربط هذه الصورة بقاعدة البيانات الخاصة بك واستخدامها للإنتاج |
- casbin/casibase-all-in-one: تحتوي هذه الصورة على ملف Casibase القابل للتنفيذ وقاعدة بيانات MySQL وجميع التكوينات الضرورية. وهي مصممة للمستخدمين الجدد الذين يرغبون في تجربة Casibase بسرعة. باستخدام هذه الصورة، يمكنك بدء Casibase على الفور بأمر واحد أو اثنين فقط، دون أي تكوينات معقدة. ومع ذلك، لاحظ أننا لا نوصي باستخدام هذه الصورة للإنتاج.
الخيار 1: مع قاعدة بيانات الاختبار
قم بتعريض المنفذ 14000 للمضيف عند تشغيل الحاوية. سيتم سحب الصورة تلقائيًا إذا لم تكن موجودة على المضيف المحلي.
دوكر تشغيل -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، يمكنك الاطلاع على عبر ملف Ini.
قم بإنشاء قاعدة بيانات مستقلة باستخدام docker-compose:
دوكر-كومبوز شغّل
هذا كل شيء! :طائرة صغيرة:
قم بزيارة http://localhost:14000 في متصفحك. قم بتسجيل الدخول إلى لوحة تحكم Casibase باستخدام حساب المسؤول العالمي الافتراضي: built-in/admin
admin
123
ملاحظة: إذا تعمقت في ملف docker-compose.yml، قد تكون مرتبكًا بشأن متغير البيئة الذي أنشأناه باسم "RUNNING_IN_DOCKER". عند إنشاء قاعدة البيانات 'db' بواسطة docker-compose، تكون متاحة على localhost الخاص بجهاز الكمبيوتر الخاص بك، ولكن ليس على 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، يمكنك الاطلاع على عبر ملف Ini.
ثم قم بتنفيذ
دوكر تشغيل -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