التشغيل السريع: نشر تطبيق ويب Python (Django أو Flask أو FastAPI) على Azure App Service

مقالة
12/24/2024

إشعار

بدءا من 1 يونيو 2024، يمكن لتطبيقات App Service التي تم إنشاؤها حديثا إنشاء اسم مضيف افتراضي فريد يستخدم اصطلاح <app-name>-<random-hash>.<region>.azurewebsites.netالتسمية . تظل أسماء التطبيقات الحالية دون تغيير. على سبيل المثال:

myapp-ds27dh7271aah175.westus-01.azurewebsites.net

لمزيد من المعلومات، راجع اسم المضيف الافتراضي الفريد لمورد App Service.

في هذا التشغيل السريع، يمكنك نشر تطبيق ويب Python (Django أو Flask أو FastAPI) إلى Azure App Service. Azure App Service هي خدمة استضافة ويب مدارة بالكامل تدعم تطبيقات Python المستضافة في بيئة خادم Linux.

للتشغيل السريع، تحتاج إلى:

حساب Azure مع اشتراك نشط. أنشئ حساباً مجاناً.
تم تثبيت Python 3.9 أو إصدار أحدث محليًا.

إشعار

تحتوي هذه المقالة على إرشادات حالية حول نشر تطبيق ويب Python باستخدام Azure App Service. لم يعد Python على Windows مدعومًا.

عينات التطبيقات

يمكن إكمال هذا التشغيل السريع باستخدام إما Flask أو Django أو FastAPI. يتم توفير نموذج تطبيق في كل إطار عمل لمساعدتك على المتابعة مع هذا التشغيل السريع. قم بتنزيل أو استنساخ نموذج التطبيق إلى محطة العمل المحلية الخاصة بك.

git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart

git clone https://github.com/Azure-Samples/msdocs-python-django-webapp-quickstart

git clone https://github.com/Azure-Samples/msdocs-python-fastapi-webapp-quickstart.git

لتشغيل التطبيق محليًا:

انتقل إلى مجلد التطبيق:

cd msdocs-python-flask-webapp-quickstart

إنشاء بيئة ظـاهرية للتطبيق:

Windows
macOS/Linux

py -m venv .venv
.venv\scripts\activate

python3 -m venv .venv
source .venv/bin/activate

تثبيت تأمينات التشغيل:
```
pip install -r requirements.txt
```
تشغيل التطبيق:
```
flask run
```
استعرض للوصول إلى نموذج التطبيق في http://localhost:5000 في مستعرض ويب.

هل تواجه مشكلات؟ أبلغنا بها.

انتقل إلى مجلد التطبيق:

cd msdocs-python-django-webapp-quickstart

إنشاء بيئة ظـاهرية للتطبيق:

Windows
macOS/Linux

py -m venv .venv
.venv\scripts\activate

python3 -m venv .venv
source .venv/bin/activate

تثبيت تأمينات التشغيل:
```
pip install -r requirements.txt
```
تشغيل التطبيق:
```
python manage.py runserver
```
استعرض للوصول إلى نموذج التطبيق في http://localhost:8000 في مستعرض ويب.

هل تواجه مشكلات؟ أبلغنا بها.

انتقل إلى مجلد التطبيق:

cd msdocs-python-fastapi-webapp-quickstart

إنشاء بيئة ظـاهرية للتطبيق:

Windows
macOS/Linux

py -m venv .venv
.venv\scripts\activate

python3 -m venv .venv
source .venv/bin/activate

تثبيت تأمينات التشغيل:
```
pip install -r requirements.txt
```
تشغيل التطبيق:
```
uvicorn main:app --reload
```
استعرض للوصول إلى نموذج التطبيق في http://localhost:8000 في مستعرض ويب.

هل تواجه مشكلات؟ أبلغنا بها.

إنشاء تطبيق ويب في Azure

لاستضافة التطبيق الخاص بك في Azure، تحتاج إلى إنشاء تطبيق ويب Azure App Service في Azure. يمكنك إنشاء تطبيق ويب باستخدام Azure CLI أو VS Code أو حزمة ملحق Azure Tools أو مدخل Microsoft Azure.

يمكن تشغيل أوامر Azure CLI على جهاز كمبيوتر مثبتة عليه Azure CLI.

تحتوي واجهة سطر الأوامر في Azure على أمر az webapp up ينشئ الموارد اللازمة ويوزع تطبيقك في خطوة واحدة.

إذا لزم الأمر، قم بتسجيل الدخول إلى Azure باستخدام az login.

az login

أنشئ تطبيق الويب والموارد الأخرى، ثم انشر التعليمات البرمجية الخاصة بك إلى Azure باستخدام az webapp up.

az webapp up --runtime PYTHON:3.9 --sku B1 --logs

تحدد المعلمة --runtime إصدار Python الذي يعمل عليه تطبيقك. يـستخدم هذا المثال Python 3.9. لسرد جميع أوقات التشغيل المُتوفرة، استخدم الأمر az webapp list-runtimes --os linux --output table.
تحدد المعلمة --sku الحجم (وحدة المعالجة المركزية والذاكرة) وتكلفة خطة خدمة التطبيق. يستخدم هذا المثال خطة خدمة B1 (الأساسية)، والتي سوف تتحمل تكلفة صغيرة في اشتراك Azure الخاص بك. للحصول على قائمة كاملة بخطط App Service، اعرض صفحة تسعير App Service.
تقوم العلامة --logs بتكوين التسجيل الافتراضي المطلوب لتمكين عرض دفق السجل مباشرة بعد تشغيل تطبيق الويب.
يمكنك اختياريًا تحديد اسم باستخدام الوسيطة --name <app-name>. إذا لم توفر اسمًا، فسوف يُنشأ اسم تلقائيًا.
يمكنك تضمين اختياريا حجة --location <location-name>حيث<location_name> هو المنطقة Azure المتاحة. يمكنك استرداد قائمة المناطق المسموح بها لحساب Azure الخاص بك عن طريق تشغيل الأمر az appservice list-locations.

قد يستغرق الأمر بضع دقائق حتى يكتمل. في أثناء تشغيل الأمر، فإنه يوفر رسائل حول إنشاء مجموعة الموارد وخطة App Service ومورد التطبيق وتكوين التسجيل والقيام بنشر ZIP. ثم يعطي الرسالة، "يمكنك تشغيل التطبيق على http://<app-name>.azurewebsites.net"، وهو عنوان URL للتطبيق على Azure.

The webapp '<app-name>' doesn't exist
Creating Resource group '<group-name>' ...
Resource group creation complete
Creating AppServicePlan '<app-service-plan-name>' ...
Creating webapp '<app-name>' ...
Configuring default logging for the app, if not already enabled
Creating zip with contents of dir /home/cephas/myExpressApp ...
Getting scm site credentials for zip deployment
Starting zip deployment. This operation can take a while to complete ...
Deployment endpoint responded with status code 202
You can launch the app at http://<app-name>.azurewebsites.net
{
  "URL": "http://<app-name>.azurewebsites.net",
  "appserviceplan": "<app-service-plan-name>",
  "location": "centralus",
  "name": "<app-name>",
  "os": "<os-type>",
  "resourcegroup": "<group-name>",
  "runtime_version": "python|3.9",
  "runtime_version_detected": "0.0",
  "sku": "FREE",
  "src_path": "<your-folder-location>"
}

إشعار

يقومaz webapp upالأمر بالإجراءات التالية:

إنشاء مجموعة موارد⁩ افتراضية.
إنشاء خطة App Service افتراضية.
إنشاء تطبيق بالاسم المحدد.
توزيع كل الملفات مضغوطة من دليل المشغّل الحالي، مع تمكين أتمتة الإصدار.
قم بتخزين المعلمات مؤقتًا محليًا في ملف .azure/config بحيث لا تحتاج إلى تحديدها مرة أخرى عند النشر لاحقًا باستخدام az webapp up أو أوامر az webapp الأخرى من مجلد المشروع. يتم استخدام القيم المخزنة مؤقتاً تلقائياً بشكل افتراضي.

لإنشاء موارد Azure في VS Code، يجب أن يكون لديك حزمة ملحق أدوات Azure مُثبتة وأن يتم تسجيل الدخول إلى Azure من VS Code.

تنزيل حزمة مُلحق Azure Tools

في مجلد التطبيق، افتح VS Code:

code .

الإرشادات	لقطة شاشة
حدد موقع أيقونة Azure في شريط الأدوات الأيمن. حددها لإظهار ملحق Azure Tools لـ VS Code. إذا لم تجد أيقونة Azure Tools، فتأكد من تثبيت ملحق Azure Tools لـ VS Code.
في ملحق Azure Tools ل VS Code: ابحث عن قسم الموارد وحدد اشتراكك. حدد + (إنشاء مورد...)
اختر الخيار إنشاء تطبيق ويب App Service....
أدخل اسم msdocs-python-webapp-quickstart-XYZ لتطبيق الويب هذا، حيث XYZ هو أي ثلاثة أحرف فريدة. عند النشر، يتم استخدام هذا الاسم كاسم تطبيقك في النموذج `https://<app-name>.azurewebsites.net`.
حَدد مكدس وقت التشغيل للتطبيق. في هذا المثال، حدد Python 3.9.
حدد خطة App Service (طبقة الأسعار) لتطبيق الويب هذا. تتحكم خطة App Service في عدد الموارد (CPU/الذاكرة) المتوفرة لتطبيقك ومقدار ما تدفعه. في هذا المثال، حدد طبقة الأسعار الأساسية (B1). ستتحمل هذه الخطة رسومًا بسيطة مقابل اشتراك Azure الخاص بك، ولكن يوصى بها للحصول على أداء أفضل من الطبقة المجانية (F1).
حدد الزر نشر في إشعار «إنشاء تطبيق ويب جديد».
حدد مجلد التشغيل السريع الذي تعمل فيه باعتباره المجلد الذي تريد نشره.
حدد نعم لتحديث تكوين الإنشاء وتحسين أداء النشر.
عند اكتمال النشر، سيظهر إعلام في الزاوية السفلية اليمنى من VS Code. يمكنك استخدام هذا الإعلام للاستعراض وصولاً إلى تطبيق الويب الخاص بك.

سجّل الدخول إلى مدخل Azure واتبع هذه الخطوات لإنشاء مورد Azure App Service.

الإرشادات	لقطة شاشة
في مدخل Microsoft Azure: أدخل خدمات التطبيقات في شـريط البحث في أعلى مدخل Microsoft Azure. حدد العنصر المسمى App Services ضمن العنوان Services في القائمة التي تظهر أسفل شريط البحث.
في صفحة App Services ، حدد + Create، ثم حدد + Web App من القائمة المنسدلة.
في صفحة إنشاء تطبيق ويب، املأ النموذج كما يلي. مجموعة الموارد → حدد إنشاء جديد واستخدم اسم msdocs-python-webapp-quickstart. الاسم → msdocs-python-webapp-quickstart-XYZ حيث XYZ هي أي ثلاثة أحرف عشوائية. يجب أن يكون هذا الاسم فريدا عبر Azure. مكدس وقت التشغيل → Python 3.9. المنطقة → أي منطقة Azure قريبة منك. خطة خدمة التطبيقات → ضمن خطة التسعير، حدد استكشاف خطط التسعير لتحديد خطة App Service مختلفة.
تتحكم خطة App Service في مقدار الموارد (وحدة المعالجة المركزية/الذاكرة) المتوفرة لتطبيقك وتكلفة هذه الموارد. على سبيل المثال، ضمن Dev/Test، حدد خطة Basic B1 . ستتحمل خطة B1 الأساسية رسوما صغيرة على حساب Azure الخاص بك ولكن يوصى بها للحصول على أداء أفضل عبر خطة F1 المجانية. عند الانتهاء، حدد تحديد لتطبيق التغييرات.
في صفحة إنشاء تطبيق الويب الرئيسية، حدد مراجعة + إنشاء في الجزء السفلي من الشاشة. سوف ينقلك هذا إلى صفحة المراجعة. حَدد إنشاء لإنشاء مورد App Service خاصتك.

هل تواجه مشكلات؟ أبلغنا بها.

نشر التعليمات البرمجية للتطبيق الخاص بك إلى Azure

تدعم Azure App Service أساليب متعددة لنشر التعليمات البرمجية للتطبيق الخاص بك إلى Azure، بما في ذلك إجراءات GitHub وجميع أدوات CI/CD الرئيسية. تركز هذه المقالة على كيفية نشر التعليمات البرمجية من محطة العمل المَحلية إلى Azure.

az webapp up نظرا لأن الأمر أنشأ الموارد الضرورية ووزع التطبيق الخاص بك في خطوة واحدة، يمكنك الانتقال إلى الخطوة التالية.

يمكن توزيع التطبيقات إلى Azure عن طريق إنشاء ملف ZIP من التعليمات البرمجية للتطبيق وتحميله إلى Azure. يمكن تحميل ملفات ZIP إلى Azure باستخدام Azure CLI أو عميل HTTP مثل cURL.

تمكين أتـمتة الإنشاء

عند نشر ملف ZIP للتعليمات البرمجية لـ Python، تحتاج إلى تعيين علامة لتمكين أتمتة إنشاء Azure. سوف تقوم أتمتة البناء بتثبيت أي متطلبات ضرورية وحزم التطبيق للتشغيل على Azure.

يتم تمكين أتمتة الإنشاء في Azure عن طريق تعيين SCM_DO_BUILD_DURING_DEPLOYMENT إعداد التطبيق إما في مدخل Microsoft Azure أو Azure CLI.

مدخل Microsoft Azure
Azure CLI

الإرشادات	لقطة شاشة
في صفحة تطبيق الويب في مدخل Microsoft Azure: حـدد Configuration ضمن عنوان الإعدادات في شريط الأدوات الأيسر لإظهار إعدادات التطبيق. في Application settings، حددNew application setting.
باستخدام مربع الحوار، أدخل إعدادا جديدا بـاستخدام: الاسم → SCM_DO_BUILD_DURING_DEPLOYMENT القيمة → صحيحة
حدد حفظ لحفظ الإعدادات.

استخدم الأمر az webapp config appsettings set لتعيين الإعداد SCM_DO_BUILD_DURING_DEPLOYMENT على قيمة true.

bash
محطة PowerShell الطرفية

# Change these values to the ones used to create the App Service.
RESOURCE_GROUP_NAME='msdocs-python-webapp-quickstart'
APP_SERVICE_NAME='msdocs-python-webapp-quickstart-123'

az webapp config appsettings set \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $APP_SERVICE_NAME \
    --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

# Change these values to the ones used to create the App Service.
$resourceGroupName='msdocs-python-webapp-quickstart'
$appServiceName='msdocs-python-webapp-quickstart-123'

az webapp config appsettings set `
    --resource-group $resourceGroupName `
    --name $appServiceName `
    --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

أنشئ ملف ZIP للتطبيق الخاص بك

بـعد ذلك، قم بإنشاء ملف ZIP للتطبيق الخاص بك. تحتاج فقط إلـى تضمين مكونات التطبيق نفسه. لا تحتاج إلى تضمين أي مـلفات أو أدلة تبدأ بنقطة (.) مثل .venvأو .gitignoreأو.githubأو.vscode.

Windows
macOS/Linux

في Windows، استخدم برنامجًا مثل 7-Zip لإنشاء ملف ZIP مطلوب لنشر التطبيق.

في macOS أو Linux، يمكنك استخدام الأداة المساعدة المضمنة zip لإنشاء ملف ZIP.

zip -r <file-name>.zip . -x '.??*'

حمّل ملف ZIP إلى Azure

بمجرد أن يكون لديك ملف ZIP، يمكن تحميل الملف إلى Azure باستخدام إما Azure CLI أو عميل HTTP مثل cURL.

Azure CLI
حليقه

يمكن استخدام الأمر az webapp deploy لتحميل ملف zip ونشره إلى Azure.

bash
محطة PowerShell الطرفية

# Change these values to the ones used to create the App Service.
RESOURCE_GROUP_NAME='msdocs-python-webapp-quickstart'
APP_SERVICE_NAME='msdocs-python-webapp-quickstart-123'

az webapp deploy \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME \
    --src-path <zip-file-path>

# Change these values to the ones used to create the App Service.
$resourceGroupName='msdocs-python-webapp-quickstart'
$appServiceName='msdocs-python-webapp-quickstart-123'

az webapp deploy `
    --name $appServiceName `
    --resource-group $resourceGroupName `
    --src-path <zip-file-path>

لاستخدام cURL من أجل تحميل ملف ZIP إلى Azure، ستحتاج إلى اسم المستخدم وكلمة المرور للنشر لـ App Service. يُمكن الحصول على بيانات الاعتماد هذه من مدخل Microsoft Azure.

فـي صفحة تطبيق الويب، حدد مركز النشر من القائمة الموجودة على الجانب الأيمن من الصفحة.
حـدد علامة التبويب بيانات اعتماد FTPS.
يتم عرض اسم المستخدموكلمة المرور ضمن عنوان نطاق التطبيق. بالنسبة إلى عمليات نشر ملف zip، استخدم فقط جزء اسم المستخدم بعد الحرف \ الذي يبدأ بـ $، على سبيل المثال $msdocs-python-webapp-quickstart-123. سوف تكون بيانات الاعتماد هذه مطلوبة في الأمر cURL.

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

bash
محطة PowerShell الطرفية

curl -X POST \
    -H 'Content-Type: application/zip' \
    -u '<deployment-user>' \
    -T <zip-file-name> \
    https://<app-name>.scm.azurewebsites.net/api/zipdeploy

بالنسبة إلى PowerShell، تأكد من إحاطة اسم المستخدم بعلامات اقتباس مفردة حتى لا يحاول PowerShell تفسير اسم المستخدم كمتغير PowerShell.

curl -X POST `
    -H 'Content-Type: application/zip' `
    -u '<deployment-user>' `
    -T <zip-file-name> `
    https://<app-name>.scm.azurewebsites.net/api/zipdeploy

بناءً على النطاق الترددي لشبكتك، تستغرق الملفات عادةً ما بين 10 و30 ثانية لتحميلها إلى Azure.

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

تكوين البرنامج النصي لبدء التشغيل

استنادا إلى وجود ملفات معينة في عملية نشر، تكتشف App Service تلقائيا ما إذا كان التطبيق هو تطبيق Django أو Flask وتنفذ الخطوات الافتراضية لتشغيل تطبيقك. بالنسبة للتطبيقات المستندة إلى أطر عمل الويب الأخرى مثل FastAPI، تحتاج إلى تكوين برنامج نصي لبدء التشغيل لخدمة التطبيقات لتشغيل تطبيقك؛ وإلا، تقوم App Service بتشغيل تطبيق افتراضي للقراءة فقط موجود في مجلد opt/defaultsite .

لمعرفة المزيد حول كيفية تشغيل App Service لتطبيقات Python وكيفية تكوين سلوكها وتخصيصه مع تطبيقك، راجع تكوين تطبيق Linux Python لخدمة تطبيقات Azure.

تكتشف App Service تلقائيا وجود تطبيق Flask. لا يلزم تكوين إضافي لبدء التشغيل السريع هذا.

بالنسبة إلى FastAPI، يجب تكوين أمر بدء تشغيل مخصص لخدمة التطبيقات لتشغيل تطبيقك. يبدأ الأمر التالي Gunicorn بعمليات عامل Uvicorn 2: gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.

أولا، قم بتكوين أمر بدء التشغيل باستخدام الأمر az webapp config set .

az webapp config set \
    --startup-file "gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app" \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

بعد ذلك، أعد تشغيل تطبيق الويب باستخدام الأمر az webapp restart .

az webapp restart \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

الإرشادات	لقطة شاشة
أولا، قم بتكوين أمر بدء التشغيل في Azure App Service. انتقل إلى صفحة مثيل App Service فـي مدخل Microsoft Azure. حدد Configuration ضمن عنوان Settings في القائمة على الجانب الأيمن من الصفحة. تأكد من تحديد علامة التبويب الإعدادات العامة. في حقل "Startup Command "، أدخل gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app. حدد حفظ لحفظ التغييرات الخاصة بك. انتظر الإعلام الذي يفيد بتحديث الإعدادات قبل المتابعة.
بعد ذلك، أعد تشغيل تطبيق الويب. حدد نظرة عامة في القائمة على الجانب الأيسر من الصفحة. في القائمة العلوية، حدد إعادة التشغيل.

الإرشادات

لقطة شاشة

أولا، قم بتكوين أمر بدء التشغيل في Azure App Service. انتقل إلى صفحة مثيل App Service فـي مدخل Microsoft Azure.

حدد Configuration ضمن عنوان Settings في القائمة على الجانب الأيمن من الصفحة.
تأكد من تحديد علامة التبويب الإعدادات العامة.
في حقل "Startup Command "، أدخل gunicorn -w 2 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 main:app.
حدد حفظ لحفظ التغييرات الخاصة بك.
انتظر الإعلام الذي يفيد بتحديث الإعدادات قبل المتابعة.

لقطة شاشة للموقع في مدخل Microsoft Azure حيث يتم تكوين أمر بدء التشغيل.

بعد ذلك، أعد تشغيل تطبيق الويب.

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

لقطة شاشة لكيفية إعادة تعيين تطبيق الويب في مدخل Microsoft Azure.

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

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

يقوم نموذج كود Python بتشغيل حاوية Linux في خدمة التطبيقات باستخدام صورة مضمنة.

لقطة شاشة للتطبيق قيد التشغيل في Azure

تهانينا! لقد قمت بنشر تطبيق Python الخاص بك في خدمة التطبيقات.

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

سجلات التدفق

تسجل Azure App Service جميع مخرجات الرسائل إلى وحدة التحكم لمساعدتك في تشخيص المشكلات المتعلقة بتطبيقك. تتضمن نماذج التطبيقات عبارات print() لتوضيح هذه الإمكانية.

@app.route('/')
def index():
   print('Request for index page received')
   return render_template('index.html')

@app.route('/favicon.ico')
def favicon():
    return send_from_directory(os.path.join(app.root_path, 'static'),
                               'favicon.ico', mimetype='image/vnd.microsoft.icon')

@app.route('/hello', methods=['POST'])
def hello():
   name = request.form.get('name')

   if name:
       print('Request for hello page received with name=%s' % name)
       return render_template('hello.html', name = name)
   else:
       print('Request for hello page received with no name or blank name -- redirecting')
       return redirect(url_for('index'))

def index(request):
    print('Request for index page received')
    return render(request, 'hello_azure/index.html')

@csrf_exempt
def hello(request):
    if request.method == 'POST':
        name = request.POST.get('name')
        
        if name is None or name == '':
            print("Request for hello page received with no name or blank name -- redirecting")
            return redirect('index')
        else:
            print("Request for hello page received with name=%s" % name)
            context = {'name': name }
            return render(request, 'hello_azure/hello.html', context)
    else:

@app.get("/", response_class=HTMLResponse)
async def index(request: Request):
    print('Request for index page received')
    return templates.TemplateResponse('index.html', {"request": request})

@app.get('/favicon.ico')
async def favicon():
    file_name = 'favicon.ico'
    file_path = './static/' + file_name
    return FileResponse(path=file_path, headers={'mimetype': 'image/vnd.microsoft.icon'})

@app.post('/hello', response_class=HTMLResponse)
async def hello(request: Request, name: str = Form(...)):
    if name:
        print('Request for hello page received with name=%s' % name)
        return templates.TemplateResponse('hello.html', {"request": request, 'name':name})
    else:
        print('Request for hello page received with no name or blank name -- redirecting')
        return RedirectResponse(request.url_for("index"), status_code=status.HTTP_302_FOUND)

يمكنك مراجعة محتويات سجلات تشخيص App Service باستخدام Azure CLI أو VS Code أو مدخل Microsoft Azure.

أولا، تحتاج إلى تكوين Azure App Service لإخراج السجلات إلى نظام ملفات App Service باستخدام الأمر az webapp log config .

bash
محطة PowerShell الطرفية

az webapp log config \
    --web-server-logging filesystem \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

az webapp log config `
    --web-server-logging 'filesystem' `
    --name $APP_SERVICE_NAME `
    --resource-group $RESOURCE_GROUP_NAME

لدفق السجلات، استخدم الأمر az webapp log tail.

bash
محطة PowerShell الطرفية

az webapp log tail \
    --name $APP_SERVICE_NAME \
    --resource-group $RESOURCE_GROUP_NAME

az webapp log tail `
    --name $APP_SERVICE_NAME `
    --resource-group $RESOURCE_GROUP_NAME

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

Starting Live Log Stream ---

2021-12-23T02:15:52.740703322Z Request for index page received
2021-12-23T02:15:52.740740222Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET / HTTP/1.1" 200 1360 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:52.841043070Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET /static/bootstrap/css/bootstrap.min.css HTTP/1.1" 200 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:52.884541951Z 169.254.130.1 - - [23/Dec/2021:02:15:52 +0000] "GET /static/images/azure-icon.svg HTTP/1.1" 200 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:15:53.043211176Z 169.254.130.1 - - [23/Dec/2021:02:15:53 +0000] "GET /favicon.ico HTTP/1.1" 404 232 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"

2021-12-23T02:16:01.304306845Z Request for hello page received with name=David
2021-12-23T02:16:01.304335945Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "POST /hello HTTP/1.1" 200 695 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.398399251Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "GET /static/bootstrap/css/bootstrap.min.css HTTP/1.1" 304 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"
2021-12-23T02:16:01.430740060Z 169.254.130.1 - - [23/Dec/2021:02:16:01 +0000] "GET /static/images/azure-icon.svg HTTP/1.1" 304 0 "https://msdocs-python-webapp-quickstart-123.azurewebsites.net/hello" "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:95.0) Gecko/20100101 Firefox/95.0"

الإرشادات	لقطة شاشة
أولًا، تحتاج إلى تمكين سجلات الدفق في Azure App Service. في قسم App Service في مُلحق Azure Tools for VS Code، انقر بزر الماوس الأيمن فوق مثيل App Service وحدد Start Streaming Logs من القائمة.
تظهر سجلات وحدة التحكم في نافذة VS Code Output. تحديث الصفحة الرئيسية في التطبيق أو مُحاولة طلبات أخرى لإنشاء بعض رسائل السجل. سترى أي رسائل سجل تم إنشاؤها بواسطة تطبيقك بالإضافة إلى الرسائل الأخرى التي تم إنشاؤها بواسطة الخدمة في الإخراج.

الإرشادات

لقطة شاشة

أولًا، تحتاج إلى تمكين سجلات الدفق في Azure App Service.

في قسم App Service في مُلحق Azure Tools for VS Code، انقر بزر الماوس الأيمن فوق مثيل App Service وحدد Start Streaming Logs من القائمة.

تظهر سجلات وحدة التحكم في نافذة VS Code Output. تحديث الصفحة الرئيسية في التطبيق أو مُحاولة طلبات أخرى لإنشاء بعض رسائل السجل.

سترى أي رسائل سجل تم إنشاؤها بواسطة تطبيقك بالإضافة إلى الرسائل الأخرى التي تم إنشاؤها بواسطة الخدمة في الإخراج.

الإرشادات	لقطة شاشة
أولًا، تحتاج إلى تمكين سجلات الدفق في Azure App Service. انتقل إلى صفحة مثيل App Service فـي مدخل Microsoft Azure. حدد App Service logs ضمن عنوان Monitoring في القائمة على الجانب الأيمن من الصفحة. تغيير خاصية تسجيل التطبيق من إيقاف إلىنظام الملفات. أدخل فترة استبقاء 30 يومًا للسجلات. حدد حفظ لحفظ التغييرات الخاصة بك.
حدد Log stream من قسم Monitoring في جزء التنقل على اليسار. تحديث الصفحة الرئيسية في التطبيق أو مُحاولة طلبات أخرى لإنشاء بعض رسائل السجل. سترى أي رسائل سجل تم إنشاؤها بواسطة التطبيق والرسائل التي تم إنشاؤها بواسطة الخدمة في الإخراج.

الإرشادات

لقطة شاشة

أولًا، تحتاج إلى تمكين سجلات الدفق في Azure App Service. انتقل إلى صفحة مثيل App Service فـي مدخل Microsoft Azure.

حدد App Service logs ضمن عنوان Monitoring في القائمة على الجانب الأيمن من الصفحة.
تغيير خاصية تسجيل التطبيق من إيقاف إلىنظام الملفات.
أدخل فترة استبقاء 30 يومًا للسجلات.
حدد حفظ لحفظ التغييرات الخاصة بك.

لقطة شاشة للموقع في مدخل Microsoft Azure حيث تقوم بتمكين سجلات الدفق.

حدد Log stream من قسم Monitoring في جزء التنقل على اليسار. تحديث الصفحة الرئيسية في التطبيق أو مُحاولة طلبات أخرى لإنشاء بعض رسائل السجل.

سترى أي رسائل سجل تم إنشاؤها بواسطة التطبيق والرسائل التي تم إنشاؤها بواسطة الخدمة في الإخراج.

لقطة شاشة لكيفية عرض السجلات في مدخل Microsoft Azure.

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

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

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

احذف مجموعة موارد باستخدام أمر az group delete.

az group delete \
    --name msdocs-python-webapp-quickstart \
    --no-wait

تسمح الوسيطة --no-wait للأمر بالعودة قبل اكتمال العملية.

الإرشادات	لقطة شاشة
في ملحق Azure Tools ل VS Code: ابحث عن قسم الموارد. حدد أيقونة تجميع حسب وحدد تجميع حسب مجموعة الموارد.
في قائمة الموارد، ابحث عن مجموعة الموارد المراد حذفها، وانقر بزر الماوس الأيمن فوقها، وحدد حذف مجموعة الموارد.... ستتم مطالبتك بتأكيد الحذف عن طريق إدخال اسم مجموعة الموارد في مربع الحوار.

اتبع هذه الخطوات أثناء تسجيل الدخول إلى مدخل Microsoft Azure لحذف مَجموعة موارد.

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