البرنامج التعليمي: التوزيع إلى Azure Container Apps باستخدام Visual Studio

Azure Container Apps تمكنك من تشغيل الخدمات الصغيرة والتطبيقات الحاوية على منصة بدون خادم. مع Container Apps، يمكنك التمتع بفوائد تشغيل الحاويات مع ترك وراءها مخاوف تكوين البنية التحتية السحابية يدويًّا ومنسقي الحاويات المعقدة.

في هذا البرنامج التعليمي، يمكنك نشر تطبيق ASP.NET Core 8.0 في حاويات إلى Azure Container Apps باستخدام Visual Studio. تنطبق الخطوات أدناه أيضًا على الإصدارات السابقة من ASP.NET Core.

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

• مطلوب حساب Azure مع اشتراك نشط. إذا لم تكن تملك حسابًا، فإنه يمكنكإنشاء حساب مجانًا.
• متاح الآن تنزيل Visual Studio 2022 إصدار 17.2 أو أعلى، مجانًا.

إنشاء مشروع

ابدأ بإنشاء تطبيق ASP.NET Core في حاويات.

1. في Visual Studio، حدد ملف ثم اختر جديد => مشروع.

2. في نافذة الحوار، ابحث عن ASP.NET، ثم اختر ASP.NET Core Web App وحدد التالي.

3. في حقل اسم المشروع، قم بتسمية التطبيق MyContainerApp ثم حدد التالي.

4. في شاشة معلومات إضافية، تأكد من تحديد تمكين Docker، ثم تأكد من تحديد Linux لإعداد Docker OS. لا تدعم Azure Container Apps حاليا حاويات Windows. يضمن هذا التحديد أن قالب المشروع يدعم التعبئة في حاويات بشكل افتراضي. أثناء التمكين، يستخدم المشروع حاوية أثناء تشغيله أو إنشائه.

5. انقر فوق إنشاءويقوم Visual Studio بإنشاء المشروع وتحميله.

التوزيع إلى Azure Container Apps

يتضمن التطبيق Dockerfile لأن قالب المشروع تم تحديد إعداد Enable Docker . يستخدم Visual Studio Dockerfile لإنشاء صورة الحاوية التي تقوم Azure Container Apps بتشغيلها.

راجع كيفية إنشاء Visual Studio لتطبيقات معبأة في حاويات إذا كنت ترغب في معرفة المزيد حول تفاصيل هذه العملية.

أنت الآن جاهز للنشر إلى التطبيق إلى Azure Containers Apps.

إنشاء الموارد

تساعدك نوافذ حوار النشر في Visual Studio على اختيار موارد Azure الموجودة، أو تسمح لك بإنشاء موارد جديدة للنشر. تنشئ هذه العملية أيضا صورة الحاوية، وتدفع الصورة إلى Azure Container Registry (ACR)، وتنشر صورة تطبيق الحاوية الجديدة.

1. انقر بزر الماوس الأيمن فوق عقدة المشروع MyContainerApp وحدد نشر.

2. في مربع الحوار، اختر Azure من قائمة خيارات النشر، ثم حدد التالي.

   

3. في الشاشة الهدف المحدد، اختر Azure Container Apps (Linux)، ثم حدد التالي مرة أخرى.

   

4. بعد ذلك، قم بإنشاء Azure Container App لاستضافة المشروع. حدد أيقونة علامة الجمع الخضراء على اليمين لفتح مربع الحوار إنشاء جديد. في مربع الحوار إنشاء جديد، أدخل القيم التالية:

   • اسم Container App: أدخل اسم msdocscontainerapp.
   • اسم الاشتراك: اختر الاشتراك الذي ترغب في استضافة تطبيقك فيه.
   • مجموعة الموارد: تعمل مجموعة الموارد كحاوية منطقية لتنظيم الموارد ذات الصلة في Azure. يمكنك إما تحديد مجموعة موارد موجودة، أو تحديد جديد لإنشاء مجموعة باسم من اختيارك، مثل msdocscontainerapps.
   • بيئة Container Apps: بيئة Container Apps: يجب أن يكون كل تطبيق حاوية جزءًا من بيئة تطبيق الحاوية. توفر البيئة شبكة معزولة لتطبيق حاوية واحد أو أكثر، ما يجعل من الممكن لهم استدعاء بعضهم البعض بسهولة. انقر فوق جديد لفتح مربع الحوار "إنشاء جديد" لبيئة تطبيق الحاوية. اترك القيم الافتراضية وحدد موافق لإغلاق مربع حوار البيئة.
   • اسم الحاوية: هذا هو الاسم المألوف للحاوية التي تعمل لتطبيق الحاوية هذا. استخدم اسم msdocscontainer1 لهذا التشغيل السريع. عادة ما يقوم تطبيق الحاوية بتشغيل حاوية واحدة، ولكن هناك أوقات تحتاج فيها إلى أكثر من حاوية واحدة. أحد الأمثلة على ذلك هو عندما تكون حاوية sidecar مطلوبة لأداء نشاط مثل التسجيلات أو الاتصالات المتخصصة.

   

5. حدد إنشاء لإنهاء إنشاء تطبيق الحاوية الخاص بك. ينشئ Visual Studio وAzure الموارد المطلوبة نيابة عنك. قد تستغرق هذه العملية بضع دقائق، لذا اسمح لها بالتشغيل حتى الاكتمال قبل الانتقال.

6. بمجرد إنشاء الموارد، اختر التالي.

   

7. على شاشة السجل، يمكنك إما تحديد سجل موجود إذا كان لديك سجل، أو إنشاء سجل جديد. لإنشاء سجل جديد، انقر فوق الأيقونة الخضراء + على اليمين. في شاشة إنشاء سجل جديد، املأ القيم التالية:

   • بادئة DNS: أدخل قيمة msdocscontainerregistry أو اسمًا من اختيارك.
   • اسم الاشتراك: حدد الاشتراك الذي تريد استخدامه - قد يكون لديك اشتراك واحد فقط للاختيار من بينها.
   • مجموعة الموارد: اختر مجموعة موارد msdocs التي قمت بإنشائها مسبقًا.
   • Sku: حدد قياسي.
   • موقع السجل: حدد منطقة قريبة جغرافيًا منك.

   

8. بمجرد ملء هذه القيم، حدد Create. يستغرق Visual Studio وAzure لحظة لإنشاء السجل.

9. بمجرد إنشاء سجل الحاوية، تأكد من تحديده، ثم اختر إنهاء. يستغرق Visual Studio لحظة لإنشاء ملف تعريف النشر. ملف تعريف النشر هذا هو المكان الذي يخزن فيه Visual Studio خيارات النشر والموارد التي اخترتها حتى تتمكن من النشر بسرعة مرة أخرى كلما أردت. يمكنك إغلاق مربع الحوار بمجرد الانتهاء منه.

   

نشر التطبيق باستخدام Visual Studio

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

اختر نشر في الزاوية العلوية اليمنى من شاشة ملف تعريف النشر لتوزيعها في تطبيق الحاوية الذي أنشأته في Azure. قد تستغرق هذه العملية لحظة، لذا انتظر حتى تكتمل.

عندما ينتهي التطبيق من التوزيع، يفتح Visual Studio مستعرض إلى عنوان URL لموقعك الموزع. قد تعرض هذه الصفحة في البداية خطأ إذا لم تنتهي جميع الموارد المناسبة من التوفير. يمكنك متابعة تحديث المستعرض بشكل دوري للتحقق مما إذا كان النشر مكتملا بالكامل.

نشر التطبيق باستخدام GitHub Actions

يمكن أيضا نشر تطبيقات الحاوية باستخدام CI/CD من خلال GitHub Actions. GitHub Actions هي أداة قوية لأتمتة وتخصيص وتنفيذ مهام سير عمل التطوير مباشرة من خلال مستودع GitHub لمشروعك.

إذا اكتشف Visual Studio أن المشروع الذي تنشره مستضاف في GitHub، فإن تدفق النشر يقدم خطوة نوع نشر إضافية. تسمح هذه المرحلة للمطورين باختيار ما إذا كانوا سينشرون مباشرة من خلال Visual Studio باستخدام الخطوات الموضحة سابقًا في التشغيل السريع، أو من خلال سير عمل GitHub Actions.

إذا قمت بتحديد سير عمل GitHub Actions، يقوم Visual Studio بإنشاء مجلد .github إلى الدليل الجذر للمشروع، جنبا إلى جنب مع ملف YAML تم إنشاؤه داخله. يحتوي ملف YAML على تكوينات GitHub Actions لإنشاء تطبيقك وتوزيعه في Azure في كل مرة تدفع فيها التعليمات البرمجية الخاصة بك.

بعد إجراء تغيير ودفع التعليمات البرمجية الخاصة بك، يمكنك رؤية تقدم عملية الإنشاء والتوزيع في GitHub ضمن علامة التبويب إجراءات. توفر هذه الصفحة سجلات ومؤشرات مفصلة حول تقدم سير العمل وصحته.

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

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

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

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

1. حدد مجموعة موارد msdocscontainerapps من القسم نظرة عامة.
2. حدد الزر حذف مجموعة الموارد في أعلى نظرة عامة على مجموعة الموارد.
3. أدخل اسم مجموعة الموارد msdocscontainerapps في مربع حوار تأكيد هل تريد بالتأكيد حذف "my-container-apps".
4. حدد حذف.
   قد تستغرق عملية حذف مجموعة الموارد بضع دقائق لإكمالها.

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