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

توفر Azure App Service مكدسات تطبيقات محددة مسبقا، مثل ASP.NET أو Node.js، على Windows. تعمل مكدسات التطبيقات هذه على 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

في مربع الحوار Create a new Azure Container Registry ، حدد Add an account، ثم سجل الدخول إلى اشتراك Azure الخاص بك. إذا كنت قد سجلت الدخول بالفعل، فحدد الحساب الذي يحتوي على الاشتراك المطلوب من القائمة المنسدلة.

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

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

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

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

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

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

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

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

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

في علامة التبويب Basics ، قم بتكوين الإعدادات وفقا للجدول التالي. ثم حدد التالي: Docker.

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

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

تكوين حاوية Windows

في علامة التبويب Docker ، قم بتكوين حاوية Windows المخصصة كما هو موضح في الجدول التالي، ثم حدد Review + create.

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

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

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

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

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

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

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

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

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

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

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

قد يستغرق تحميل حاوية Windows القليل من الوقت. للاطلاع على التقدم، انتقل إلى عنوان URL التالي. (استبدل <اسم> التطبيق باسم التطبيق.)

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-64. ARM64 غير مدعوم.

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

• ادفع صورة Docker مخصصة إلى 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 في مجلد اسمه 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 في "عدم وجود مثل هذا الملف أو الدليل"، فإن ملف init.sh يحتوي على نهايات سطر CRLF بدلا من نهايات 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 credential 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. في Admin user، حدد 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 (IAM).
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

V.A. في مدخل 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> بالاسم الذي استخدمته في الخطوة السابقة.

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. لاختبار ما إذا تم تكوين webhook بشكل صحيح، ping webhook ومعرفة ما إذا كان يمكنك الحصول على استجابة 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 المعلمة.

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

مدخل 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. في صفحة App Service:

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

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

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

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. في صفحة App Service:

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. تحديث علامة الصورة إلى latest:

   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. سيؤدي تغيير هذه القيمة إلى حدوث خطأ عند استخدام 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. في صفحة مجموعة الموارد، حدد "Delete resource group".

XI.C.

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

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

ما تعلمته:

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

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

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

 توفير الأمان مع المجال المخصص والشهادة

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

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

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