yas

ياس: متجر آخر

YAS هو مشروع صغير الحجم يهدف إلى ممارسة بناء تطبيق نموذجي للخدمات الصغيرة في Java

التقنيات والأطر المؤقتة

• جافا 21
• التمهيد الربيع 3.2
• حاويات الاختبار
• Next.js
• عباءة المفاتيح
• كافكا
• بحث مرن
• K8s
• إجراءات جيثب
• سونار كلاود
• فتح القياس عن بعد
• جرافانا، لوكي، بروميثيوس، تيمبو

بنية التنمية المحلية

الشروع في العمل مع Docker Compose

1. احصل على أحدث كود المصدر
2. أضف السجلات التالية إلى ملف المضيف الخاص بك:

 127.0.0.1 identity
127.0.0.1 api.yas.local
127.0.0.1 pgadmin.yas.local
127.0.0.1 storefront
127.0.0.1 backoffice
127.0.0.1 loki
127.0.0.1 tempo
127.0.0.1 grafana
127.0.0.1 elasticsearch
127.0.0.1 kafka

3. افتح المحطة الطرفية التي تختارها، وانتقل إلى دليل yas ، وقم بتشغيل docker compose up ، وانتظر حتى يتم تشغيل كافة الحاويات

تحذير: لتشغيل جميع الحاويات، تحتاج إلى ما لا يقل عن 16 جيجابايت من ذاكرة الوصول العشوائي. بخلاف ذلك، يمكنك فقط تشغيل الخدمات الأساسية باستخدام أمر docker compose -f docker-compose.yml up

4. يتم تشغيل جميع الحاويات ثم نبدأ موصلات المصدر عن طريق تشغيل البرنامج النصي، ونفتح أي نافذة طرفية... انتقل إلى المجلد الجذر YAS واكتب: ./start-source-connectors.sh
5. افتح متصفحك، الآن يمكنك الوصول إلى المواقع عبر http://storefront/ ; http://backoffice/ تسجيل الدخول باستخدام المسؤول / كلمة المرور

ملاحظة: في التشغيل الأول، قد لا تعمل واجهة المتجر والمكتب الخلفي كما هو متوقع. أوقف جميع الحاويات (Ctrl + C) وقم بتشغيل عامل الإرساء مرة أخرى.

قد ترغب أيضًا في استكشاف:

1. http://pgadmin.yas.local/ . تسجيل الدخول إلى الحساب: [email protected] / admin. تسجيل الخادم: postgres، المنفذ 5432، اسم المستخدم admin، كلمة المرور admin. يتعرض خادم Postgresql أيضًا للجهاز المضيف: اسم الخادم: localhost، المنفذ: 5432، اسم المستخدم: admin، كلمة المرور: admin
2. http://api.yas.local/swagger-ui/ للاطلاع على جميع مستندات REST API لجميع الخدمات
3. http://identity/ لوحدة تحكم Keycloak، مسؤول/مشرف الحساب
4. http://grafana/ لإمكانية الملاحظة: السجل، التتبع، المصفوفة
5. http://elasticsearch/ لاستدعاء واجهات برمجة تطبيقات Elasticsearch

حول ملفات إنشاء عامل الإرساء

1. docker-compose.yml لجميع الخدمات الأساسية
2. docker-compose.search.yml لخدمة البحث
3. docker-compose.o11y.yml لخدمات إمكانية المراقبة

نشر إلى Kubernetes

https://github.com/nashtech-garage/yas/tree/main/k8s/deploy

التوثيق

• العمارة والمكونات
• إرشادات المطور

المساهمة

• أعطنا نجمة
• الإبلاغ عن خطأ
• المشاركة في المناقشات
• اقتراح ميزات جديدة
• إرسال طلبات السحب. إذا كنت جديدًا على GitHub، ففكر في معرفة كيفية المساهمة في المشروع من خلال التفرع

من خلال المساهمة، فإنك توافق على أن مساهماتك سيتم ترخيصها بموجب ترخيص MIT.

لقطات الشاشة

المكتب الخلفي وواجهة المتجر	إمكانية الملاحظة