مشاركة عبر


التشغيل السريع: إنشاء ونشر من التعليمات البرمجية المصدر المحلي إلى Azure Container Apps

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

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

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

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

لإكمال هذا المشروع، تحتاج إلى العناصر التالية:

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

راجع تعيين أدوار Azure باستخدام مدخل Microsoft Azure للحصول على التفاصيل.
Git تثبيت GIT.
Azure CLI قم بتثبيت Azure CLI.

الإعداد

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

az login

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

az upgrade

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

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

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

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

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

export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"

الحصول على التعليمات البرمجية للعينة

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

git clone https://github.com/azure-samples/containerapps-albumapi-csharp.git
cd containerapps-albumapi-csharp/src

إنشاء تطبيق الحاوية ونشره

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

az group create --name $RESOURCE_GROUP --location $LOCATION

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

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

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

في مثال التعليمات البرمجية . التالي، يخبر containerapp up (نقطة) بالتشغيل في الدليل الحالي للمشروع الذي يحتوي أيضا على Dockerfile.

az containerapp up \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --location $LOCATION \
  --environment $ENVIRONMENT \
  --source .

إشعار

إذا أرجع الأمر خطأ مع الرسالة "AADSTS50158: تحدي الأمان الخارجي غير راض"، فقم بتشغيل az login --scope https://graph.microsoft.com//.default لتسجيل الدخول بالأذونات المطلوبة ثم قم بتشغيل az containerapp up الأمر مرة أخرى.

تحقق من النشر

حدد موقع URL لتطبيق الحاوية في إخراج az containerapp up الأمر. انتقل إلى عنوان URL في المستعرض. أضف /albums إلى نهاية عنوان URL لمشاهدة الاستجابة من واجهة برمجة التطبيقات.

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

الحدود

الحد الأقصى لحجم تحميل التعليمات البرمجية المصدر هو 200 ميغابايت. إذا تجاوز التحميل الحد، يتم إرجاع الخطأ 413.

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

إذا كنت لن تستمر في البرنامج التعليمي Deploy a frontend ، يمكنك إزالة موارد Azure التي تم إنشاؤها أثناء هذا التشغيل السريع باستخدام الأمر التالي.

تنبيه

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

az group delete --name $RESOURCE_GROUP

تلميح

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

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

بعد إكمال هذا التشغيل السريع، يمكنك المتابعة إلى البرنامج التعليمي: الاتصال بين الخدمات المصغرة في Azure Container Apps لمعرفة كيفية نشر تطبيق واجهة أمامية يستدعي واجهة برمجة التطبيقات.