نشر Azure Container Apps باستخدام الأمر az containerapp up

az containerapp up الأمر (أو up) هو أسرع طريقة لنشر تطبيق في Azure Container Apps من صورة موجودة أو رمز مصدر محلي أو مستودع GitHub. باستخدام هذا الأمر الفردي، يمكنك تشغيل تطبيق الحاوية الخاص بك في دقائق.

az containerapp up الأمر هو طريقة مبسطة لإنشاء ونشر تطبيقات الحاوية التي تستخدم الإعدادات الافتراضية بشكل أساسي. ومع ذلك، تحتاج إلى تشغيل أوامر CLI أخرى لتكوين إعدادات أكثر تقدما:

• Dapr: az containerapp dapr enable
• اسرار: az containerapp secret set
• بروتوكولات النقل: az containerapp ingress update

لتخصيص موارد تطبيق الحاوية أو إعدادات التحجيم، يمكنك استخدام up الأمر ثم az containerapp update الأمر لتغيير هذه الإعدادات. az containerapp up الأمر ليس اختصارا az containerapp update للأمر.

up يمكن للأمر إنشاء أو استخدام الموارد الموجودة بما في ذلك:

• مجموعة الموارد
• Azure Container Registry
• بيئة تطبيقات الحاوية ومساحة عمل Log Analytics
• تطبيق الحاوية

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

إذا كنت بحاجة إلى تخصيص بيئة Container Apps، فبادر أولا بإنشاء البيئة باستخدام az containerapp env create الأمر . إذا لم توفر بيئة موجودة، up يبحث الأمر عن بيئة في مجموعة الموارد الخاصة بك، وإذا تم العثور عليها، يستخدم تلك البيئة. إذا لم يتم العثور عليه، فإنه ينشئ بيئة مع مساحة عمل Log Analytics.

لمعرفة المزيد حول az containerapp up الأمر وخياراته، راجع az containerapp up.

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

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

الإعداد

1. سجل الدخول إلى Azure باستخدام Azure CLI.

   az login
   

2. بعد ذلك، ثبِّت ملحق Azure Container Apps لـ CLI.

   az extension add --name containerapp --upgrade
   

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

   az provider register --namespace Microsoft.App
   

4. Microsoft.OperationalInsights تسجيل الموفر لمساحة عمل Azure Monitor Log Analytics.

   az provider register --namespace Microsoft.OperationalInsights
   

النشر من صورة موجودة

يمكنك نشر تطبيق حاوية يستخدم صورة موجودة في سجل حاوية عام أو خاص. إذا كنت تقوم بالنشر من سجل خاص، فستحتاج إلى توفير بيانات الاعتماد الخاصة بك باستخدام --registry-server--registry-usernameالخيارات و و--registry-password.

في هذا المثال، az containerapp up ينفذ الأمر الإجراءات التالية:

1. قم بإنشاء مجموعة الموارد.
2. إنشاء بيئة ومساحة عمل Log Analytics.
3. إنشاء تطبيق حاوية يسحب الصورة من سجل عام ونشره.
4. تعيين دخول تطبيق الحاوية إلى خارجي مع تعيين منفذ هدف إلى القيمة المحددة.

قم بتشغيل الأمر التالي لنشر تطبيق حاوية من صورة موجودة. استبدل العناصر النائبة <> بالقيم الخاصة بك.

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --image <REGISTRY_SERVER>/<IMAGE_NAME>:<TAG> \
  --ingress external \
  --target-port <PORT_NUMBER> 

يمكنك استخدام up الأمر لإعادة نشر تطبيق حاوية. إذا كنت تريد إعادة النشر باستخدام صورة جديدة، فاستخدم --image الخيار لتحديد صورة جديدة. تأكد من تعيين الخيارين --resource-group و environment إلى نفس قيم التوزيع الأصلي.

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --image <REGISTRY_SERVER>/<IMAGE_NAME>:<TAG> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --environment <ENVIRONMENT_NAME> \
  --ingress external \
  --target-port <PORT_NUMBER> 

النشر من التعليمات البرمجية المصدر المحلي

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

يمكن للأمر إنشاء الصورة باستخدام Dockerfile أو بدونه. إذا كان البناء بدون Dockerfile يتم دعم اللغات التالية:

• .NET
• Node.js
• PHP
• Python

يوضح المثال التالي كيفية نشر تطبيق حاوية من التعليمات البرمجية المصدر المحلي.

في المثال، az containerapp up ينفذ الأمر الإجراءات التالية:

1. قم بإنشاء مجموعة الموارد.
2. إنشاء بيئة ومساحة عمل Log Analytics.
3. إنشاء سجل في Azure Container Registry.
4. إنشاء صورة الحاوية (باستخدام Dockerfile إذا كان موجودا).
5. دفع الصورة إلى السجل.
6. إنشاء تطبيق الحاوية ونشره.

قم بتشغيل الأمر التالي لنشر تطبيق حاوية من التعليمات البرمجية المصدر المحلي:

    az containerapp up \
      --name <CONTAINER_APP_NAME> \
      --source <SOURCE_DIRECTORY>\
      --ingress external 

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

إذا قمت بتكوين الدخول من خلال Dockerfile أو لا يتطلب تطبيقك الدخول، يمكنك حذف ingress الخيار.

يتضمن إخراج الأمر عنوان URL لتطبيق الحاوية.

إذا كان هناك فشل، يمكنك تشغيل الأمر مرة أخرى مع --debug خيار الحصول على مزيد من المعلومات حول الفشل. إذا فشل الإنشاء بدون Dockerfile، يمكنك محاولة إضافة Dockerfile وتشغيل الأمر مرة أخرى.

لاستخدام az containerapp up الأمر لإعادة نشر تطبيق الحاوية الخاص بك مع صورة محدثة، قم بتضمين --resource-group الوسيطتين و --environment . يوضح المثال التالي كيفية إعادة نشر تطبيق حاوية من التعليمات البرمجية المصدر المحلية.

1. قم بإجراء تغييرات على التعليمات البرمجية المصدر.

2. شغّل الأمر التالي:

   az containerapp up \
     --name <CONTAINER_APP_NAME> \
     --source <SOURCE_DIRECTORY> \
     --resource-group <RESOURCE_GROUP_NAME> \
     --environment <ENVIRONMENT_NAME>
   

النشر من مستودع GitHub

عند استخدام az containerapp up الأمر للنشر من مستودع GitHub، فإنه ينشئ سير عمل GitHub Actions الذي يبني صورة الحاوية، ويدفعها إلى سجل، وينشر تطبيق الحاوية. يقوم الأمر بإنشاء السجل في Azure Container Registry إذا لم توفر سجلا.

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

يوضح المثال التالي كيفية نشر تطبيق حاوية من مستودع GitHub.

في المثال، az containerapp up ينفذ الأمر الإجراءات التالية:

1. قم بإنشاء مجموعة الموارد.
2. إنشاء بيئة ومساحة عمل Log Analytics.
3. إنشاء سجل في Azure Container Registry.
4. إنشاء صورة الحاوية باستخدام Dockerfile.
5. دفع الصورة إلى السجل.
6. إنشاء تطبيق الحاوية ونشره.
7. إنشاء سير عمل GitHub Actions لإنشاء صورة الحاوية ونشر تطبيق الحاوية عند دفع التغييرات المستقبلية إلى مستودع GitHub.

لنشر تطبيق من مستودع GitHub، قم بتشغيل الأمر التالي:

az containerapp up \
  --name <CONTAINER_APP_NAME> \
  --repo <GitHub repository URL> \
  --ingress external 

إذا قمت بتكوين الدخول من خلال Dockerfile أو لا يتطلب تطبيقك الدخول، يمكنك حذف ingress الخيار.

up نظرا لأن الأمر ينشئ سير عمل GitHub Actions، فإن إعادة تشغيله لنشر التغييرات على صورة التطبيق له تأثير غير مرغوب فيه لإنشاء مهام سير عمل متعددة. بدلا من ذلك، ادفع التغييرات إلى مستودع GitHub الخاص بك، وينشئ سير عمل GitHub تطبيقك ويوزعه تلقائيا. لتغيير سير العمل، قم بتحرير ملف سير العمل في GitHub.

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

التشغيل السريع: نشر التعليمات البرمجية الخاصة بك إلى Azure Container Apps