itchgrep

itchgrep.com

اكتشف الأصول المثالية لألعابك

؟ ابحث من خلال أصول itch.io باستخدام استفسارات النص ؛ ابحث عن ما تحتاجه دون الاعتماد فقط على العلامات.

قم بزيارة itchgrep.com لبدء الاستكشاف.

؟ انضم إلى مجتمعنا

لدينا؟ خادم Discord! إنه مكان للمشاركة والتعلم والتحدث عن تطوير اللعبة والمشاريع التي نحفزها. لا تتردد في الانضمام إلينا!

؟ دعم itchgrep

دعمكم يغذي شغفنا ويساعد على الحفاظ على الخوادم! إذا كنت تقدر ما نفعله وترغب في المساهمة في رحلتنا ، فكر في:

• ؟ شراء لي قهوة! يحظى بسخاءك تقديرًا كبيرًا ، ويسمح لي كل كوب بالاستمرار في العمل على أشياء رائعة.

؟ Techstack

• يذهب
• تمبل
• برق
• HTMX
• جوجل سحابة
• عامل ميناء

تم اختيار هذه الأدوات والتقنيات بحذر لتوفير تجربة سلسة وفعالة لكل من المطورين ومستخدمي itchgrep.

؟ بنيان

الجري محليا

إذا كنت ترغب في المساهمة ، أو مجرد تشغيل المشروع محليًا للاستخدام الخاص بك ، اتبع الإرشادات أدناه.

تم تصميم هذا المشروع وصيانته على Linux. على الرغم من أنني لا أعتقد أنه من المستحيل عمومًا التشغيل على Windows ، لكن TaskFile مكتوب باستخدام أوامر Linux.

تبعيات الأدوات

• جولانج
• مهمة
• عامل ميناء
• Gcloud

جري

يتم تقسيم المشروع إلى خدمتين:

• dataservice ، المسؤولة عن جلب قائمة الأصول من itch.io
• webserver ، وتقديم البيانات المخزنة مع أدوات البحث.

استخدم TaskFile المضمنة لتشغيل هذه الخدمات.

• ستطلق task local-dataservice dataservice مثيلًا محليًا من GCS. أرسل GET إلى نقطة نهاية المشغل: curl -X GET "localhost:8080/trigger-fetch" . سيؤدي ذلك إلى قيام الخدمة بتركيب البيانات من itch.io ، وفهرسها وتخزين كل من البيانات والفهرس على GCs المحلية.

• دلالة طريقة التشغيل الموصوفة أعلاه لا تعمل حاليًا بشكل صحيح ، فأنا أبحث عن مساعدة في هذا الأمر. يرجى الاطلاع على المشكلة رقم 1. في غضون ذلك ، استخدم task local-dataservice-temp-fix . هذا يدير dataservice بدون Docker.
• ستقوم task local-webserver بإنشاء وتشغيل خادم الويب في حاوية Docker مع GCS المحلية في حاوية منفصلة. لا يتم نسخ قوالب Templ أثناء البناء ، ولكن يتم إنشاؤها داخل الحاوية.
• ستقوم task templ بإنشاء ملفات .go من أي ملفات .templ . هذا غير مطلوب لبناء/تشغيل ، ولكن لتوفير إكمال الكود وإيقاف خادم اللغة من الشكوى.

النشر في السحابة

تم إنشاء المشروع بقصد استضافة كل من dataservice و webserver على Google Cloud Run. تهدف بيانات الأصول إلى تخزينها في متجر Google Cloud.

يمكن استبدال Google Cloud Run بأي منصة بدون خادم ، ويمكن استبدال Google Cloud Store بأي متجر للكائنات ، ولكن سيكون هناك حاجة إلى بعض الأعمال إذا كان هذا هو هدفك ، وستفترض الإرشادات التالية خدمات Google Cloud.

لنشر المشروع على Google Cloud ، اتبع الخطوات أدناه.

إعداد gcloud

بضع خطوات إعداد:

• تأكد من أنك قمت بإعداد مشروع في وحدة التحكم السحابية من Google.
• في مشروعك ، قم بإنشاء متجر كائن مع اسم itchgrep-data . (يمكنك أيضًا استخدام اسم آخر هنا ، ولكن يجب عليك بعد ذلك تغيير const في الملف internal/storage/storage.go .
• في مشروعك ، قم بإنشاء حساب خدمة جديد ، ومنحه دور Cloud Run Invoker . في وقت لاحق ، سنقوم بإرفاق حساب الخدمة هذا بمهمة جدولة ، لتشغيل تشغيل DataService بانتظام.
• تأكد من تثبيت GCloud CLI.
• يمكنك استخدام task gcloud-setup لتكوين gcloud للاستخدام مع هذا المشروع. خلاف ذلك ، تأكد من التكوين يدويًا بشكل صحيح.
• اضبط جميع حالات المتغيرات PROJECT_ID ، REGION LOCATION الموجود في Taskfile لتناسب تكوين مشروع Google Cloud الخاص بك.

نشر خدمة البيانات وإعداد وظيفة جدولة

• قم بتشغيل task deploy-dataservice لبناء ونشر DataService. في النهاية ، ستتلقى عنوان URL للخدمة لخدمة البيانات التي تم نشرها حديثًا.
• الآن ، لإنشاء وظيفة جدولة ، قم بتشغيل الأمر التالي. لاحظ كيف ننقل المعلومات الأمنية الحرجة كمتغيرات بيئة:

  DATASERVICE_URL=https://dataservice-ly6n5ozylq-od.a.run.app 
  SERVICE_ACCOUNT_EMAIL=[e-mail] 
  go-task create-dataservice-scheduler-job

• في هذه المرحلة ، يجب عليك فرض تشغيل يدويًا من JOB-JOB في وحدة تحكم Cloud Scheduler. سيضمن ذلك ملء متجر الكائن بالبيانات ، قبل أن نبدأ خادم الويب لأول مرة. يجب أن تنتظر حوالي 5 دقائق بعد القيام بذلك ، قبل نشر خادم الويب ، وبالتالي فإن DataService لديها وقت لجلب البيانات الجديدة وتخزينها.

نشر خادم الويب

تشغيل task deploy-webserver . لا ينبغي أن تكون هناك حاجة إلى مزيد من العمل.

الاختبار

يمكن إجراء الاختبارات باستخدام TaskFile المضمنة.

• task test : يدير جميع مهام الاختبار أدناه.
• task test-storage : يختبر حزمة storage ، يتطلب تشغيل Docker .

المساهمة

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