عند ادخال الامر الاخير من النص التالي صفحة مستودع GitHub لمشروع frappedocker بالطبع،…
- User
عند ادخال الامر الاخير من النص التالي صفحة مستودع GitHub لمشروع frappe_docker
بالطبع، سأقوم بشرح النص المقدم بالتفصيل باللغة العربية. النص يبدو وكأنه محتوى صفحة مستودع GitHub لمشروع frappe_docker، والذي يُستخدم لتشغيل Frappe وERPNext داخل حاويات Docker. سنستعرض هيكلية المستودع، الملفات والمجلدات الرئيسية، بالإضافة إلى خطوات البدء والتكوين.
مقدمة عن frappe_docker مستودع frappe_docker يهدف إلى تقديم حزم Docker مخصصة لتشغيل Frappe وERPNext بطريقة سهلة وفعّالة. Frappe هو الإطار الذي يبني عليه ERPNext، وهو نظام تخطيط موارد المؤسسات (ERP) مفتوح المصدر يُستخدم لإدارة مختلف جوانب الأعمال مثل المحاسبة والمبيعات والمخزون والموارد البشرية وغيرها.
هيكلية المستودع والملفات الرئيسية المجلدات والملفات .github يحتوي عادةً على ملفات إعدادات GitHub Actions، وهي خدمات التكامل المستمر التي تُستخدم لأتمتة العمليات مثل الاختبار والنشر. .vscode يتضمن إعدادات مخصصة لمحرر النصوص Visual Studio Code، مثل إعدادات الفحص البرمجي والتنسيق التلقائي. devcontainer-example يحتوي على إعدادات Dev Containers، والتي تسمح بتطوير التطبيقات داخل بيئات معزولة باستخدام Docker. development يتضمن إعدادات وملفات مخصصة لبيئة التطوير. docs يحتوي على الوثائق المتعلقة بالمشروع، مثل دليل الاستخدام، الأسئلة المتكررة، وأي توثيقات أخرى ضرورية. images يحتوي على الصور أو الموارد المرئية المستخدمة في المشروع، مثل قوالب Nginx أو إعدادات أخرى ذات صلة. overrides يحتوي على ملفات تجاوز الإعدادات الافتراضية، مثل زيادة مهلة التحقق من صحة قواعد البيانات MariaDB. resources يتضمن موارد إضافية مثل قوالب Nginx المتزامنة مع تغييرات bench. tests يحتوي على اختبارات وتكوينات للتأكد من جودة وأداء الكود. .dockerignore ملف يستخدم لتحديد الملفات والمجلدات التي يجب تجاهلها عند بناء صور Docker، مما يساعد في تقليل حجم الصورة وزيادة كفاءة البناء. .editorconfig ملف إعدادات لتوحيد تنسيق الكود بين مختلف المحررات وفرق التطوير. .gitignore ملف يستخدم لتحديد الملفات والمجلدات التي يجب تجاهلها من خلال Git، مثل الملفات المؤقتة أو ملفات الإعدادات الحساسة. .pre-commit-config.yaml ملف إعدادات لأدوات الفحص البرمجي التي تُشغل قبل إجراء commit، لضمان جودة الكود. .shellcheckrc ملف إعدادات لأداة ShellCheck، التي تُستخدم لتحليل وصيانة سكربتات Shell. CODE_OF_CONDUCT.md ملف يحتوي على قواعد السلوك التي يتعين على المساهمين اتباعها عند المشاركة في المشروع. CONTRIBUTING.md ملف يحتوي على إرشادات للمساهمة في المشروع، مثل كيفية إعداد البيئة المحلية، قواعد كتابة الأكواد، وإنشاء pull requests. LICENSE ملف يحتوي على معلومات الترخيص الخاصة بالمشروع، مثل MIT License. README.md الملف الرئيسي الذي يظهر في واجهة المستودع على GitHub. يحتوي على مقدمة عن المشروع، خطوات البدء، وثائق، وأي معلومات أخرى ضرورية للمستخدمين والمساهمين. compose.yaml ملف إعدادات Docker Compose الذي يُستخدم لتعريف وتشغيل خدمات متعددة معًا. يُستخدم لتشغيل الحاويات المخصصة لتشغيل Frappe وERPNext. docker-bake.hcl ملف إعدادات يستخدم مع أمر docker bake لأتمتة بناء صور Docker بناءً على تعريفات معينة. example.env ملف يحتوي على متغيرات بيئية (Environment Variables) يمكن تخصيصها حسب الحاجة. يُستخدم لتحديد إعدادات مثل كلمات المرور، أسماء المضيفين، والإعدادات الأخرى الضرورية لتشغيل الحاويات. install_x11_deps.sh سكربت Shell مثبت يحتوي على تعليمات لتثبيت تبعيات معينة تُستخدم أثناء تنفيذ اختبارات واجهة المستخدم باستخدام Cypress أو تحديثات أخرى لملف installer.py. pwd.yml ملف إعدادات Docker Compose مخصص لـ Play With Docker (PWD)، وهي بيئة تشغيل حاويات Docker عبر الإنترنت. requirements-test.txt ملف يحتوي على تبعيات Python اللازمة لتشغيل اختبارات الوحدة (Unit Tests). setup.cfg ملف إعدادات لتكوين أدوات مثل pytest، التي تُستخدم لتنفيذ اختبارات الوحدة. إعداد وتشغيل frappe_docker الخطوات الأساسية للبدء
- المتطلبات المسبقة قبل البدء، تأكد من أن لديك الأدوات التالية مُثبتة على جهازك:
Docker: يمكنك تنزيله من موقع Docker الرسمي. Docker Compose: عادةً ما يتم تضمينه مع تثبيت Docker Desktop. Git: لتنزيل المستودع من GitHub. يمكنك تنزيله من موقع Git الرسمي. 2. اختيار طريقة البدء هناك خياران رئيسيان للبدء باستخدام frappe_docker:
أ. تجربة في Play With Docker (PWD) Play With Docker (PWD) هي بيئة تشغيل حاويات Docker عبر الإنترنت تسمح لك بتجربة Docker بدون الحاجة لتثبيته محليًا. لبدء التجربة:
انتقل إلى مستودع frappe_docker على GitHub. ابحث عن زر يُسمى "Try in PWD" أو مشابه. انقر على الزر وسيتم إعداد بيئة تجريبية تلقائيًا. اتبع التعليمات لبدء تشغيل الحاويات. ب. تجربة في بيئة التطوير المحلية إذا كنت ترغب في تشغيل Frappe وERPNext على جهازك المحلي، اتبع الخطوات التالية:
استنساخ المستودع (Clone the Repository) افتح موجه الأوامر أو PowerShell ونفذ الأوامر التالية:
git clone https://github.com/frappe/frappe_docker cd frappe_docker تشغيل الحاويات باستخدام Docker Compose نفذ الأمر التالي لتشغيل جميع الحاويات المعرفَة في ملف pwd.yml:
docker compose -f pwd.yml up -d يظهر الخطأ C:\Users\pc\erpnext-docker\frappe_docker>docker compose -f pwd.yml up -d time="2024-10-21T22:03:55+01:00" level=warning msg="C:\Users\pc\erpnext-docker\frappe_docker\pwd.yml: the attribute
versionis obsolete, it will be ignored, please remove it to avoid potential confusion" error during connect: Get "http://%2F%2F.%2Fpipe%2FdockerDesktopLinuxEngine/v1.46/containers/json?all=1&filters=%7B%22label%22%3A%7B%22com.docker.compose.config-hash%22%3Atrue%2C%22com.docker.compose.project%3Dfrappe_docker%22%3Atrue%7D%7D": open //./pipe/dockerDesktopLinuxEngine: The system cannot find the file specified.C:\Users\pc\erpnext-docker\frappe_docker>
- Assistant
مرحبًا! يبدو أنك تواجه مشكلة عند محاولة تشغيل حاويات Docker باستخدام ملف
pwd.ymlفي مشروعfrappe_docker. سأساعدك في حل هذه المشكلة خطوة بخطوة.فهم الخطأ
الرسالة التي ظهرت لديك هي:
error during connect: Get "http://%2F%2F.%2Fpipe%2FdockerDesktopLinuxEngine/v1.46/containers/json?all=1&filters=%7B%22label%22%3A%7B%22com.docker.compose.config-hash%22%3Atrue%2C%22com.docker.compose.project%3Dfrappe_docker%22%3Atrue%7D%7D": open //./pipe/dockerDesktopLinuxEngine: The system cannot find the file specified.تشير هذه الرسالة إلى أن عميل Docker لم يتمكن من الاتصال بخادم Docker (Docker daemon). هذا قد يكون بسبب عدم تشغيل Docker Desktop على جهازك، أو وجود مشكلة في إعدادات الاتصال.
خطوات حل المشكلة
1. التأكد من تثبيت وتشغيل Docker Desktop
-
تثبيت Docker Desktop:
- إذا لم تكن قد ثبتت Docker Desktop على جهازك، يمكنك تنزيله من موقع Docker الرسمي وتثبيته.
-
تشغيل Docker Desktop:
- بعد التثبيت، تأكد من تشغيل Docker Desktop. يمكنك العثور على أيقونته في شريط المهام (عادةً في أسفل الشاشة على نظام Windows).
- انتظر لبضع دقائق حتى يكتمل بدء تشغيل Docker ويتم تهيئة البيئة.
2. التحقق من حالة Docker
-
افتح موجه الأوامر (Command Prompt) أو PowerShell واكتب الأمر التالي للتحقق مما إذا كان Docker يعمل بشكل صحيح:
docker version- إذا تلقيت معلومات حول إصدار Docker، فهذا يعني أن Docker يعمل.
- إذا ظهرت رسائل خطأ، قد تحتاج إلى إعادة تشغيل Docker Desktop أو إعادة تثبيته.
3. التأكد من إعدادات Docker لاستخدام حاويات Linux
-
بناءً على رسالة الخطأ، يبدو أن Docker يحاول الوصول إلى محرك Linux. تأكد من أن Docker Desktop مضبوط لاستخدام حاويات Linux وليس Windows.
- افتح Docker Desktop.
- اذهب إلى Settings > General.
- تأكد من تحديد الخيار "Use the WSL 2 based engine" إذا كنت على Windows.
4. تحديث ملف
pwd.yml-
من التحذير في الرسالة، يبدو أن هناك سطرًا في ملف
pwd.ymlيحتوي علىversionوهو سمة قديمة وغير ضرورية في إصدارات Docker Compose الحديثة. -
افتح ملف
pwd.ymlفي محرر نصوص وقم بإزالة سطرversionإن وجد. مثال:# قبل version: '3' services: ... # بعد services: ...
5. إعادة تشغيل الأمر
-
بعد التأكد من تشغيل Docker وتحديث ملف
pwd.yml، حاول إعادة تشغيل الأمر:docker compose -f pwd.yml up -d
6. التحقق من متغيرات البيئة (Environment Variables)
- تأكد من أن متغيرات البيئة المتعلقة بـ Docker مضبوطة بشكل صحيح. في بعض الأحيان، قد يحتاج Docker إلى متغيرات بيئة محددة للاتصال الصحيح.
7. إعادة تثبيت Docker إذا لزم الأمر
- إذا استمرت المشكلة بعد تنفيذ الخطوات السابقة، قد تكون هناك مشكلة في تثبيت Docker نفسه. في هذه الحالة:
- قم بإلغاء تثبيت Docker Desktop بالكامل.
- أعد تشغيل جهاز الكمبيوتر.
- قم بتثبيت Docker Desktop مرة أخرى من الموقع الرسمي.
نصائح إضافية
-
التأكد من تحديث Docker:
- تأكد من أنك تستخدم أحدث إصدار من Docker Desktop، حيث يمكن أن تحل التحديثات مشاكل توافق.
-
التحقق من صلاحيات المستخدم:
- تأكد من أنك تشغل موجه الأوامر أو PowerShell كمسؤول (Run as Administrator) إذا كنت تواجه مشاكل في الأذونات.
-
الاطلاع على سجلات Docker:
- إذا استمرت المشكلة، يمكنك الاطلاع على سجلات Docker للحصول على مزيد من التفاصيل حول الخطأ. افتح Docker Desktop واذهب إلى Settings > Troubleshoot > Get support > Get Diagnostics.
آمل أن تساعدك هذه الخطوات في حل المشكلة! إذا واجهت أي صعوبة إضافية أو هناك تفاصيل أخرى تحتاج للمساعدة فيها، لا تتردد في طرحها.
-