klaw

مخلب ·

Klaw مفتوح المصدر بالكامل. ؟

Klaw عبارة عن أداة/بوابة إلكترونية لإدارة/حوكمة المواضيع Apache Kafka® ذاتية الخدمة. إنه تطبيق ويب يعمل على أتمتة عملية إنشاء وتصفح موضوعات Apache Kafka وACLs ومخططات avro والموصلات من خلال تقديم الأدوار/التفويضات لمستخدمي الفرق المختلفة في المؤسسة.

مع العديد من التنزيلات كل أسبوع، يمكن للعديد من الشركات التي لم تتبنى حلاً، أن تبتعد بسعادة عن إدارة تكوينات Apache Kafka في جداول Excel، والتقاء، وصفحات wiki، وgit وما إلى ذلك.

بنيت مع

• واجهة مستخدم Bootstrap، Angular، Javascript، HTML، CSS
• مخضرم - إدارة التبعية
  • يتم تضمين mvnw في Klaw Git Repo، وهو غلاف مخضرم
• Java (Jdk 17, 21)، Spring boot 3، Spring Security، SQL، عميل Apache Kafka Admin
• يصنع

واجهة تفاعل جديدة

ليس مطلوبًا ولكن للحصول على أحدث تجربة نوصي أيضًا ببناء واجهة مستخدم React. أحدث:

• بنم (> = 9.0.0 <10.0.0)
• العقدة (>=20.0.0 <21.0.0)

ما قبل 20 أغسطس 2024

• بنم (> = 8.0.0 <9.0.0)
• العقدة (>=18.0.0 <19.0.0)

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

التنسيق

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

• ام في ان الناصعة: تطبيق

الإصدار

للتعرف على الإصدارات المتاحة، راجع العلامات الموجودة في هذا المستودع.

بنيان:

سمات:

• المواضيع (الموافقة): إنشاء، تحديث، حذف، ترويج

  • تم الآن تمكين React UI افتراضيًا في التكوين. إذا تم إنشاء الأصول المستندة إلى التفاعل بالفعل، فيجب أن تكون واجهة المستخدم الجديدة مرئية.
  • React UI - شكل ومظهر جديد لتصفح المواضيع، وإنشاء طلب موضوع، وطلب ACL، وطلب المخطط، وطلب الموصل
  • React UI - شكل ومظهر جديدان للموافقة على المواضيع وقوائم ACL والمخططات والموصلات
  • React UI - شكل ومظهر جديد لعرض "طلبات فريقي" للمواضيع وقوائم ACL والمخططات والموصلات
  • أصبحت طلبات المواضيع الآن قابلة للتحرير بعد إنشائها، وبالتالي يمكنك تعديلها لتصحيح أي أخطاء.

• Acls (الموافقة): إنشاء، حذف

  • React UI - إنشاء طلب Acl
  • يتم تعيين حسابات الخدمة التي تم إنشاؤها لقوائم ACL إلى فريق الإنشاء

• الموصلات (الموافقة): إنشاء

  • يمكن إنشاء أي موصل طالما أن مكتبات المكونات الإضافية المطلوبة مثبتة على الخادم.
  • يقوم تكوين الموصل الآن بتشفير تكوين كلمة المرور للأمان.

• مخططات أفرو (الموافقة): إنشاء

  • عرض جميع الإصدارات المتاحة من المواضيع لكل موضوع
  • React UI - إنشاء طلب المخطط
  • التحقق المسبق من توافق المخططات عند إنشاء طلب المخطط

• نظرة عامة على الموضوع :

  • توفر React UI الآن نظرة عامة على الموضوع مُعاد تصميمها وجميع إمكاناتها لتحسين تجربة المستخدم.
  • تكوين الموضوع
  • يرقي
  • الاشتراكات الحرفية والبادئة
  • توثيق الموضوع
  • تعويضات المستهلك / التأخر
  • عرض محتويات الموضوع

• عرض جميع طلبات المواضيع التي تم إنشاؤها وإكمالها ورفضها

• عرض جميع طلبات Acl التي تم إنشاؤها وإكمالها ورفضها

• عرض جميع طلبات الرابط التي تم إنشاؤها وإكمالها ورفضها

• عرض جميع طلبات مخطط Avro التي تم إنشاؤها وإكمالها ورفضها

• المزامنة (الترحيل) من وإلى مجموعات Apache Kafka (المواضيع وAcls والمخططات والموصلات)

• المصالحة وإخطارات البريد الإلكتروني بشأن الاختلافات بين Klaw وClusters

• استعادة التكوين (المواضيع، ACLS)

• تسجيل الدخول

  • أزور / تكامل الدليل النشط
  • الدخول الموحد (OAuth2)
  • بناء على قاعدة البيانات

• تكوين المجموعات والبيئات

  • يمكن إنشاء مجموعات متصلة بمجموعات Apache Kafka. (يجب تكوين واجهة برمجة تطبيقات إدارة المجموعة)
  • البيئات عبارة عن أغلفة فوق مجموعات، مما يفرض تكوينات مرنة مثل البادئة واللاحقة وما إلى ذلك
  • يمكن إضافة Kafka Rest Proxy إلى المجموعة لتخزين معلومات عنوان url للوكيل المتبقية.

• المستخدمون والفرق والتفويضات

  • المستخدمين والفرق القابلة للتكوين
  • أكثر من 35 أذونات
  • أدوار قابلة للتكوين (يمكن سحب الأدوار من AD للحصول على التفويض)
  • القدرة على التبديل بين الفرق المختلفة

• اصطلاحات تسمية الموضوع

  • فرض البادئة واللاحقات و/أو التعبير العادي لكل بيئة

• تقرير Excel (لفريقك وجميع الفرق حسب الدور)

  • المواضيع لكل مجموعة (للفرق)
  • أقسام لكل مجموعة
  • المواضيع الشاملة في جميع المجموعات
  • Acls لكل مجموعة (للفرق)
  • منتج Acl (للفرق)
  • قوائم المستهلك (للفرق)
  • مجموعات المستهلكين من جميع البيئات
  • طلبات يوميا

• التحليلات

  • عرض الرسوم البيانية للموضوعات والأقسام وقوائم الوصول والطلبات

• إيجارات متعددة

  • يمكن لكل مستأجر إدارة موضوعاته مع فرقه الخاصة بشكل منفصل.
  • يمكن أن يكون لكل مستأجر مجموعته الخاصة من بيئات كافكا، ولا يمكن لمستخدمي مستأجر واحد عرض/الوصول إلى المواضيع أو قوائم التحكم في الوصول أو أي منها من المستأجرين الآخرين.
  • ويوفر عزلة تجنب أي خرق أمني.

• اتصال أباتشي كافكا

  • PLAINTEXT، SSL، SASL

• مراجعة

  • جميع طلبات المواضيع وقائمة التحكم بالوصول (ACL) والمخطط والموصل

• إشعارات البريد الإلكتروني عندما

  • يتم إنشاء الطلبات والموافقة عليها ورفضها
  • يتم إنشاء المستخدمين والموافقة عليهم

• مساعدة المعالج لإعداد Klaw

انظر ميزات Klaw في المستندات

التوثيق

• وثائق المستخدم: https://klaw-project.io/docs
• الوثائق الفنية للمساهمين:
  • الوثائق العامة: ./docs
  • وثائق محددة لتطبيق React coral : ./coral/docs
• ساهم في تحسين وثائق Klaw هنا

أسئلة وأجوبة

نحن نشجع الجميع على طرح الأسئلة، إذا كان لديك سؤال فمن المؤكد أن شخصًا آخر سيطرحه أيضًا.

• اسأل في منتدى مجتمع Klaw
• اقرأ في منتدى مجتمع Klaw
• اسأل واقرأ في مناقشات Klaw GitHub

سيقوم فريق Klaw بنشر الأسئلة والأجوبة عبر كلا المنتديين. يتمتع منتدى دعم مجتمع Klaw، الذي تستضيفه Aiven وتدعمه مباشرة، برؤية أكبر للأطراف المهتمة الأخرى، لذلك نشجع طرح الأسئلة هناك. سوف نقوم بالرد والإجابة على الأسئلة في كل من مناقشات GitHub ومنتدى المجتمع.

ثَبَّتَ

يدوي

استخدم غلاف Maven

• ./mvnw التثبيت النظيف

استخدم مافن الخاص بك

• تثبيت mvn النظيف

خطوة اختيارية: بالنسبة لأصول React UI الجديدة، تأكد من تثبيت pnpm مسبقًا وهو أمر مطلوب لإنشاء الأصول المرجانية.

يبني قطعتين أثريتين core/target/klaw-.jar وcluster-api/target/cluster-api-.jar

واتبع الخطوات المحددة في https://klaw-project.io/docs أو قم بتشغيل الثنائيات كما هو موضح أدناه

java -jar الأساسية/الهدف/klaw-.jar

جافا -jar الكتلة-api/target/cluster-api-.jar --spring.config.location=cluster-api/target/classes/application.properties

أو قم بتشغيل bin/run-klaw.sh لنظام التشغيل Mac/Linux

مع make

1. استنساخ هذا الريبو الذي يحتوي على وحدتين مخضرمين (الأساسية وواجهة برمجة التطبيقات العنقودية): git clone [email protected]:aiven/klaw.git
2. قم بتشغيل make لتثبيت التبعيات وإعداد كل من Klaw Core وKlaw-Cluster-Api
3. [اختياري] قم بتحرير أي تكوينات باستخدام make edit-core-config لـ Klaw Core أو make edit-cluster-api-config لـ Klaw-Cluster-API
4. للتشغيل، يمكنك استخدام make run-core و make run-cluster-api في نوافذ طرفية مختلفة أو يمكنك تشغيل make -j2 run-core run-cluster-api لتنفيذ كليهما (ملاحظة: سيؤدي ذلك إلى مزج الإخراج وجعل تصحيح الأخطاء أكثر صعوبة )

مع docker

دوكيرهوب

يتوفر كل إصدار رسمي على عامل الإرساء في المستودعين. تحتوي صفحة مركز عامل الإرساء klaw-core على مثال لملف إنشاء عامل إرساء والذي سيساعد في تنزيل Klaw ونشره. يمكن أيضًا العثور على واجهة برمجة تطبيقات المجموعة بشكل منفصل على مركز الإرساء.

محليا

يتمتع هذا المشروع أيضًا بالقدرة على إنشاء ونشر صور عامل الإرساء المحلي باستخدام البرامج النصية المتوفرة في Klaw/docker-scripts.

رخصة

تم ترخيص Klaw بموجب ترخيص Apache، الإصدار 2.0. يتوفر نص الترخيص الكامل في ملف LICENSE.md.

يرجى ملاحظة أن المشروع لا يتطلب صراحةً اتفاقية ترخيص المساهم (CLA) من المساهمين فيه.

اتصال

نرحب بشدة بتقارير الأخطاء والتصحيحات، يرجى نشرها كمشكلات GitHub وسحب الطلبات على https://github.com/aiven/klaw. يجب الإبلاغ عن أي نقاط ضعف محتملة أو مشكلات خطيرة أخرى مباشرة إلى المشرفين [email protected].

علامة تجارية

Apache Kafka هي إما علامة تجارية مسجلة أو علامة تجارية لمؤسسة Apache Software Foundation في الولايات المتحدة و/أو البلدان الأخرى. جميع أسماء المنتجات والخدمات المستخدمة في هذه الصفحة هي لأغراض التعريف فقط ولا تعني المصادقة عليها.

الاعتمادات

تتم صيانة Klaw (Kafkawize سابقًا) بواسطة مطوري Aiven مفتوحي المصدر.

تم إدراج المساهمين الجدد في صفحة مشروع GitHub، https://github.com/aiven/klaw/graphs/contributors

حقوق الطبع والنشر (ج) لعام 2024 مملوكة للمساهمين في مشروع Aiven Oy وklaw.