(اختياري) جرب مع Docker
المتطلبات
العتاد
إذا كنت ترغب في بناء صورة Docker بنفسك، يرجى التأكد من أن جهازك يحتوي على 2GB على الأقل من الذاكرة. واجهة Casdoor الأمامية هي مشروع NPM لـ React. بناء الواجهة الأمامية يتطلب على الأقل 2GB من الذاكرة. وجود أقل من 2GB من الذاكرة قد يؤدي إلى فشل بناء الواجهة الأمامية.
إذا كنت تحتاج فقط إلى تشغيل الصورة المبنية مسبقًا، يرجى التأكد من أن جهازك يحتوي على 100MB على الأقل من الذاكرة.
نظام التشغيل
جميع أنظمة التشغيل (لينكس، ويندوز، وماك أو إس) مدعومة.
Docker
يمكنك استخدام Docker (إصدار docker-engine >= 17.05) في لينكس أو Docker Desktop في ويندوز وماك أو إس.
بغض النظر عن نظام التشغيل، يجب على المستخدمين التأكد من أن لديهم إصدار docker-engine >= 17.05. وذلك لأننا نستخدم ميزة البناء المتعدد المراحل في ملف docker-compose.yml، والتي يتم دعمها في الإصدارات 17.05 وما فوق. لمزيد من المعلومات، انظر https://docs.docker.com/develop/develop-images/multistage-build/.
إذا كنت تستخدم أيضًا docker-compose، يرجى التأكد من أن لديك إصدار docker-compose >= 2.2. بالنسبة لمستخدمي لينكس، تحتاج أيضًا إلى التأكد من تثبيت docker-compose، حيث أنه منفصل عن docker-engine.
احصل على الصورة
لقد قدمنا صورتين على DockerHub:
| الاسم | الوصف | الاقتراح |
|---|---|---|
| casdoor-all-in-one | تشمل الصورة كلاً من Casdoor وقاعدة بيانات MySQL | هذه الصورة تشمل بالفعل قاعدة بيانات تجريبية وهي لأغراض الاختبار فقط |
| casdoor | تشمل الصورة Casdoor فقط | يمكن ربط هذه الصورة بقاعدة بياناتك الخاصة واستخدامها في الإنتاج |
- casbin/casdoor-all-in-one: تشمل هذه الصورة الثنائي casdoor، وقاعدة بيانات MySQL، وجميع التكوينات اللازمة. هي مصممة للمستخدمين الجدد الذين يرغبون في تجربة Casdoor بسرعة. مع هذه الصورة، يمكنك بدء Casdoor فورًا بأمر أو اثنين فقط، دون أي تكوين معقد. ومع ذلك، يرجى ملاحظة أننا لا نوصي باستخدام هذه الصورة في بيئة الإنتاج.
الخيار-1: استخدم قاعدة البيانات التجريبية
شغل الحاوية مع فتح المنفذ 8000 إلى المضيف. سيتم سحب الصورة تلقائيًا إذا لم تكن موجودة على المضيف المحلي.
docker run -p 8000:8000 casbin/casdoor-all-in-one
قم بزيارة http://localhost:8000 في متصفحك. قم بتسجيل الدخول إلى لوحة تحكم Casdoor باستخدام حساب المسؤول العالمي الافتراضي: built-in/admin
admin
123
الخيار-2: جرب مباشرةً مع الصورة القياسية
إذا لم يكن من الملائم تركيب ملف التكوين على حاوية، فإن استخدام المتغيرات البيئية هو أيضًا حل ممكن.
docker run \
-e driverName=mysql \
-e dataSourceName='user:password@tcp(x.x.x.x:3306)/' \
-p 8000:8000 \
casbin/casdoor:latest
أنشئ conf/app.conf. يمكنك نسخه من conf/app.conf في Casdoor. لمزيد من التفاصيل حول app.conf، يمكنك الاطلاع على عبر ملف Ini.
ثم قم بتشغيل
docker run -p 8000:8000 -v /folder/of/app.conf:/conf casbin/casdoor:latest
على أي حال، فقط قم بتحميل ملف app.conf إلى /conf/app.conf وابدأ الحاوية.
قم بزيارة http://localhost:8000 في متصفحك. قم بتسجيل الدخول إلى لوحة تحكم Casdoor باستخدام حساب المسؤول العالمي الافتراضي: built-in/admin
admin
123
الخيار-3: جرب باستخدام docker-compose
أنشئ دليل conf/app.conf في نفس مستوى الدليل كملف docker-compose.yml. ثم، انسخ app.conf من Casdoor. لمزيد من التفاصيل حول app.conf، يمكنك الاطلاع على عبر ملف Ini.
أنشئ قاعدة بيانات منفصلة باستخدام docker-compose:
docker-compose up
هذا كل شيء! 🛩️
قم بزيارة http://localhost:8000 في متصفحك. قم بتسجيل الدخول إلى لوحة تحكم Casdoor بواسطة حساب المدير العالمي الافتراضي: built-in/admin
admin
123
إذا نظرت بعمق أكثر في ملف docker-compose.yml، قد تشعر بالحيرة بسبب متغير البيئة الذي أنشأناه والذي يسمى "RUNNING_IN_DOCKER". عندما يتم إنشاء قاعدة البيانات 'db' عبر docker-compose، فهي متاحة على localhost لجهاز الكمبيوتر الخاص بك ولكن ليس على localhost لحاوية Casdoor. لمنعك من الوقوع في مشاكل ناتجة عن تعديل app.conf، والتي يمكن أن تكون صعبة للغاية بالنسبة لمستخدم جديد، قدمنا هذا المتغير البيئي وقمنا بتعيينه مسبقًا في ملف docker-compose.yml. عندما يتم تعيين هذا المتغير البيئي على true، سيتم استبدال localhost بـ host.docker.internal حتى يتمكن Casdoor من الوصول إلى قاعدة البيانات.