التشغيل السريع: إنشاء ونشر من التعليمات البرمجية المصدر المحلي إلى Azure Container Apps
توضح هذه المقالة كيفية إنشاء خدمة مصغرة ونشرها إلى Azure Container Apps من التعليمات البرمجية المصدر المحلي باستخدام لغة البرمجة التي تختارها. في هذا التشغيل السريع، يمكنك إنشاء خدمة واجهة برمجة تطبيقات الويب الخلفية التي ترجع مجموعة ثابتة من ألبومات الموسيقى.
تظهر لقطة الشاشة التالية الإخراج من خدمة واجهة برمجة تطبيقات الألبوم التي تنشرها.
المتطلبات الأساسية
لإكمال هذا المشروع، تحتاج إلى العناصر التالية:
المتطلبات | الإرشادات |
---|---|
حساب Azure | إذا لم يكن لديك حساب، فبادر بإنشاء حساب مجانا. تحتاج إلى إذن المساهم أو المالك على اشتراك Azure للمتابعة. راجع تعيين أدوار Azure باستخدام مدخل Microsoft Azure للحصول على التفاصيل. |
Git | تثبيت GIT. |
Azure CLI | قم بتثبيت Azure CLI. |
الإعداد
لتسجيل الدخول إلى Azure من CLI، قم بتشغيل الأمر التالي واتبع المطالبات لإكمال عملية المصادقة.
للتأكد من تشغيل أحدث إصدار من CLI، قم بتشغيل أمر الترقية.
بعد ذلك، قم بتثبيت أو تحديث ملحق Azure Container Apps ل CLI.
الآن بعد تثبيت الملحق الحالي، قم بتسجيل 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
إنشاء تطبيق الحاوية ونشره
أولا، قم بتشغيل الأمر التالي لإنشاء مجموعة الموارد التي ستحتوي على الموارد التي تقوم بإنشائها في هذا التشغيل السريع.
إنشاء تطبيق الحاوية الأول ونشره 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 التي تم إنشاؤها أثناء هذا التشغيل السريع باستخدام الأمر التالي.
تنبيه
يحذف الأمر التالي مجموعة الموارد المحددة وجميع الموارد المضمنة فيها. إذا كانت المجموعة تحتوي على موارد خارج نطاق هذا التشغيل السريع، يتم حذفها أيضا.
تلميح
هل تواجه مشكلات؟ اسمحوا لنا أن نعرف على GitHub عن طريق فتح مشكلة في Azure Container Apps repo.
الخطوات التالية
بعد إكمال هذا التشغيل السريع، يمكنك المتابعة إلى البرنامج التعليمي: الاتصال بين الخدمات المصغرة في Azure Container Apps لمعرفة كيفية نشر تطبيق واجهة أمامية يستدعي واجهة برمجة التطبيقات.