jira ticket classification

تصنيف تذكرة جيرا

ملخص

تصنيف تذاكر Jira هو نظام آلي مصمم لتصنيف تذاكر Jira باستخدام قدرات الذكاء الاصطناعي الخاصة بشركة Amazon Bedrock. يمكن استخدام هذا المشروع مع صادرات Jira Server، مما يوفر إمكانات أتمتة مماثلة لتلك المتوفرة في Jira Cloud.

مخطط الهندسة المعمارية

سمات

• يقوم بتصنيف تذاكر Jira تلقائيًا بناءً على محتواها
• يستخدم Amazon Bedrock للتصنيف المدعوم بالذكاء الاصطناعي
• عمليات تصدير تذكرة Jira الموضوعة في S3
• يستخدم AWS Glue لإلغاء البيانات المكررة
• مصممة للعمل مع صادرات Jira Server

ملاحظة : يعد إلغاء البيانات المكررة أمرًا مهمًا إذا سمحت للمستخدمين بتحميل صادرات Jira يدويًا وكذلك تشغيل السحب التلقائي. إذا تمكنت من التأكد من عدم احتواء الواردات المتزايدة على نسخ مكررة، فيمكنك إزالة مهمة AWS Glue.

كيف يعمل

1. إدخال البيانات : يتم وضع صادرات تذكرة Jira في المجلد /unprocessed لحاوية S3 المنشورة.

2. معالجة البيانات : يقوم النظام بمعالجة التذاكر المصدرة.

3. تصنيف Bedrock : يتم إرسال بيانات التذكرة إلى Amazon Bedrock، الذي يستخدم موجه تصنيف محدد مسبقًا لتصنيف كل تذكرة.

4. إلغاء البيانات المكررة : يضمن AWS Glue عدم معالجة التصنيفات المكررة، مما يحافظ على سلامة البيانات.

5. النتائج : يتم تخزين نتائج التصنيف ويمكن استخدامها لتحديث تذاكر Jira الأصلية أو لمزيد من التحليل.

عناصر

• وظيفة Lambda : تتعامل مع المنطق الرئيسي لمعالجة التذاكر وتصنيفها.
• Amazon Bedrock : يوفر نموذج الذكاء الاصطناعي لتصنيف التذاكر.
• AWS Glue : يدير إلغاء البيانات المكررة.
• S3 : مخازن صادرات جيرا ونتائج التصنيف.
• مدير الأسرار : يخزن مفتاح Jira API وعنوان URL الأساسي وعنوان البريد الإلكتروني لسحب تذاكر Jira.

الإعداد والتكوين

ملاحظة مهمة : ينشر هذا المشروع الموارد في بيئة AWS لديك باستخدام Terraform. سوف تتحمل تكاليف موارد AWS المستخدمة. يرجى العلم بأسعار الخدمات مثل Lambda وBedrock وGlue وS3 في منطقة AWS الخاصة بك.

الأذونات المطلوبة : أنت بحاجة إلى أذونات مرتفعة، وتحديدًا أذونات Power User، لنشر مكدس Terraform.

لإعداد المشروع:

1. قم بتحديث متغير بيئة main.tf fetch_jira_issue_lambda PROJECT_IDS_COMMA_SEPARATED لتضمين معرفات المشروع التي تريد سحبها
2. انتقل إلى مجلد infrastructure في المشروع.
3. قم بتشغيل terraform init لتهيئة دليل عمل Terraform.
4. قم بتشغيل terraform apply لإنشاء الموارد في بيئة AWS الخاصة بك.
5. انتقل إلى مدير الأسرار وقم بتحديث سر Jira بتكوين Jira الخاص بك

لتدمير المشروع:

1. انتقل إلى مجلد infrastructure .
2. قم بتشغيل terraform destroy لإزالة جميع الموارد التي أنشأها هذا المشروع.

حماية

تأكد من تشغيل tfsec على مجلد البنية التحتية في أي وقت تقوم فيه بإجراء تغيير إضافي على الكود.

قم بتشغيل TFSec

$ tfsec .

التحذيرات المكبوتة تأكد من تشغيل tfsec على مجلد البنية التحتية في أي وقت تقوم فيه بإجراء تغيير إضافي على التعليمات البرمجية. لقد تم منع هذه التحذيرات الأمنية، ولكن قم بمراجعتها قبل وضع تطبيق هذا الحل في الإنتاج. بالإضافة إلى ذلك، يستخدم نموذج الريبو هذا مفاتيح AWS المُدارة. يُنصح باستخدام المفاتيح المُدارة بواسطة العميل (CMKs) في بيئة الإنتاج.

1. مدير الأسرار "aws-ssm-secret-use-customer-key": يتطلب هذا التحذير منا استخدام مفتاح KMS لسرنا.
2. S3 "aws-s3-enable-bucket-logging": قم بالإزالة وتشغيله إذا كان تسجيل الجرافة منطقيًا لحالة الاستخدام الخاصة بك
3. S3 Bucket Encyption "aws_s3_bucket_server_side_encryption_configuration": نحن نستخدم مفتاح تشفير مُدار بواسطة AWS
4. Lambda "aws-lambda-enable-tracing": قم بتشغيل التتبع إذا كان ذلك منطقيًا لمشروعك.

الاستخدام

1. تصدير التذاكر من مثيل Jira Server الخاص بك.
2. ضع بيانات التذكرة المصدرة في المجلد /unprocessed لحاوية S3 التي تم إنشاؤها بواسطة البرنامج النصي Terraform.
3. سيقوم النظام تلقائيًا بمعالجة الملفات الجديدة في هذا المجلد.
4. استرداد نتائج التصنيف من موقع الإخراج المعين في S3.

متطلبات

• حساب AWS مع إمكانية الوصول إلى Lambda وBedrock وGlue وS3
• Terraform مثبت على جهازك المحلي
• أذونات المستخدم القوي في حساب AWS الخاص بك
• القدرة على تصدير التذاكر من Jira Server (مثيل Jira Server غير مطلوب)

المساهمة

المساهمات لتحسين المشروع هي موضع ترحيب. لا تتردد في إرسال طلبات السحب أو فتح القضايا لمناقشة التحسينات المحتملة.

رخصة

هذا المشروع مرخص بموجب ترخيص MIT. راجع ملف الترخيص للحصول على التفاصيل.

يدعم

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