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

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

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

حساب Azure مع اشتراك نشط. إنشاء حساب مجانا.
بايثون 3.14 أو أعلى مثبت محليا.

إشعار

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

يمكنك نشر نموذج التطبيق بسرعة في هذا البرنامج التعليمي باستخدام Azure Developer CLI ورؤيتها قيد التشغيل في Azure. ما عليك سوى تشغيل الأوامر التالية في الرغبة في Azure Cloud Shell، واتبع المطالبة:

mkdir flask-quickstart
cd flask-quickstart
azd init --template https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart
azd up

mkdir django-quickstart
cd django-quickstart
azd init --template https://github.com/Azure-Samples/msdocs-python-django-webapp-quickstart
azd up

mkdir fastapi-quickstart
cd fastapi-quickstart
azd init --template https://github.com/Azure-Samples/msdocs-python-fastapi-webapp-quickstart
azd up

ولحذف الموارد:

azd down

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

يمكن إكمال هذا التشغيل السريع باستخدام إما 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

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

نوافذ
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

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

نوافذ
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

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

نوافذ
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، ثم نشر تطبيقك باستخدام أوامر Azure CLI منفصلة.

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

az login

استبدلها <app-name> باسم فريد عالميا. أنشئ مجموعة موارد وخطة لخدمة التطبيقات، ثم أنشئ تطبيق الويب باستخدام az webapp create.

az group create --name myResourceGroup --location eastus
az appservice plan create --name myAppServicePlan --resource-group myResourceGroup --sku P0v3 --is-linux
az webapp create --name <app-name> --resource-group myResourceGroup --plan myAppServicePlan --runtime "PYTHON:3.14"
az webapp config appsettings set --name <app-name> --resource-group myResourceGroup --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

استخدم المعلمة --runtime لتحديد إصدار Python الذي يشغله تطبيقك. يستخدم هذا المثال Python 3.14. لسرد أوقات تشغيل Python المدعومة، استخدم az webapp list-runtimes --os-type linux --runtime python --output table.
استخدم المعامل --sku لتحديد حجم (وحدة المعالجة المركزية والذاكرة) وتكلفة خطة خدمة التطبيقات. يستخدم هذا المثال خطة خدمة P0v3 (Premium v3)، والتي تتحمل تكلفة في اشتراكك في Azure. للحصول على القائمة الكاملة لخطط خدمة التطبيقات، راجع تسعير خدمة التطبيقات.
استبدلها eastus بالمنطقة التي تفضلها. لسرد المناطق المتاحة، استخدم az account list-locations--output table.
يتيح هذا SCM_DO_BUILD_DURING_DEPLOYMENT الإعداد بناء Oryx، بما في ذلك تثبيت التبعيات في requirements.txt، عند نشر أرشيف المصدر.

أنشئ ملف ZIP يحتوي على ملفات التطبيقات، بما في ذلك requirements.txt، في جذر الأرشيف. استبعد الملفات المحلية مثل .venv و .git و .env. للحصول على تعليمات خاصة بالمنصة، راجع إنشاء ملف ZIP لتطبيقك في قسم النشر باستخدام تبويب ملف ZIP . ثم نشر الأرشيف باستخدام az webapp deploy:

az webapp deploy --name <app-name> --resource-group myResourceGroup --src-path <zip-file-path> --type zip

قد يستغرق النشر بضع دقائق. تصفح لعرض https://<app-name>.azurewebsites.net تطبيقك. لبث السجلات، قم بتفعيلها عن طريق تشغيل az webapp log config --name <app-name> --resource-group myResourceGroup --docker-container-logging filesystem، ثم شغل az webapp log tail --name <app-name> --resource-group myResourceGroup.

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

تنزيل حزمة ملحق أدوات Azure

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

code .

الإرشادات	لقطة شاشة
حدد موقع أيقونة Azure في شريط الأدوات الأيسر. حدده لإحضار Azure Tools لملحق VS Code. إذا لم تشاهد أيقونة أدوات Azure، فتأكد من تثبيت ملحق Azure Tools ل VS Code.
في ملحق Azure Tools ل VS Code: ابحث عن قسم الموارد وحدد اشتراكك. حدد + (إنشاء مورد...)
حدد الخيار Create App Service Web App... .
أدخل اسم msdocs-python-webapp-quickstart-XYZ لتطبيق الويب هذا، حيث XYZ هو أي ثلاثة أحرف فريدة. عند النشر، يتم استخدام هذا الاسم كاسم تطبيقك.
حدد مكدس وقت التشغيل للتطبيق. في هذا المثال، اختر بايثون 3.14.
حدد خطة App Service (مستوى التسعير) لتطبيق الويب هذا. تتحكم خطة App Service في عدد الموارد (وحدة المعالجة المركزية/الذاكرة) المتوفرة لتطبيقك ومقدار ما تدفعه. في هذا المثال، حدد مستوى التسعير الأساسي (B1). ستتحمل هذه الخطة رسوما صغيرة مقابل اشتراك Azure الخاص بك ولكن يوصى بها للحصول على أداء أفضل عبر المستوى المجاني (F1).
حدد الزر Deploy في إعلام "Created new web app".
حدد مجلد التشغيل السريع الذي تعمل فيه كمجلد لنشره.
الإجابة نعم لتحديث تكوين البنية وتحسين أداء النشر.
عند اكتمال النشر، سيظهر إعلام في الزاوية السفلية اليسرى من VS Code. يمكنك استخدام هذا الإعلام للاستعراض وصولا إلى تطبيق الويب الخاص بك.

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

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

هل تواجه مشكلات؟ أخبرنا بذلك.

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

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

أوامر Azure CLI في الخطوة السابقة أنشأت الموارد ونشرت تطبيقك. يمكنك الانتقال إلى الخطوة التالية.

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

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

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

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

مدخل Microsoft Azure
Azure CLI

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

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

باش
محطة 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.

نوافذ
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 لتحميل ونشر ملف مضغوط إلى Azure.

باش
محطة 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، ستحتاج إلى اسم المستخدم وكلمة المرور للتوزيع لخدمة التطبيقات. يمكن الحصول على بيانات الاعتماد هذه من مدخل Microsoft Azure.

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

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

احصل على <عنوان URL> من بيئة Kudu الخاصة بك:

افتح تطبيقك في مدخل Microsoft Azure وحدد أدوات التطوير الأدوات>المتقدمة، ثم حدد Go.
انسخ القيمة من شريط العناوين وإلحاق /api/zipdeploy.

باش
محطة PowerShell الطرفية

curl -X POST \
    -H 'Content-Type: application/zip' \
    -u '<deployment-user>' \
    -T <zip-file-name> \
    <URL>

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

curl -X POST `
    -H 'Content-Type: application/zip' `
    -u '<deployment-user>' `
    -T <zip-file-name> `
    <URL>

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

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

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

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

Python 3.14 وما بعده: تكتشف خدمة التطبيقات تلقائيا تطبيقات FastAPI وتشغلها. لا يتطلب الأمر أمر بدء التشغيل.
Python 3.13 وما قبله: يجب عليك تكوين أمر بدء تشغيل مخصص.

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

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

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

إذا كنت تستخدم Python 3.13 أو أقدم، يجب عليك تكوين أمر بدء تشغيل مخصص لخدمة التطبيقات لتشغيل تطبيقك. الأمر التالي يبدأ غونيكورن بعمليتي عامل Uvicorn: 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

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

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

الإرشادات

لقطة شاشة

إذا كنت تستخدم Python 3.13 أو أقدم، قم بتكوين أمر بدء التشغيل في "Azure App Service". اذهب إلى نسخة خدمة التطبيقات في بوابة Azure.

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

إذا كنت تستخدم Python 3.14 أو أحدث، فلا حاجة لأمر بدء التشغيل.

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

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

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

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

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

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

يقوم نموذج كود 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 .

باش
محطة 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 .

باش
محطة 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: ابحث عن قسم الموارد . حدد أيقونة Group By وحدد Group by Resource Group.
في قائمة الموارد، ابحث عن مجموعة الموارد المراد حذفها، وانقر بزر الماوس الأيمن فوقها، وحدد حذف مجموعة الموارد.... ستتم مطالبتك بتأكيد الحذف عن طريق إدخال اسم مجموعة الموارد في مربع الحوار.

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

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