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

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

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

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

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

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

الإعداد

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

Bash

az login

بوويرشيل

az login

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

Bash

az upgrade

بوويرشيل

az upgrade

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

Bash

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

بوويرشيل

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

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

Bash

az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights

بوويرشيل

az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights

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

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

Bash

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

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

بوويرشيل

حدد المتغيرات التالية في وحدة تحكم PowerShell.

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

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

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

C#‎

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

Java

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

JavaScript

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

Python

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

ذهب

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

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

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

Bash

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

بوويرشيل

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

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

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

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

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

Bash

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

بوويرشيل

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 التي تم إنشاؤها أثناء هذا التشغيل السريع باستخدام الأمر التالي.

تنبيه

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

Bash

az group delete --name $RESOURCE_GROUP

بوويرشيل

az group delete --name $RESOURCE_GROUP

تلميح

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

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

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

البرنامج التعليمي: الاتصال بين الخدمات المصغرة