ترحيل البرامج المخصصة إلى Azure App Service باستخدام حاوية مخصصة

توفر Azure App Service مكدسات تطبيقات محددة مسبقا على Windows مثل ASP.NET أو Node.js، تعمل على IIS. تعمل بيئة Windows المكونة مسبقاً على تأمين نظام التشغيل من:

• الوصول الإداري.
• إكمال عمليات تثبيت البرامج.
• تغييرات التي تطرأ على ذاكرة التخزين المؤقت للتجميع العمومي.

لمزيدٍ من المعلومات، راجع وظائف نظام التشغيل على خدمة Azure App Service.

يمكنك نشر صورة Windows مكونة خصوصاً من Visual Studio لإجراء تغييرات نظام التشغيل التي يحتاجها تطبيقك. هكذا من السهل ترحيل التطبيق المحلي الذي يتطلب تكوين نظام التشغيل والبرامج المخصص. يوضح هذا البرنامج التعليمي كيفية ترحيل تطبيق ASP.NET الذي يستخدم خطوطا مخصصة مثبتة في مكتبة الخطوط Windows إلى App Service. تقوم بنشر صورة Windows مكونه خصيصا من Visual Studio إلى Azure Container Registry، ثم قم بتشغيله في App Service.

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

لإكمال هذا البرنامج التعليمي:

• التسجيل في حساب Docker Hub
• تثبيت Docker أو Windows.
• تبديل Docker لتشغيل حاويات Windows.
• تثبيت Visual Studio 2022 باستخدام ASP.NET وتطوير الويب وأحجام عمل التطوير الخاصة بـ Azure. إذا قمت بتثبيت Visual Studio 2022 بالفعل:
  • ثبّت آخر التحديثات في Visual Studio بتحديد تعليمات>التحقق من وجود تحديثات.
  • أضِف أحمال العمل في Visual Studio من خلال تحديد "Tools">"Get Tools and Features".

قم بإعداد التطبيق مَحَلِّيّاً

تنزيل العينة

في هذه الخطوة، يمكنك إعداد مشروع .NET المحلي.

• تحميل نموذج المشروع.
• استخلاص (فك ضغط) ملف custom-font-win-container-master.zip.

يحتوي نموذج المشروع على تطبيق ASP.NET بسيط والذي يستخدم خط مخصص مثبت في مكتبة خطوط Windows. ليس من الضروري تثبيت هذه الخطوط. ومع ذلك، العينة هي مثال على تطبيق متكامل مع نظام التشغيل الرئيسي. لترحيل مثل هذا التطبيق إلى App Service، يمكنك إما إعادة تكييف التعليمات البرمجية الخاصة بك لإزالة التكامل، أو ترحيلها كما هي في حاوية Windows مخصصة.

قم بتثبيت الأدوات

في Windows Explorer، انتقل إلى custom-font-win-container-master/CustomFontSample، انقر بزر الماوس الأيمن فوق FrederickatheGreat-Regular.ttf،وحدد تثبيت.

هذا الخط متاح للجمهور من خطوط Google.

تشغيل التطبيق

قم بفتح ملف custom-font-win-container/CustomFontSample.sln في Visual Studio.

اكتب Ctrl+F5 لتشغيل التطبيق دون تصحيح الأخطاء. يتم عرض التطبيق في المستعرض الافتراضي الخاص بك.

اعتباراً لأنه يستخدم خطاً مثبتاً، لا يمكن تشغيل التطبيق في بيئة الاختبار المعزولة App Service. ومع ذلك، يمكنك نشره باستخدام حاوية Windows بدلا من ذلك، لأنه يمكنك تثبيت الخط في حاوية Windows.

تكوين حاوية Windows

في Solution Explorer، انقر بزر الماوس الأيمن فوق مشروع CustomFontSample وحدد إضافة>Container Orchestration Support.

حدد إعداد Docker >موافق.

تم إعداد مشروعك الآن لتشغيله في حاوية Windows. Dockerfile تتم إضافة إلى مشروع CustomFontSample، ويضاف مشروع docker-compose إلى الحل.

من Solution Explorer، افتح Dockerfile.

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

FROM mcr.microsoft.com/dotnet/framework/aspnet:4.7.2-windowsservercore-ltsc2019

في نهاية الملف، أضف السطر التالي واحفظ الملف:

RUN ${source:-obj/Docker/publish/InstallFont.ps1}

يمكنك العثور على InstallFont.ps1 في مشروع CustomFontSample. إنه برنامج نصي بسيط يقوم بتثبيت الخط. يمكنك العثور على إصدار أكثر تعقيدا من البرنامج النصي في معرض PowerShell.

إشعار

للقيام باختبار حاوية Windows محلياً، تأكد من بدء تشغيل Docker على الجهاز المحلي.

نشر في Azure Container Registry

يمكن Azure Container Registry تخزين الصور الخاصة بك لنشر حاوية. يمكنك تكوين App Service لاستخدام الصور المستضافة في Azure Container Registry.

فتح معالج النشر

في Solution Explorer، انقر بزر الماوس الأيمن فوق مشروع CustomFontSample وحدد نشر.

قم بإنشاء التسجيل والنشر

في معالج النشر، حدد تسجيل الحاوية>إنشاء نشر سجل حاويات Azure >جديد.

قم بالتسجيل بحساب Azure

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

قم بتكوين التسجيل

قم بتكوين سجل حاوية جديدة استنادا إلى القيم المقترحة في الجدول التالي. عند الانتهاء، حدّد «إنشاء».

الإعدادات	القيمة المقترحة	لمزيد من المعلومات
بادئة DNS	قم بالاحتفاظ باسم التسجيل الذي تم إنشاؤه أو تغييره إلى اسم فريد آخر.
مجموعة الموارد	حدد New، واكتب myResourceGroup، وحدد OK.
SKU	أساسي	مستويات التسعير
موقع التسجيل	أوروبا الغربية

تم فتح إطار محطة طرفية وتعرض تطور نشر الصورة. انتظر حتى يكتمل التوزيع.

تسجيل الدخول إلى Azure

قم بتسجيل الدخول إلى بوابة Azure.

أنشئ تطبيق ويب

من القائمة اليسري، حدد إنشاء مورد>> تطبيق الويب للحاويات.

قم بتكوين أساسيات التطبيق

في علامة التبويب الأساسيات قم بتكوين الإعدادات وفقاً للجدول التالي ثم انقر على Next: Docker.

الإعدادات	القيمة المقترحة	لمزيد من المعلومات
الاشتراك	تأكد من تحديد الاشتراك الصحيح.
مجموعة الموارد	حدد Create new، واكتب myResourceGroup، وحدد OK.
الاسم	اكتب اسم فريد.	عنوان URL لتطبيق الويب هو https://<app-name>.azurewebsites.net، حيث <app-name> هو اسم التطبيق الخاص بك.
نشر	حاوية Docker
نظام تشغيل	Windows
المنطقة	أوروبا الغربية
خطة Windows	حدد Create new، واكتب myAppServicePlan، وحدد OK.

يجب أن تبدو علامة تبويب الأساسيات كما يلي:

تكوين حاوية Windows

في علامة التبويب Docker، قم بتكوين حاوية Windows المخصصة كما هو موضح في الجدول التالي، وحدد مراجعة + إنشاء.

الإعدادات	القيمة المقترحة
مصدر الصورة	سجل حاوية Azure
التسجيل	حدد التسجيل الذي أنشأته سابقا.
الصورة	customfontsample
العلامات	الأحدث

إنشاء التطبيق بالكامل

حدد Create وانتظر Azure لتقوم بإنشاء الموارد المطلوبة منك.

استعرض التطبيق

عند اكتمال عملية Azure، يتم عرض مربع إعلام.

1. حدد الانتقال إلى المورد.

2. في صفحة التطبيق، حدد الرابط الموجود أسفل URL.

يتم فتح صفحة مستعرض جديدة إلى الصفحة التالية:

انتظر بضع دقائق وحاول مرة أخرى، حتى تحصل على الصفحة الرئيسية مع الخط الجميل الذي تتوقعه:

تهانينا! لقد قمت بترحيل تطبيق ASP.NET إلى خدمة تطبيقات Azure في حاوية Windows.

مراجعة سجلات بدء تشغيل الحاوية

قد يستغرق تحميل حاوية Windows القليل من الوقت. للاطلاع على التقدم، انتقل إلى عنوان URL الآتي عن طريق استبدال <app-name> باسم تطبيقك.

https://<app-name>.scm.azurewebsites.net/api/logstream

تبدو السجلات المتدفقة كما يلي:

14/09/2018 23:16:19.889 INFO - Site: fonts-win-container - Creating container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest.
14/09/2018 23:16:19.928 INFO - Site: fonts-win-container - Create container for image: customfontsample20180914115836.azurecr.io/customfontsample:latest succeeded. Container Id 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:23.405 INFO - Site: fonts-win-container - Start container succeeded. Container: 329ecfedbe370f1d99857da7352a7633366b878607994ff1334461e44e6f5418
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:17:28.637 INFO - Site: fonts-win-container - Configuring container
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container ready
14/09/2018 23:18:03.823 INFO - Site: fonts-win-container - Container start-up and configuration completed successfully

تستخدم Azure App Service تقنية حاوية Docker لاستضافة الصور المدمجة والصور المخصصة. لمراجعة قائمة من الصور المضمنة، شغّل أمر Azure CLI، 'az webapp list-runtimes --os linux'. إذا كانت هذه الصور لا تلبي احتياجاتك، يمكنك إنشاء ونشر صورة مخصصة.

إشعار

يجب أن تستهدف الحاوية بنية x86-x64، ARM64 غير مدعوم.

في هذا البرنامج التعليمي، تتعلم كيفية:

• اضغط على الصورة لإظهار Azure Container Registry
• نشر الصورة المخصصة لـ App Service
• تكوين متغيرات البيئة
• سحب الصورة إلى App Service باستخدام هوية مدارة
• الوصول إلى سجلات التشخيص
• تمكين CI/CD من Azure Container Registry إلى App Service
• قم بالاتصال بالحاوية عن طريق استخدام SSH

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

قم بإعداد بيئتك الأولية

يتطلب هذا البرنامج التعليمي الإصدار 2.0.80 أو الأحدث من CLI Azure. إذا كنت تستخدم Azure Cloud Shell، فإن أحدث إصدار مثبت بالفعل.

• أن يكون لديك حساب Azure باشتراك نشط. أنشئ حساباً مجاناً.

• استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع التشغيل السريع ل Bash في Azure Cloud Shell.

  

• إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.

  • إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.

  • عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.

  • يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.

• تثبيت Docker، والتي تستخدمها لبناء صور Docker. قد يتطلب منك تثبيت Docker إعادة تشغيل جهاز كمبيوتر.

بعد تثبيت Docker أو تشغيل Azure Cloud Shell، افتح نافذة طرفية وتحقق من تثبيت docker:

docker --version

نسخ أو تنزيل عينة التطبيق

يمكنك الحصول على عينة لهذا البرنامج التعليمي عن طريق استنساخها أو تحميلها من git .

استنساخ باستخدام git

نسخ مستودع العينة:

git clone https://github.com/Azure-Samples/docker-django-webapp-linux.git --config core.autocrlf=input

تأكد من تضمين الوسيطة --config core.autocrlf=input لضمان نهايات الأسطر المناسبة في الملفات المستخدمة داخل الحاوية Linux:

ثم، انتقل إلى المجلد:

cd docker-django-webapp-linux

قم بالتحميل من GitHub

بدلا من استخدام استنساخ git ، يمكنك زيارة https://github.com/Azure-Samples/docker-django-webapp-linux ، حدد استنساخ، ثم حدد تنزيل ZIP.

فك ملف ZIP في مجلد اسمه docker-django-webapp-linux.

ثم، افتح نافذة المحطة الطرفية في المجلدdocker-django-webapp-linux.

(اختياري) فحص ملف Docker

الملف في النموذج المسمى Dockerfile الذي يصف صورة docker ويحتوي على إرشادات التكوين:

FROM tiangolo/uwsgi-nginx-flask:python3.6

RUN mkdir /code
WORKDIR /code
ADD requirements.txt /code/
RUN pip install -r requirements.txt --no-cache-dir
ADD . /code/

# ssh
ENV SSH_PASSWD "root:Docker!"
RUN apt-get update \
        && apt-get install -y --no-install-recommends dialog \
        && apt-get update \
 && apt-get install -y --no-install-recommends openssh-server \
 && echo "$SSH_PASSWD" | chpasswd 

COPY sshd_config /etc/ssh/
COPY init.sh /usr/local/bin/

RUN chmod u+x /usr/local/bin/init.sh
EXPOSE 8000 2222

#CMD ["python", "/code/manage.py", "runserver", "0.0.0.0:8000"]
ENTRYPOINT ["init.sh"]

• تقوم المجموعة الأولى من الأوامر بتثبيت متطلبات التطبيق في البيئة.
• المجموعة الثانية من الأوامر إنشاء ملقم SSH للاتصال الآمن بين الحاوية والمضيف.
• السطر الأخير، ENTRYPOINT ["init.sh"] ، استدعاء لبدء تشغيل خدمة init.sh SSH وخادم Python.

إنشاء الصورة واختبارها محليا

إشعار

Docker Hub لديه حصص على عدد عمليات السحب المجهولة لكل IP وعدد عمليات السحب الموثقة لكل مستخدم حر (انظر نقل البيانات). إذا لاحظت أن عمليات السحب من Docker Hub محدودة، فحاول docker login إذا لم تكن قد سجلت الدخول بالفعل.

1. قم بتشغيل الأمر التالي لإنشاء صورة:

   docker build --tag appsvc-tutorial-custom-image .
   

2. اختبر أن البناء يعمل عن طريق تشغيل حاوية Docker محليا:

   docker run -it -p 8000:8000 appsvc-tutorial-custom-image
   

   يحدد هذا docker run الأمر المنفذ باستخدام -p الوسيطة متبوعا باسم الصورة. -it يتيح لك إيقافها مع Ctrl+C .

   تلميح

   إذا كنت تعمل على Windows وترى الخطأ standard_init_linux.go:211: exec user process caused "no such file or directory"، يحتوي الملف init.sh على نهايات سطر CR-LF بدلاً من نهايات LF المتوقعة. يحدث هذا الخطأ إذا كنت تستخدم git لنسخ مستودع العينة ولكن حذف --config core.autocrlf=input المعلمة. في هذه الحالة، استنسخ المستودع مرة أخرى مع الوسيطة '--config'. قد تشاهد الخطأ أيضا إذا قمت بتحرير init.sh وحفظته مع نهايات CRLF. في هذه الحالة، قم بحفظ الملف مرة أخرى مع نهايات LF فقط.

3. استعرض http://localhost:8000 للتحقق من أن تطبيق الويب والحاوية يعملان بشكل صحيح.

   

ط. إنشاء هوية مُدارة يعينها المستخدم

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

Azure CLI

1. أنشئ مجموعة موارد باستخدام أمر az group create:

   az group create --name msdocs-custom-container-tutorial --location westeurope
   

   يمكنك تغيير --location القيمة لتحديد منطقة قريبة منك.

2. إنشاء هوية مدارة في مجموعة الموارد.

   az identity create --name myID --resource-group msdocs-custom-container-tutorial
   

مدخل Microsoft Azure

I.A. في مدخل Microsoft Azure:

1. اكتب "الهويات المدارة" في شريط البحث أعلى مدخل Microsoft Azure.
2. حدد العنصر المسمى الهويات المدارةضمن عنوان الخدمات .
3. حدد إنشاء. يمكنك أيضا الانتقال إلى معالج الإنشاء مباشرة.

I.B. في معالج الإنشاء:

1. في الاشتراك، حدد الاشتراك الذي تريد إنشاء مواردك فيه.
2. في Resource group، حدد Create new، واكتب الاسم msdocs-custom-container-tutorial لمجموعة الموارد، ثم اكتب OK.
3. في المنطقة، حدد غرب أوروبا، أو منطقة قريبة منك.
4. في الاسم، اكتب myID.

I.C.

1. حدد علامة التبويب Review + create.
2. حدد إنشاء.

هويه. عند اكتمال إنشاء الهوية، يمكنك فتح صفحة الإدارة الخاصة بها عن طريق تحديد Go to resource.

2. إنشاء سجل حاويات

Azure CLI

1. قم بإنشاء سجل حاوية باستخدام az acr create الأمر واستبدل <registry-name> باسم فريد للسجل الخاص بك. يجب أن يحتوي الاسم على أحرف وأرقام فقط، ويجب أن يكون فريدا عبر جميع Azure.

   az acr create --name <registry-name> --resource-group msdocs-custom-container-tutorial --sku Basic --admin-enabled true
   

   --admin-enabled تتيح لك المعلمة دفع الصور إلى السجل باستخدام مجموعة من بيانات الاعتماد الإدارية.

2. استرداد بيانات الاعتماد الإدارية عن طريق تشغيل az acr show الأمر :

   az acr credential show --resource-group msdocs-custom-container-tutorial --name <registry-name>
   

   يوفر إخراج JSON من هذا الأمر اثنين من كلمات المرور مع اسم المستخدم الخاص بالتسجيل.

مدخل Microsoft Azure

II.A. في مدخل Microsoft Azure:

1. اكتب "سجلات الحاويات" في شريط البحث أعلى مدخل Microsoft Azure.
2. حدد العنصر المسمى سجلات الحاويةضمن عنوان الخدمات .
3. حدد إنشاء. يمكنك أيضا الانتقال إلى معالج الإنشاء مباشرة.

II.B. في معالج الإنشاء:

1. في Subscription، حدد الاشتراك الذي استخدمته سابقا.
2. في Resource group، حدد msdocs-custom-container-tutorial.
3. في اسم السجل، اكتب اسما فريدا لسجل الحاوية.
4. في الموقع، حدد غرب أوروبا، أو نفس المنطقة مثل هويتك المدارة.
5. في SKU، حدد Basic.

II.C.

1. حدد علامة التبويب Review + create.
2. حدد إنشاء.

II.D. عند اكتمال إنشاء سجل الحاوية، افتح صفحة الإدارة الخاصة به عن طريق تحديد Go to resource.

II.E. في قائمة التنقل اليسرى:

1. حدد مفاتيح الوصول.
2. في مسؤول المستخدم، حدد Enabled.
3. انسخ قيم خادم تسجيل الدخول واسم المستخدم وكلمة المرور. ستستخدمها في الخطوة التالية لتسجيل الدخول إلى السجل ودفع صورة docker.

3. دفع نموذج الصورة إلى Azure Container Registry

في هذا القسم، يمكنك دفع الصورة إلى Azure Container Registry، والتي سيتم استخدامها بواسطة App Service لاحقا.

1. من المحطة الطرفية المحلية حيث قمت بإنشاء نموذج الصورة، استخدم docker login الأمر لتسجيل الدخول إلى سجل الحاوية:

   docker login <registry-name>.azurecr.io --username <registry-username>
   

   استبدل <registry-name><registry-username> وبالقيم من الخطوات السابقة. عند مطالبتك، اكتب إحدى كلمات المرور من الخطوة السابقة.

   يمكنك استخدام نفس اسم التسجيل في كافة الخطوات المتبقية من هذا القسم.

2. عند نجاح تسجيل الدخول، ضع علامة على صورة Docker المحلية إلى السجل:

   docker tag appsvc-tutorial-custom-image <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

3. استخدم docker push الأمر لدفع الصورة إلى التسجيل:

   docker push <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

   قد يستغرق تحميل الصورة في المرة الأولى بضع دقائق لأنها تتضمن الصورة الأساسية. التحميلات اللاحقة عادة ما تكون أسرع.

   أثناء الانتظار، يمكنك إكمال الخطوات الموجودة في القسم التالي لتكوين App Service للنشر من التسجيل.

4. تخويل الهوية المدارة للسجل الخاص بك

لا تملك الهوية المدارة التي قمت بإنشائها تخويل لسحبها من سجل الحاوية حتى الآن. في هذه الخطوة، يمكنك تمكين التخويل.

Azure CLI

1. استرداد المعرف الأساسي للهوية المدارة:

   principalId=$(az identity show --resource-group msdocs-custom-container-tutorial --name myID --query principalId --output tsv)
   

2. استرداد معرف المورد لسجل الحاوية:

   registryId=$(az acr show --resource-group msdocs-custom-container-tutorial --name <registry-name> --query id --output tsv)
   

3. منح إذن الهوية المدارة للوصول إلى سجل الحاوية:

   az role assignment create --assignee $principalId --scope $registryId --role "AcrPull"
   

   لمزيد من المعلومات حول هذه الأذونات، راجع ما هو عنصر تحكم الوصول المستند إلى دور Azure.

مدخل Microsoft Azure

IV.A. مرة أخرى في صفحة الإدارة لسجل الحاوية:

1. في قائمة التنقل اليسرى، حدد Access control.
2. حدد Add role assignment.

IV.B. حدد AcrPull في القائمة.

IV.C.:

1. حدد علامة التبويب الأعضاء.
2. ضمن تعيين الوصول إلى، حدد الهوية المدارة.
3. ضمن Members، حدد Select members.

IV.D.

1. في الهوية المدارة، حدد الهوية المدارة المعينة من قبل المستخدم.
2. ضمن Select، حدد myID.

IV.E.

1. حدد علامة التبويب Review + assign.
2. حدد Review + assign في الأسفل.

5. أنشئ تطبيق الويب

Azure CLI

1. إنشاء خطة خدمة التطبيقات باستخدام az appservice plan create الأمر:

   az appservice plan create --name myAppServicePlan --resource-group msdocs-custom-container-tutorial --is-linux
   

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

2. إنشاء تطبيق ويب باستخدام az webapp create الأمر:

   az webapp create --resource-group msdocs-custom-container-tutorial --plan myAppServicePlan --name <app-name> --deployment-container-image-name <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

   استبدله <app-name> باسم لتطبيق الويب، والذي يجب أن يكون فريدا عبر كل Azure. استبدله أيضا <registry-name> باسم التسجيل من القسم السابق.

   تلميح

   يمكنك استرداد إعدادات الحاوية في تطبيق الويب في أي وقت باستخدام الأمرaz webapp config container show --name <app-name> --resource-group msdocs-custom-container-tutorial. يتم تحديد الصورة في الخاصيةDOCKER_CUSTOM_IMAGE_NAME. عند نشر تطبيق الويب من خلال قوالب Azure DevOps أو Azure Resource Manager، يمكن أن تظهر الصورة أيضا في خاصية باسم LinuxFxVersion. كلا الخاصيتان يخدمان نفس الغرض. إذا كان كلاهما موجودا في تكوين تطبيق الويب، LinuxFxVersion يأخذ الأسبقية.

مدخل Microsoft Azure

منوعات. في مدخل Microsoft Azure:

1. اكتب "app" في شريط البحث أعلى مدخل Microsoft Azure.
2. حدد العنصر المسمى App Services ضمن عنوان Services .
3. حدد إنشاء. يمكنك أيضا الانتقال إلى معالج الإنشاء مباشرة.

V.B. في معالج الإنشاء:

1. في Subscription، حدد الاشتراك الذي استخدمته سابقا.
2. في Resource group، حدد msdocs-custom-container-tutorial.
3. في الاسم، اكتب اسم تطبيق فريد، والذي سيتم استخدامه في اسم <app-name>.azurewebsites.netالمضيف الافتراضي لتطبيقك.
4. في Publish، حدد Docker Container.
5. في نظام التشغيل، حدد Linux.
6. في المنطقة، حدد غرب أوروبا، أو منطقة قريبة منك.
7. في خطة Linux (غرب أوروبا)، حدد إنشاء جديد، واكتب اسم خطة، وحدد موافق.
8. في خطة التسعير، حدد تغيير الحجم.

V.C. في منتقي المواصفات:

1. حدد Dev / Test.
2. حدد B1.
3. حدد تطبيق.

V.D. مرة أخرى في معالج إنشاء تطبيق ويب:

1. حدد علامة التبويب Docker.
2. في مصدر الصورة، حدد Azure Container Registry.
3. في Registry، حدد سجل الحاوية الذي أنشأته سابقا.
4. في Image، حدد appsvc-tutorial-custom-image.
5. في العلامة، حدد الأحدث.

V.E.

1. حدد علامة التبويب Review + create.
2. حدد إنشاء.

V.F. عند اكتمال إنشاء تطبيق الويب، يمكنك فتح صفحة الإدارة الخاصة به عن طريق تحديد Go to resource.

6. تكوين تطبيق الويب

في هذه الخطوة، يمكنك تكوين تطبيق الويب كما يلي:

• تستمع حاوية العينة على المنفذ 8000 لطلبات الويب، ويمكنك تكوين التطبيق لإرسال الطلبات إلى المنفذ 8000.
• اطلب من تطبيقك استخدام الهوية المدارة لسحب الصور من سجل الحاوية.
• تكوين النشر المستمر من سجل الحاوية (أو كل دفع صورة إلى السجل سيؤدي إلى تشغيل تطبيقك لسحب الصورة الجديدة). هذا الجزء غير مطلوب لتطبيق الويب الخاص بك للسحب من سجل الحاوية الخاص بك، ولكن يمكنه إعلام تطبيق الويب الخاص بك عند دفع صورة جديدة إلى السجل. بدونها، يجب تشغيل سحب صورة يدويا عن طريق إعادة تشغيل تطبيق الويب.

Azure CLI

1. استخدم az webapp config appsettings set لتعيين WEBSITES_PORT متغير البيئة كما هو متوقع بواسطة رمز التطبيق:

   az webapp config appsettings set --resource-group msdocs-custom-container-tutorial --name <app-name> --settings WEBSITES_PORT=8000
   

   استبدل <app-name> بالاسم الذي استخدمته في الخطوة السابقة.

   لمزيد من المعلومات حول متغير البيئة هذا، راجع readme في مستودع GitHub للعينة.

2. تمكين الهوية المدارة المعينة من قبل المستخدم في تطبيق الويب باستخدام az webapp identity assign الأمر :

   id=$(az identity show --resource-group msdocs-custom-container-tutorial --name myID --query id --output tsv)
   az webapp identity assign --resource-group msdocs-custom-container-tutorial --name <app-name> --identities $id
   

   استبدل <app-name> بالاسم الذي استخدمته في الخطوة السابقة.

3. قم بتكوين تطبيقك للسحب من Azure Container Registry باستخدام الهويات المدارة.

   appConfig=$(az webapp config show --resource-group msdocs-custom-container-tutorial --name <app-name> --query id --output tsv)
   az resource update --ids $appConfig --set properties.acrUseManagedIdentityCreds=True
   

   استبدل <app-name> بالاسم الذي استخدمته في الخطوة السابقة.

4. قم بتعيين معرف العميل الذي يستخدمه تطبيق الويب الخاص بك للسحب من Azure Container Registry. هذه الخطوة غير مطلوبة إذا كنت تستخدم الهوية المدارة المعينة من قبل النظام.

   clientId=$(az identity show --resource-group msdocs-custom-container-tutorial --name myID --query clientId --output tsv)
   az resource update --ids $appConfig --set properties.AcrUserManagedIdentityID=$clientId
   

5. تمكين CI/CD في App Service.

   cicdUrl=$(az webapp deployment container config --enable-cd true --name <app-name> --resource-group msdocs-custom-container-tutorial --query CI_CD_URL --output tsv)
   

   CI_CD_URL هو عنوان URL الذي تنشئه لك App Service. يجب أن يقوم التسجيل الخاص بك URL هذا لإعلام App Service بحدوث دفعة للصورة. إنها لا تخلق في الواقع webhook لك.

6. إنشاء webhook في سجل الحاويات الخاص بك باستخدام CI_CD_URL التي حصلت عليها من الخطوة الأخيرة.

   az acr webhook create --name appserviceCD --registry <registry-name> --uri $cicdUrl --actions push --scope appsvc-tutorial-custom-image:latest
   

7. لاختبار ما إذا تم تكوين خطاف الويب الخاص بك بشكل صحيح، قم باختبار اتصال خطاف الويب، ومعرفة ما إذا كنت تحصل على استجابة 200 OK.

   eventId=$(az acr webhook ping --name appserviceCD --registry <registry-name> --query id --output tsv)
   az acr webhook list-events --name appserviceCD --registry <registry-name> --query "[?id=='$eventId'].eventResponseMessage"
   

   تلميح

   لمشاهدة كافة المعلومات حول كافة أحداث webhook قم بإزالة --query المعلمة.

   إذا كنت تقوم بتدفق سجل الحاوية، يجب أن تشاهد الرسالة بعد تنفيذ الأمر ping على webhook: Starting container for site لأن webhook يؤدي إلى إعادة تشغيل التطبيق.

مدخل Microsoft Azure

VI.A. في صفحة إدارة تطبيق الويب، حدد Configuration.

VI.B. في صفحة التكوين:

1. حدد New application setting.
2. في الاسم، اكتب WEBSITES_PORT.
3. في Value، اكتب 8000.
4. حدد موافق.
5. حدد حفظ في القائمة العلوية، ثم حدد متابعة. WEBSITES_PORT يحدد الإعداد منفذ الحاوية لإعادة توجيه طلبات الويب إليه. لمزيد من المعلومات، راجع إعدادات تطبيق الحاوية المخصصة.

VI.C. في قائمة التنقل اليسرى، حدد Identity. ثم قم بما يلي في صفحة الهوية:

1. حدد علامة التبويب تعيين المستخدم.
2. حدد إضافة.

VI.D.

1. حدد myID.
2. حدد إضافة.

VI.E. في قائمة التنقل اليسرى، حدد Deployment Center. ثم قم بما يلي في صفحة Deployment Center:

1. في Authentication، حدد Managed Identity.
2. في Identity، حدد myID.
3. في التوزيع المستمر، حدد تشغيل.
4. حدد حفظ في القائمة العلوية. عند تشغيل النشر المستمر إلى سجل حاوية، تتم إضافة إخطار على الويب تلقائيا إلى السجل لتطبيق الويب الخاص بك.

VI.F. في صفحة Deployment Center، حدد علامة التبويب Logs . هنا، يمكنك مشاهدة رسائل السجل لسحب الصورة وبدء الحاوية. لاحقا، ستتعلم كيفية رؤية رسالة وحدة التحكم التي تم إنشاؤها من داخل الحاوية.

السابعة. استعرض التطبيق

Azure CLI

لاختبار التطبيق، استعرض للوصول إلى https://<app-name>.azurewebsites.net، واستبدله <app-name>باسم تطبيق الويب الخاص بك.

مدخل Microsoft Azure

VII.A. في صفحة خدمة التطبيق:

1. في قائمة التنقل اليسرى، حدد Overview.
2. في URL، حدد الارتباط.

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

الثامن. الوصول إلى سجلات التشخيص

Azure CLI

أثناء انتظارك لسحب App Service للصورة، من المجدي أن ترى بالضبط ما تقوم به App Service عن طريق بث سجلات الحاوية إلى المحطة الطرفية.

1. تشغيل تسجيل الحاويات:

   az webapp log config --name <app-name> --resource-group msdocs-custom-container-tutorial --docker-container-logging filesystem
   

2. قم بتمكين تدفق التسجيل:

   az webapp log tail --name <app-name> --resource-group msdocs-custom-container-tutorial
   

   وفي حال عدم رؤية سجلات وحدة التحكم على الفور، فتحقق مجددًا في غضون 30 ثانية.

   يمكنك أيضا فحص ملفات السجل من المستعرض في https://<app-name>.scm.azurewebsites.net/api/logs/docker.

3. لإيقاف تسجيل التدفق في أي وقت، اكتب Ctrl+C.

مدخل Microsoft Azure

في صفحة Deployment Center، يمكنك بالفعل رؤية رسائل السجل لسحب الحاوية وبدء تشغيلها. في هذه الخطوة، يمكنك تمكين تسجيل إخراج وحدة التحكم من داخل الحاوية.

VIII.A. في صفحة خدمة التطبيق:

1. في قائمة التنقل اليسرى، حدد App Service logs.
2. في Application logging، حدد File System.
3. حدد حفظ.

VIII.B. في قائمة التنقل اليسرى، حدد Log stream. يجب أن تبدأ الآن في رؤية إخراج وحدة تحكم الحاوية في دفق السجل.

التاسع. قم بتعديل رمز التطبيق وإعادة النشر

في هذا القسم، يمكنك إجراء تغيير على رمز تطبيق الويب، وإعادة إنشاء الصورة، ثم دفعها إلى سجل الحاوية. ثم يقوم App Service بسحب الصورة المحدثة تلقائيا من التسجيل لتحديث تطبيق الويب قيد التشغيل.

1. في مجلد docker-django-webapp-linux المحلي، افتح app/templates/app/index.html.

2. تغيير عنصر HTML الأول لمطابقة التعليمات البرمجية التالية.

   <nav class="navbar navbar-inverse navbar-fixed-top">
     <div class="container">
       <div class="navbar-header">
         <a class="navbar-brand" href="#">Azure App Service - Updated Here!</a>
       </div>
     </div>
   </nav>
   

3. احفظ تغييراتك.

4. تغيير إلى مجلد docker-django-webapp-linux وإعادة بناء الصورة:

   docker build --tag appsvc-tutorial-custom-image .
   

5. تحديث علامة الصورة هذه إلى الأحدث:

   docker tag appsvc-tutorial-custom-image <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

   استبدل <registry-name> باسم سجلك.

6. قم بدفع الصورة إلي السجل:

   docker push <registry-name>.azurecr.io/appsvc-tutorial-custom-image:latest
   

7. بمجرد اكتمال دفع الصورة، يقوم خطاف الويب بإعلام App Service عن الدفع، ويحاول App Service سحب الصورة المحدثة لذلك. انتظر بضع دقائق، ثم تحقق من نشر التحديث عن طريق الاستعراض إلى https://<app-name>.azurewebsites.net.

X. قم بالاتصال بالحاوية عن طريق استخدام SSH

تمكن SSH من الاتصال الآمن بين حاوية وعميل. لتمكين اتصال SSH إلى الحاوية الخاصة بك، يجب تكوين الصورة المخصصة الخاصة بك لذلك. بمجرد تشغيل الحاوية، يمكنك فتح اتصال SSH.

تكوين الحاوية لـ SSH

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

ENV SSH_PASSWD "root:Docker!"
RUN apt-get update \
        && apt-get install -y --no-install-recommends dialog \
        && apt-get update \
  && apt-get install -y --no-install-recommends openssh-server \
  && echo "$SSH_PASSWD" | chpasswd 

إشعار

لا يسمح هذا التكوين بالاتصالات الخارجية بالحاوية. SSH متاح فقط من خلال موقع Kudu/SCM. تمت مصادقة موقعKudu/SCM باستخدام حساب Azure الخاص بك. root:Docker! لا ينبغي أن تتغير SSH. سيستخدم SCM/KUDU بيانات اعتماد Azure Portal. سيؤدي تغيير هذه القيمة إلى حدوث خطأ عند استخدام SSH.

كما يقوم Dockerfile بنسخ الملف sshd_config إلى المجلد /etc/ssh/ويعرض المنفذ 2222 على الحاوية:

COPY sshd_config /etc/ssh/

# ...

EXPOSE 8000 2222

المنفذ 2222 هو منفذ داخلي يمكن الوصول إليه فقط بواسطة حاويات ضمن bridge network خاصة بشبكة اتصال ظاهرية خاصة.

وأخيرا، يبدأ البرنامج النصي المدرج init.shملقم SSH.

#!/bin/bash
service ssh start

فتح اتصال SSH بالحاوية

Azure CLI

1. استعرض وقم بالدخول إلى https://<app-name>.scm.azurewebsites.net/webssh/host حساب Azure الخاصة بك. استبدل <app-name> باسم تطبيق الويب.

2. بمجرد تسجيل الدخول، تتم استعادة توجيهك إلى صفحة معلومات لتطبيق الويب. حدد SSH في أعلى الصفحة لفتح واجهات الأوامر واستخدام الأوامر.

   على سبيل المثال، يمكنك فحص العمليات قيد التشغيل داخله باستخدام top الأمر.

مدخل Microsoft Azure

X.A. في صفحة App Service:

1. في قائمة التنقل اليسرى، حدد SSH.
2. حدد Go.

X.B. يتم فتح جلسة SSH في علامة تبويب مستعرض جديدة. انتظر حتى يظهر شريط المعلومات في الأسفل اللون الأخضر SSH CONNECTION ESTABLISHED. يمكنك بعد ذلك تشغيل الأوامر من داخل الحاوية. لا تستمر تغييرات التكوين التي تم إجراؤها على الحاوية الخاصة بك عبر عمليات إعادة تشغيل التطبيق.

الحادي عشر. تنظيف الموارد

Azure CLI

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

az group delete --name msdocs-custom-container-tutorial

مدخل Microsoft Azure

XI.A. في شريط البحث في أعلى مدخل Microsoft Azure:

1. أدخل اسم مجموعة الموارد.
2. حدد مجموعة الموارد.

XI.B. من صفحة «مجموعة الموارد»، حدد حذف مجموعة الموارد.

XI.C.

1. أدخل اسم مجموعة الموارد لتأكيد حذفك.
2. حدد حذف.

:

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

ما تعلمته:

• نشر صورة مخصصة إلى تسجيل حاوية خاصة
• نشر الصورة المخصصة لـ App Service
• تحديث التطبيق وإعادة نشره
• الوصول إلى سجلات التشخيص
• قم بالاتصال بالحاوية عن طريق استخدام SSH

• اضغط على الصورة لإظهار Azure Container Registry
• نشر الصورة المخصصة لـ App Service
• تكوين متغيرات البيئة
• سحب الصورة إلى App Service باستخدام هوية مدارة
• الوصول إلى سجلات التشخيص
• تمكين CI/CD من Azure Container Registry إلى App Service
• قم بالاتصال بالحاوية عن طريق استخدام SSH

في البرنامج التعليمي التالي، ستتعلم كيفية تأمين تطبيقك باستخدام مجال وشهادة مخصصين.

 آمنة مع المجال المخصص والشهادة

أو، يمكنك التحقق من الموارد الأخرى:

تكوين حاوية مخصصة

تكوين sidecar

البرنامج التعليمي: تكوين حاوية sidecar للحاوية المخصصة في Azure App Service (معاينة)