إنتقل إلى المحتوى الرئيسي
صفحة مترجمة

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.

أداة مراقبة نشاط المشاريع مفتوحة المصدر تعمل بواسطة StackQL

في هذا الدليل، سنوضح كيفية الاستضافة الذاتية لنظام مراقبة وتنبيه في الوقت الفعلي للقائمين على صيانة البرمجيات مفتوحة المصدر على GitHub.

stackql أداة مفتوحة المصدر تتيح للمستخدمين الاستعلام عن الموارد السحابية وموارد SaaS والتفاعل معها باستخدام لغة SQL ومكتبات وأدوات تصور البيانات وتحليلها. امنحنا ⭐ إذا أعجبك هذا المشروع!

احصل على تنبيهات مثل هذه في Slack وDiscord في الوقت الفعلي:

أداة مراقبة المشاريع مفتوحة المصدر

تم الاختبار باستخدام واجهة SQL الخلفية المضمنة docker linux

نظرة عامة​

عندما بحثت عن أدوات لمراقبة مشروعنا مفتوح المصدر، وجدت أن معظمها لا يعمل كما هو معلن عنه أو لا يعمل على الإطلاق (في حالة تطبيقات الجهات الخارجية في GitHub)، لذلك أنشأت أداتنا الخاصة التي يمكنك تشغيلها واستخدامها في مشروع GitHub مفتوح المصدر الخاص بك...

يستخدم المشروع oss-activity-monitor الأداة stackql لمراقبة نشاط المشاريع مفتوحة المصدر في الوقت الفعلي، ويشمل ذلك الإعلام في الوقت الفعلي بما يلي:

  • ⭐ stargazers جدد في مستودع GitHub
  • 👀 watchers جدد في مستودع GitHub
  • 🍴 نسخ متفرعة جديدة من مستودع GitHub
  • 📊 مشكلات (issues) جديدة في مستودع GitHub
  • 🙋 متابعون جدد لمؤسسة GitHub
  • 📦 تنزيلات جديدة لملفات إصدارات GitHub
  • 🍺 تنزيلات homebrew جديدة

آلية العمل​

يتم نشر المشروع في حاوية (باستخدام docker أو منصة أخرى لنشر الحاويات)، وهو مبني باستخدام python والحزمة pystackql، ويستخدم الموفرين github وhomebrew لـ stackql. يستخدم المشروع طرق العرض المجسدة وجمل SELECT لالتقاط الحالة ومقارنتها بين المقاييس الحالية والسابقة لنقاط النهاية الخاضعة للمراقبة في GitHub وHomebrew، وهذا موضح في الرسم التخطيطي هنا:

على سبيل المثال، بافتراض وجود طريقة العرض المجسدة هذه التي تم إنشاؤها وملؤها باستخدام stackql:

CREATE OR REPLACE MATERIALIZED VIEW mvw_github_repo_stargazers AS
SELECT login FROM github.activity.repo_stargazers
WHERE owner = 'your-org' and repo = 'your-repo'

يستطلع استعلام stackql التالي GitHub دوريًا للعثور على stargazers جدد...

SELECT c.login
FROM github.activity.repo_stargazers c
LEFT JOIN mvw_github_repo_stargazers mvw
ON c.login = mvw.login
WHERE mvw.login IS NULL
AND c.owner = 'your-org' AND c.repo = 'your-repo'

ثم يتم تحديث الحالة باستخدام...

REFRESH MATERIALIZED VIEW mvw_github_repo_stargazers

تتكرر أنماط مماثلة لكل من watchers في المستودع والمشكلات ومتابعي المؤسسة وتنزيلات ملفات الإصدار وتنزيلات homebrew.

تشغيل المشروع​

اتبع الخطوات أدناه لتشغيل المشروع محليًا أو على منصتك السحابية المفضلة.

1. استنساخ المستودع​

git clone https://github.com/stackql/oss-activity-monitor.git
# or
git clone git@github.com:stackql/oss-activity-monitor.git

2. تكوين متغيرات البيئة​

متغيرات البيئة التالية مطلوبة لتكوين المشروع (يتم توفيرها كمتغيرات بيئة، باستخدام ملف .env في المثال أدناه):

المتغيرالوصفقيمة المثال
LOG_LEVELمستوى السجل (INFO للسجلات العامة؛ DEBUG للتسجيل المفصل)INFO
SLEEP_INTERVALمدة التأخير بالثواني بين حلقات الطلبات5
GITHUB_REPOاسم مستودع GitHubstackql
GITHUB_REPO_OWNERاسم مؤسسة GitHub أو اسم المالكstackql
HOMEBREW_FORMULA_NAMEاسم formula في Homebrew، إن وجدstackql
STACKQL_GITHUB_USERNAMEاسم المستخدم الخاص بك في GitHubjeffreyaven
STACKQL_GITHUB_PASSWORDالرمز المميز للوصول الشخصي الخاص بك في GitHubghp_yourpersonalaccesstoken
SLACK_WEBHOOK_URLعنوان URL لخطاف الويب في Slack لإرسال الإعلاماتhttps://hooks.slack.com/services/...
DISCORD_WEBHOOK_URLعنوان URL لخطاف الويب في Discord لإرسال الإعلاماتhttps://discord.com/api/webhooks/...

3. بناء الحاوية​

docker build --no-cache -t oss-activity-monitor .

4. تشغيل الحاوية​

docker run --env-file .env oss-activity-monitor

هذا كل شيء! ستتلقى الآن تنبيهات في الوقت الفعلي عند حدوث نشاط في مشروعك مفتوح المصدر. لإيقاف الحاوية، استخدم:

docker stop $(docker ps -a -q --filter ancestor=oss-activity-monitor)

امنحنا ⭐ على GitHub