Deploy files to "Azure App Service"

توضح لك هذه المقالة كيفية نشر كودك كحزمة ZIP أو WAR أو JAR أو EAR إلى "Azure App Service". كما يوضح لك كيفية نشر الملفات الفردية إلى App Service، بشكل منفصل عن حزمة التطبيق.

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

لإكمال الخطوات الواردة في هذه المقالة، قم بإنشاء تطبيق App Service، أو استخدم تطبيقا قمت بإنشائه لبرنامج تعليمي آخر.

إذا لم يكن لديك حساب Azure، أنشئ حسابا مجاني قبل أن تبدأ.

إنشاء حزمة ZIP للمشروع

هام

عند إنشاء حزمة ZIP للنشر، لا تقم بتضمين الدليل الجذر. قم بتضمين الملفات والدلائل فقط في الدليل الجذر. إذا قمت بتحميل مستودع GitHub كملف ZIP، فلا يمكنك نشر ذلك الملف as-is إلى App Service. يضيف GitHub أدلة متداخلة في المستوى الأعلى، وهذا لا يعمل مع App Service.

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

يجب أن يحتوي هذا الدليل على ملف الإدخال إلى تطبيق الويب الخاص بك، مثل index.htmlو index.phpو.app.js يمكن أن يحتوي أيضا على ملفات إدارة الحزم مثل project.jsonوcomposer.jsonpackage.jsonbower.json.requirements.txt

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

أنشئ أرشيف ZIP من كل شيء في المشروع الخاص بك. بالنسبة dotnet للمشاريع، أضف كل شيء في دليل dotnet publish الإخراج للأمر، باستثناء دليل الإخراج نفسه. على سبيل المثال، أدخل الأمر التالي في المحطة الطرفية لإنشاء حزمة ZIP تتضمن محتويات الدليل الحالي:

# Bash
zip -r <file-name>.zip .

# PowerShell
Compress-Archive -Path * -DestinationPath <file-name>.zip

نشر حزمة ZIP

عند نشر حزمة ZIP، تقوم خدمة التطبيقات بفك محتوياتها في المسار الافتراضي لتطبيقك: D:\home\site\wwwroot ل Windows و /home/site/wwwroot للينكس.

يستخدم نشر حزمة ZIP هذه نفس خدمة Kudu التي تعمل على تشغيل عمليات النشر المستمرة المستندة إلى التكامل. يدعم Kudu الوظائف التالية لنشر حزمة ZIP:

• حذف الملفات المتبقية من عملية نشر سابقة
• خيار تشغيل عملية الإنشاء الافتراضية، والتي تتضمن استعادة الحزمة
• تخصيص التوزيع، بما في ذلك تشغيل البرامج النصية للتوزيع
• سجلات التوزيع
• حد حجم الحزمة 2048 ميغابايت

ملاحظة

الملفات في حزمة ZIP تنسخ فقط إذا لم تتطابق طوابعها الزمنية مع ما تم نشره بالفعل.

النشر باستخدام واجهة مستخدم نشر ZIP في Kudu

1. افتح تطبيقك في بوابة Azure واختر Development Tools>Advanced Tools، ثم اختر Go.
2. في Kudu، حدد Tools>Zip Push Deploy.
3. قم بتحميل حزمة ZIP التي أنشأتها في إنشاء حزمة ZIP لمشروع. اسحبه إلى منطقة مستكشف الملفات على صفحة الويب.

عندما يكون النشر قيد التقدم، تظهر لك أيقونة في الزاوية العلوية اليسرى النسبة المئوية للتقدم. تعرض الصفحة أيضا رسائل للعملية أسفل منطقة مستكشف الملفات . عند انتهاء النشر، يجب أن تقول الرسالة الأخيرة "Deployment successful".

هذه النقطة النهائية لا تعمل على App Service on Linux في الوقت الحالي. ضع في اعتبارك استخدام FTP أو ZIP deploy API بدلا من ذلك.

نشر بدون واجهة مستخدم نشر ZIP في Kudu

نشر حزمة ZIP إلى تطبيق الويب الخاص بك باستخدام az webapp deploy الأمر . يستخدم أمر CLI Kudu publish API لنشر الملفات ويمكن تخصيصه بالكامل.

يدفع المثال التالي حزمة ZIP إلى موقعك. حدد المسار إلى حزمة ZIP المحلية ل --src-path.

az webapp deploy --resource-group <group-name> --name <app-name> --src-path <zip-package-path>

يعيد هذا الأمر تشغيل التطبيق بعد نشر حزمة ZIP.

Azure PowerShell

يستخدم Publish-AzWebapp المثال التالي لتحميل حزمة ZIP. استبدل العناصر النائبة لمجموعة الموارد واسم التطبيق ومسار الحزمة.

Publish-AzWebApp -ResourceGroupName Default-Web-WestUS -Name MyApp -ArchivePath <zip-package-path> 

واجهة برمجة تطبيقات Kudu

يستخدم المثال التالي أداة عنوان URL للعميل (cURL) لنشر حزمة ZIP. إذا اخترت المصادقة الأساسية، فقم بتوفير بيانات اعتماد النشر في <اسم المستخدم>وكلمة< المرور>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<zip-package-path>" \
     "https://<URL>/api/publish?type=zip"

# Basic authentication
curl -X POST \
     -u '<username>:<password>' \
     -T "<zip-package-path>" \
     "https://<URL>/api/publish?type=zip"

ملاحظة

احصل على رابط Kudu من بوابة Azure: افتح تطبيقك واختر Development Tools>Advanced Tools، ثم اختر Go لفتح رابط Kudu.

قالب ARM

تدعم قوالب Azure Resource Manager (قوالب ARM) فقط النشر من الحزم المستضافة عن بعد.

تمكين أتمتة البناء لنشر ZIP

بشكل افتراضي، يفترض محرك التوزيع أن حزمة ZIP جاهزة للتشغيل as-is ولا تشغل أي أتمتة للبناء. لتمكين نفس أتمتة البناء المستخدمة في نشر Git، قم بتعيين SCM_DO_BUILD_DURING_DEPLOYMENT إعداد التطبيق. شغل الأمر التالي في Azure Cloud Shell:

az webapp config appsettings set --resource-group <group-name> --name <app-name> --settings SCM_DO_BUILD_DURING_DEPLOYMENT=true

لمزيد من المعلومات، راجع وثائق Kudu.

نشر حزم WAR أو JAR أو EAR

يمكنك نشر حزمة WAR، JAR، أو حزمة EAR إلى خدمة التطبيقات لتشغيل تطبيق الويب Java باستخدام واجهة برمجة التطبيقات Azure CLI أو PowerShell أو Kudu.

تضع عملية النشر الموضحة هنا الحزمة على مشاركة محتوى التطبيق مع اصطلاح التسمية الصحيح وبنية الدليل. لمزيد من المعلومات، راجع مرجع Kudu publish API. نوصي بهذا النهج. إذا قمت بنشر حزم WAR أو JAR أو EAR باستخدام FTP أو Web Deploy بدلا من ذلك، فقد ترى حالات فشل غير معروفة بسبب أخطاء في التسمية أو البنية.

نشر حزمة WAR إلى Tomcat أو JBoss EAP باستخدام az webapp deploy الأمر . حدد المسار إلى حزمة Java المحلية الخاصة بك ل --src-path.

az webapp deploy --resource-group <group-name> --name <app-name> --src-path ./<package-name>.war

يستخدم أمر CLI Kudu publish API لنشر الحزمة ويمكن تخصيصه بالكامل.

Azure PowerShell

يستخدم Publish-AzWebapp المثال التالي لتحميل ملف WAR. استبدل العناصر النائبة لمجموعة الموارد واسم التطبيق ومسار الحزمة. يدعم Azure PowerShell فقط ملفات WAR و JAR.

Publish-AzWebapp -ResourceGroupName <group-name> -Name <app-name> -ArchivePath <package-path>

واجهة برمجة تطبيقات Kudu

يستخدم المثال التالي أداة cURL لنشر ملف WAR أو JAR أو EAR. استبدل مسار< ملف العناصر النائبة>ونوع<> الحزمة (warأو jarأو ear). إذا اخترت المصادقة الأساسية، فقم بتوفير بيانات اعتماد النشر في <اسم المستخدم>وكلمة< المرور>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<file-path>" \
     "https://<URL>/api/publish?type=<package-type>"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<file-path>" \
     "https://<URL>/api/publish?type=<package-type>"

ملاحظة

احصل على رابط Kudu من بوابة Azure: افتح تطبيقك واختر Development Tools>Advanced Tools، ثم اختر Go لفتح رابط Kudu.

لمزيد من المعلومات، راجع مرجع Kudu publish API.

قالب ARM

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

نشر ملفات فردية

نشر برنامج نصي لبدء التشغيل ومكتبة وملف ثابت إلى تطبيق الويب الخاص بك باستخدام az webapp deploy الأمر مع المعلمة --type .

إذا قمت بنشر برنامج نصي لبدء التشغيل بهذه الطريقة، فإن App Service تستخدم البرنامج النصي تلقائيا لبدء تشغيل التطبيق.

يستخدم أمر CLI Kudu publish API لنشر الملفات. يمكن تخصيص الأمر بالكامل.

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

az webapp deploy --resource-group <group-name> --name <app-name> --src-path scripts/startup.sh --type=startup

نشر ملف مكتبة

az webapp deploy --resource-group <group-name> --name <app-name> --src-path driver.jar --type=lib

نشر ملف ثابت

az webapp deploy --resource-group <group-name> --name <app-name> --src-path config.json --type=static

Azure PowerShell

‏‏غير مدعومة. راجع علامات Azure CLI أو Kudu API.

واجهة برمجة تطبيقات Kudu

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

يستخدم المثال التالي أداة cURL لنشر ملف بدء تشغيل للتطبيق. استبدل العنصر النائب <startup-file-path>. إذا اخترت المصادقة الأساسية، فقم بتوفير بيانات اعتماد النشر في <اسم المستخدم>وكلمة< المرور>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<startup-file-path>" \
     "https://<URL>/api/publish?type=startup"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<startup-file-path>" \
     "https://<URL>/api/publish?type=startup"

ملاحظة

احصل على رابط Kudu من بوابة Azure: افتح تطبيقك واختر Development Tools>Advanced Tools، ثم اختر Go لفتح رابط Kudu.

نشر ملف مكتبة

يستخدم المثال التالي أداة cURL لنشر ملف مكتبة للتطبيق. استبدل العنصر النائب <lib-file-path>. إذا اخترت المصادقة الأساسية، فقم بتوفير بيانات اعتماد النشر في <اسم المستخدم>وكلمة< المرور>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<lib-file-path>" \
     "https://<URL>/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<lib-file-path>" \
     "https://<URL>/api/publish?type=lib&path=/home/site/deployments/tools/my-lib.jar"

ملاحظة

احصل على رابط Kudu من بوابة Azure: افتح تطبيقك واختر Development Tools>Advanced Tools، ثم اختر Go لفتح رابط Kudu.

نشر ملف ثابت

يستخدم المثال التالي أداة cURL لنشر ملف تكوين للتطبيق. استبدل العنصر النائب <config-file-path>. إذا اخترت المصادقة الأساسية، فقم بتوفير بيانات اعتماد النشر في <اسم المستخدم>وكلمة< المرور>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -T @"<config-file-path>" \
     "https://<URL>/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"

# Basic authentication
curl -X POST \
     -u <username>:<password> \
     -T @"<config-file-path>" \
     "https://<URL>/api/publish?type=static&path=/home/site/deployments/tools/my-config.json"

ملاحظة

احصل على رابط Kudu من بوابة Azure: افتح تطبيقك واختر Development Tools>Advanced Tools، ثم اختر Go لفتح رابط Kudu.

قالب ARM

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

النشر إلى التطبيقات المؤمنة بالشبكة

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

يمكن أن يكون عنوان URL البعيد أي موقع يمكن الوصول إليه بشكل عام، ولكن من الأفضل استخدام حاوية تخزين كائن ثنائي كبير الحجم مع مفتاح توقيع وصول مشترك (SAS) لحمايتها.

az webapp deploy استخدم الأمر كما تفعل في الأقسام الأخرى، ولكن استخدم --src-url بدلا من --src-path. المثال التالي يستخدم معامل --src-url لتحديد عنوان URL لملف ZIP المستضاف في حساب تخزين Azure.

az webapp deploy --resource-group <group-name> --name <app-name> --src-url "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3 --type zip

Azure PowerShell

‏‏غير مدعومة. راجع علامات التبويب الخاصة بقالب Azure CLI أو Kudu API أو ARM.

واجهة برمجة تطبيقات Kudu

استدعاء Kudu publish API كما تفعل في الأقسام الأخرى. بدلا من تحميل ملف، قم بتمرير كائن JSON مع packageUri في نص الطلب. تستخدم الأمثلة التالية هذه الطريقة لتحديد عنوان URL لملف ZIP مستضاف في حساب تخزين Azure. لا يزال النوع محددا كسلسلة استعلام. إذا اخترت المصادقة الأساسية، فقم بتوفير بيانات اعتماد النشر في <اسم المستخدم>وكلمة< المرور>.

# Microsoft Entra authentication
TOKEN=$(az account get-access-token --query accessToken | tr -d '"')

curl -X POST \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"packageUri": "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3"}' \
     "https://<URL>/api/publish?type=zip"

# Basic authentication
curl -X POST \
     -u '<username>:<password>' \
     -H "Content-Type: application/json" \
     -d '{"packageUri": "https://storagesample.blob.core.windows.net/sample-container/myapp.zip?sv=2021-10-01&sb&sig=slk22f3UrS823n4kSh8Skjpa7Naj4CG3"}' \
     "https://<URL>/api/publish?type=zip"

ملاحظة

احصل على رابط Kudu من بوابة Azure: افتح تطبيقك واختر Development Tools>Advanced Tools، ثم اختر Go لفتح رابط Kudu.

قالب ARM

أضف JSON التالي إلى قالب ARM الخاص بك. استبدل اسم< التطبيق المؤقت> باسم التطبيق (على سبيل المثال، myapp).

{
    "type": "Microsoft.Web/sites/extensions",
    "apiVersion": "2021-03-01",
    "name": "<app-name>/onedeploy",
    "dependsOn": [
        "[resourceId('Microsoft.Web/sites', '<app-name>')]"
    ],
    "properties": {
        "packageUri": "<zip-package-uri>",
        "type": "<type>",
        "path": "<target-path>"
    }
}

ملاحظة

بالنسبة للموارد الفرعية المعرفة خارج المورد الأب، يجب أن تتضمن الخاصية name اسم المورد الأب. استخدم التنسيق {parent-name}/{child-name} لمطابقة بنية المقاطع الخاصة بنوع المورد. لمزيد من المعلومات، راجع تعيين اسم ونوع الموارد التابعة.

استخدم المرجع التالي لمساعدتك في تكوين الخصائص:

الخاصية	‏‏الوصف‬	مطلوب
packageUri	URI للحزمة أو الملف. لمزيد من المعلومات، راجع Microsoft. المواقع الإلكترونية/الإضافات 'onedeploy' .	‏‏نعم‬
type	راجع المعلمة type في مرجع Kudu publish API.	‏‏نعم‬
path	راجع المعلمة path في مرجع Kudu publish API.	لا

مرجع Kudu publish API

publish تسمح لك Kudu API بتحديد نفس المعلمات من أمر CLI كمعلمات استعلام URL. للمصادقة باستخدام Kudu REST API، نوصي بمصادقة الرمز المميز، ولكن يمكنك أيضا استخدام المصادقة الأساسية مع بيانات اعتماد نشر التطبيق.

يعرض الجدول التالي معلمات الاستعلام المتوفرة وقيمها المسموح بها والأوصاف.

المفتاح	القيم المسموح بها	‏‏الوصف‬	مطلوب	نوع
type	war|jar|ear|lib|startup|static|zip	هذا هو نوع البيانات الاصطناعية التي يتم نشرها. يقوم بتعيين المسار الهدف الافتراضي وإعلام تطبيق الويب بكيفية التعامل مع التوزيع. type=zip: انشر حزمة ZIP عن طريق فك ضغط المحتوى إلى /home/site/wwwroot. path المعلمة اختيارية. type=war: نشر حزمة WAR. بشكل افتراضي، يتم نشر حزمة WAR إلى /home/site/wwwroot/app.war. يمكن تحديد المسار الهدف باستخدام path. type=jar: انشر حزمة JAR إلى /home/site/wwwroot/app.jar. path يتم تجاهل المعلمة. type=ear: انشر حزمة EAR إلى /home/site/wwwroot/app.ear. path يتم تجاهل المعلمة. type=lib: نشر ملف مكتبة JAR. بشكل افتراضي، يتم نشر الملف إلى /home/site/libs. يمكن تحديد المسار الهدف باستخدام path. type=static: نشر ملف ثابت، مثل برنامج نصي. بشكل افتراضي، يتم نشر الملف إلى /home/site/wwwroot. type=startup: نشر برنامج نصي تستخدمه App Service تلقائيا كبرنامج نصي لبدء التشغيل لتطبيقك. افتراضيا، يتم نشر السكريبت إلى D:\home\site\scripts\<name-of-source> ل Windows وhome/site/wwwroot/startup.sh للينكس. يمكن تحديد المسار الهدف باستخدام path.	‏‏نعم‬	السلسلة‬
restart	true|false	بشكل افتراضي، تعيد واجهة برمجة التطبيقات تشغيل التطبيق بعد عملية التوزيع (restart=true). عند نشر بيانات اصطناعية متعددة، يمكنك منع إعادة التشغيل على الكل ما عدا التوزيع النهائي عن طريق تعيين restart=false.	لا	قيمة منطقية
clean	true|false	تحديد ما إذا كنت تريد تنظيف (حذف) التوزيع الهدف قبل نشر البيانات الاصطناعية هناك.	لا	قيمة منطقية
ignorestack	true|false	تستخدم WEBSITE_STACK واجهة برمجة تطبيقات النشر متغير البيئة لاختيار الإعدادات الافتراضية الآمنة اعتمادا على مكدس لغة موقعك. يؤدي تعيين هذه المعلمة إلى false تعطيل أي إعدادات افتراضية خاصة باللغة.	لا	قيمة منطقية
path	مسار مطلق	المسار المطلق لنشر البيانات الاصطناعية إليه. على سبيل المثال، /home/site/deployments/tools/driver.jar أو /home/site/scripts/helper.sh.	لا	السلسلة‬

المحتوى ذو الصلة

لسيناريوهات النشر المتقدمة، جرب deploying to Azure باستخدام Git. يتيح النشر القائم على Git على Azure التحكم في الإصدارات، واستعادة الحزم، وMSBuild، والمزيد.

• Kudu: النشر من ملف مضغوط
• متغيرات البيئة ومرجع إعدادات التطبيق