java fm playground

☕ ملعب Java FM

مرحبًا بكم في ملعب Java Foundation Model (FM) ، صندوق رمل لاستكشاف تكامل Java مع Amazon Bedrock .

هام: هذا التطبيق هو لأغراض تعليمية وليس مخصص للاستخدام الإنتاج.

ملخص

يتضمن هذا المستودع تطبيق Boot Spring و Next.js الأمامي ، كلاهما قابل للتنفيذ محليًا. فيما يلي لقطة شاشة للتطبيق أثناء العمل.

مهم

• قد يؤدي تشغيل هذا التطبيق إلى رسوم إلى حساب AWS الخاص بك. لمزيد من التفاصيل ، راجع تسعير الأساس الأمازون.
• تم تكوين هذا التطبيق ليتم تشغيله في us-east-1 ولم يتم اختباره في كل منطقة AWS. لمزيد من المعلومات ، راجع خدمات AWS الإقليمية.
• نوصي بمنح رمزك الأقل امتيازًا ، أي فقط الحد الأدنى للأذونات المطلوبة من قبل التطبيق. يمكنك العثور على وثيقة سياسة IAM مع الأذونات المطلوبة في هذا المستودع في resources/bedrock-access-policy.json (سياسة العرض).

المتطلبات الأساسية

تأكد من تثبيت ما يلي:

• Java JDK 17+ (مثل Amazon Corretto ، توزيعة مجانية لـ JDK)
• Apache Maven لخادم الخلفية
• node.js (v18.17+) لتطبيق الواجهة الأمامية
• يجب أن يكون لديك حساب AWS ، وأن يتم تكوين بيانات الاعتماد الافتراضية الخاصة بك ومنطقة AWS كما هو موضح في AWS Tools و SDKs دليل التشكيل المشترك وبيانات الاعتماد.
• يجب أن تطلب الوصول إلى النماذج قبل أن تتمكن من استخدامها. لمزيد من المعلومات ، راجع وصول النموذج. لتشغيل التطبيق ، تحتاج إلى الوصول إلى النماذج التالية في us-east-1 :
  • كلود البشري
  • AI21 Labs Jurassic-2 Mid
  • الاستقرار منظمة العفو الدولية الانتشار المستقر XL

تشغيل التطبيق

بعد التحقق من المتطلبات الأساسية ، اتبع هذه الخطوات:

استنساخ المستودع

افتح محطة ، انتقل إلى دليل من اختيارك ، وتنفيذ الأمر التالي:

git clone https://github.com/build-on-aws/java-fm-playground.git

إعداد الخلفية

في دليل java-fm-playground/backend ، Run:

mvn spring-boot:run

بمجرد تشغيل الخادم ، سترى الإخراج التالي:

...
2023-11-13T14:19:02.862+01:00  INFO 34848 --- [main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 55500 (http) with context path ' '
2023-11-13T14:19:02.868+01:00  INFO 34848 --- [main] a.c.e.b.SpringFmPlaygroundApplication    : Started SpringFmPlaygroundApplication in 1.415 seconds (process running for 1.659)

؟ تعمل الواجهة الخلفية على المنفذ 55500 افتراضيًا. انظر أدناه للحصول على تغييرات المنفذ.

إعداد الواجهة الأمامية

في نافذة طرفية جديدة ، انتقل إلى دليل frontend وقم بتثبيت الحزم المطلوبة عن طريق تشغيل الأمر التالي:

npm install

بعد التثبيت الناجح ، يمكنك بدء تطبيق الواجهة الأمامية عن طريق تنفيذ الأمر التالي:

npm run dev

عند تشغيل التطبيق ، سترى الإخراج التالي:

 > [email protected] dev
> next dev

   ▲ Next.js 14.0.0
   - Local:        http://localhost:3000

 ✓ Ready in 3.3s

الوصول إلى التطبيق

افتح http://localhost:3000 في متصفح الويب الخاص بك للتفاعل مع التطبيق.

إيقاف التطبيق

لوقف التطبيق ، ستحتاج إلى إيقاف كل من عمليات الواجهة الخلفية والواجهة.

إيقاف الواجهة الأمامية

في المحطة التي تعمل فيها الواجهة الأمامية ، اضغط على Ctrl + C لإنهاء العملية.

إيقاف الخلفية

وبالمثل ، في محطة الواجهة الخلفية ، استخدم اختصار Ctrl + C لإيقاف الخادم.

إذا واجهت أي مشكلات ، فيمكنك إنهاء العمليات بقوة من خلال العثور على معرف العملية ( PID ) واستخدام أمر kill على أنظمة UNIX أو Task Manager على Windows.

باستخدام منافذ مختلفة

قم بتغيير منفذ الواجهة الخلفية في الملفات التالية:

• backend/src/main/resources/application.yml
• frontend/app/app.config.js

لتشغيل الواجهة الأمامية على منفذ مختلف:

npm run dev -- --port NEW_PORT

استكشاف الأخطاء وإصلاحها

منطقة AWS مشفرة في التطبيق. ومع ذلك ، إذا تم ضبط متغير بيئة AWS_REGION المحلي على منطقة مختلفة ، فقد يفشل التطبيق. في هذه الحالة ، يرجى التأكد من إلغاء تعيين AWS_REGION ، أو تعيينه على us-east-1 .

رخصة

هذه المكتبة مرخصة بموجب ترخيص MIT-0. انظر ملف الترخيص.

حماية

انظر المساهمة لمزيد من المعلومات.