مشاركة عبر

التشغيل السريع: نشر ملف بيانات اصطناعية إلى Azure Container Apps (معاينة)

  • مقالة

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

تظهر لقطة الشاشة التالية الإخراج من خدمة واجهة برمجة تطبيقات الألبوم التي تنشرها.

لقطة شاشة للاستجابة من نقطة نهاية واجهة برمجة تطبيقات الألبومات.

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

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

راجع تعيين أدوار Azure باستخدام مدخل Microsoft Azure للحصول على التفاصيل.
حساب GitHub احصل على واحد مجانا.
git تثبيت git
Azure CLI قم بتثبيت Azure CLI.
Java تثبيت JDK أو التوصية ب 17 أو أحدث
Maven تثبيت Maven.

الإعداد

لتسجيل الدخول إلى Azure من CLI، قم بتشغيل الأمر التالي واتبع المطالبات لإكمال عملية المصادقة.

az login

للتأكد من تشغيل أحدث إصدار من CLI، قم بتشغيل أمر الترقية.

az upgrade

بعد ذلك، قم بتثبيت أو تحديث ملحق Azure Container Apps ل CLI.

إذا تلقيت أخطاء حول المعلمات المفقودة عند تشغيل az containerapp الأوامر في Azure CLI أو cmdlets من Az.App الوحدة النمطية في PowerShell، فتأكد من تثبيت أحدث إصدار من ملحق Azure Container Apps.

az extension add --name containerapp --upgrade

إشعار

بدءا من مايو 2024، لم تعد ملحقات Azure CLI تمكن ميزات المعاينة بشكل افتراضي. للوصول إلى ميزات معاينة تطبيقات الحاوية، قم بتثبيت ملحق Container Apps باستخدام --allow-preview true.

az extension add --name containerapp --upgrade --allow-preview true

الآن بعد تثبيت الملحق أو الوحدة النمطية Microsoft.App الحالية، قم بتسجيل مساحات الأسماء و Microsoft.OperationalInsights .

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

إنشاء متغيرات البيئة

الآن بعد اكتمال إعداد Azure CLI، يمكنك تحديد متغيرات البيئة المستخدمة في هذه المقالة.

حدد المتغيرات التالية في bash shell.

RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
SUBSCRIPTION=<YOUR_SUBSCRIPTION_ID>

إذا لزم الأمر، يمكنك الاستعلام عن معرف الاشتراك الخاص بك.

az account list --output table

إعداد مستودع GitHub

ابدأ بنسخ مستودع العينة.

استخدم الأمر git التالي لاستنساخ نموذج التطبيق في مجلد التعليمات البرمجية إلى السحابة :

git clone https://github.com/azure-samples/containerapps-albumapi-java code-to-cloud

cd code-to-cloud

إنشاء ملف JAR

إشعار

يدعم نموذج Java فقط بناء Maven، مما يؤدي إلى ملف JAR قابل للتنفيذ. يستخدم البناء الإعدادات الافتراضية لأن تمرير متغيرات البيئة غير مدعوم.

بناء المشروع باستخدام Maven.

mvn clean package -DskipTests

قم بتشغيل المشروع محلياً

java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar

للتحقق من تشغيل التطبيق، افتح مستعرضا وانتقل إلى http://localhost:8080/albums. ترجع الصفحة قائمة بعناصر JSON.

نشر البيانات الاصطناعية

إنشاء تطبيق الحاوية الأول ونشره من ملف JAR المحلي باستخدام containerapp up الأمر .

هذا الأمر:

  • إنشاء مجموعة الموارد
  • إنشاء سجل حاويات Azure
  • إنشاء صورة الحاوية ودفعها إلى السجل
  • إنشاء بيئة تطبيقات الحاوية باستخدام مساحة عمل Log Analytics
  • إنشاء تطبيق الحاوية ونشره باستخدام صورة حاوية عامة

up يستخدم الأمر ملف Docker في جذر المستودع لإنشاء صورة الحاوية. EXPOSE تعرف التعليمات الموجودة في ملف Docker المنفذ الهدف. ومع ذلك، لا يلزم وجود ملف Docker لإنشاء تطبيق حاوية.

إشعار

ملاحظة: عند استخدام containerapp up مع قاعدة تعليمات برمجية بدون Docker، استخدم المعلمة --location بحيث يتم تشغيل التطبيق في موقع آخر غير شرق الولايات المتحدة.

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --artifact ./target/containerapps-albumapi-java-0.0.1-SNAPSHOT.jar \
  --ingress external \
  --target-port 8080 \
  --subscription $SUBSCRIPTION

تحقق من النشر

انسخ FQDN إلى مستعرض ويب. من مستعرض الويب، انتقل إلى /albums نقطة نهاية FQDN.

لقطة شاشة للاستجابة من نقطة نهاية واجهة برمجة تطبيقات الألبومات.

نشر ملف WAR

يمكنك أيضا نشر تطبيق الحاوية من ملف WAR.

تنظيف الموارد

إذا كنت لن تستمر في استخدام هذا التطبيق، يمكنك حذف مثيل Azure Container Apps وكافة الخدمات المقترنة عن طريق إزالة مجموعة الموارد.

اتبع هذه الخطوات لإزالة الموارد التي قمت بإنشائها:

az group delete \
  --resource-group $RESOURCE_GROUP

تلميح

هل تواجه مشكلات؟ اسمحوا لنا أن نعرف على GitHub عن طريق فتح مشكلة في Azure Container Apps repo.

الخطوات التالية

تعرف على المزيد حول التطوير في Java على تطبيقات الحاوية