أدوات التطوير الموصى بها
هذه الخدمات الاختيارية غير مطلوبة لتشغيل Overleaf، لكنها تساعد كثيرًا في التطوير وتصحيح الأخطاء وفحص البيانات. كلها جزء من بيئة التطوير، لذا لا يلزم إضافة أي شيء إلىdocker-compose.yml. بعد تسجيل الدخول إلى الموقع، تشير قائمة Dev tools في شريط التنقل إلى الأدوات التي يقدّمها الموقع على مساراته الخاصة.
Grafana
يقدّم الموقع Grafana على/grafana/ عبر webpack-dev-server، لذا لا تحتاج إلى منفذ خاص بها. يحتوي مجلدها Overleaf Develop على لوحات المعلومات التالية:

All services: حالة كل خدمة والمضيف والموارد التي تستخدمها كل خدمة

Data flow: تعديل في طريقه من document-updater عبر project-history إلى history-v1 وMongo
/metrics من الخدمات وmongodb-exporter وredis-exporter وcadvisor وnode-exporter؛ ويرسل Alloy سجلات كل حاوية في المشروع إلى Loki، حيث تقرأها مرشحات Log search وService وLog level في لوحات المعلومات. تعيش بياناتها داخل الحاويات فقط، لذا تُفرَّغ عند إعادة إنشائها. يعمل cAdvisor بامتيازات ويقرأ / و/sys وبيانات Docker ومقبس containerd على المضيف للقراءة فقط؛ ويقرأ node-exporter المسار / على المضيف.
لوحات المعلومات مُولَّدة: عدّل develop/grafana/make-dashboards وشغّله بدلًا من تعديل ملفات JSON.
Mailpit
معMAILPIT_ENABLED=true يرسل web كل بريد إلكتروني إلى Mailpit بدلًا من خادم بريد حقيقي، ويكون تأكيد البريد الإلكتروني مفعّلًا (EMAIL_CONFIRMATION_DISABLED=false). يمكن عندها متابعة روابط التفعيل ودعوات المشاريع وإعادة تعيين كلمات المرور ورموز التأكيد من صندوق الوارد.

بريد تفعيل ودعوة مشروع ورمز تأكيد وإعادة تعيين كلمة المرور في Mailpit
Mongo Express
يعرض Mongo Express مجموعات قاعدة البياناتsharelatex، ويمكنه عرض مستنداتها وتعديلها واستيرادها وتصديرها.

مجموعات قاعدة البيانات sharelatex في Mongo Express
RedisInsight
يحفظ RedisInsight اتصالاته فيdevelop/data/redis-insight. في المرة الأولى، اختر Connect existing database وأدخل المضيف redis والمنفذ 6379.

RedisInsight متصل بخدمة redis
إعداد Hoppscotch
تمرير طلبات API عبر الوكيل
يرسل Hoppscotch الطلبات من المتصفح، الذي لا يستطيع الوصول إلى الخدمات بأسمائها في Docker. يعمل الوكيل الخاص به، Proxyscotch، داخل شبكة Docker ويُقدَّم على/proxy من عنوان Hoppscotch. افتح http://localhost:9170، وانتقل إلى Settings → Interceptor، واختر Proxy، واضبط Proxy URL على http://localhost:9170/proxy. يبقى الإعداد محفوظًا في المتصفح.

إعداد Interceptor. لقطة الشاشة من إعداد أقدم: استخدم http://localhost:9170/proxy كقيمة لـ Proxy URL.

استيراد واجهات API للخدمات
يحتويdevelop/hoppscotch/openapi/ على ملف OpenAPI لواجهة API الداخلية لكل خدمة. في Hoppscotch افتح Collections → Import → Import from File واختر جميع الملفات دفعة واحدة. يصبح كل ملف مجموعة تذهب طلباتها إلى عنوان Docker الخاص بالخدمة. تُعرض الملفات نفسها في قسم واجهة API للخدمات.
مشكلات CSRF


1
إضافة سكربت ما قبل الطلب
أضف الشيفرة التالية إلى Pre-Request
السكربت كما يلي:

2
إضافة ترويسات الطلب
عليك إضافة الترويسات التالية:

3
تسجيل الدخول باستخدام أدوات API
يمكنك الآن تسجيل الدخول باسم المستخدم وكلمة المرور.إليك الاستجابة عند إدخال اسم مستخدم أو كلمة مرور خاطئة.


