Azure Cloud Services (الدعم الموسع) تعريف مخطط WebRole

مقالة
04/27/2022
قراءة خلال 15 دقائق

دور Azure على الويب هو دور مخصص لبرمجة تطبيقات الويب كما يدعمها IIS 7، مثل ASP.NET وPHP ومؤسسة اتصالات Windows وFastCGI.

الامتداد الافتراضي لملف تعريف الخدمة هو csdef.

مخطط تعريف الخدمة الأساسية لدور الويب

التنسيق الأساسي لملف تعريف الخدمة الذي يحتوي على دور الويب هو كما يلي.

<ServiceDefinition …>  
  <WebRole name="<web-role-name>" vmsize="<web-role-size>" enableNativeCodeExecution="[true|false]">  
    <Certificates>  
      <Certificate name="<certificate-name>" storeLocation="<certificate-store>" storeName="<store-name>" />  
    </Certificates>      
    <ConfigurationSettings>  
      <Setting name="<setting-name>" />  
    </ConfigurationSettings>  
    <Imports>  
      <Import moduleName="<import-module>"/>  
    </Imports>  
    <Endpoints>  
      <InputEndpoint certificate="<certificate-name>" ignoreRoleInstanceStatus="[true|false]" name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<port-number>" port="<port-number>" loadBalancerProbe="<load-balancer-probe-name>" />  
      <InternalEndpoint name="<internal-endpoint-name>" protocol="[http|tcp|udp|any]" port="<port-number>">  
         <FixedPort port="<port-number>"/>  
         <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
      </InternalEndpoint>  
     <InstanceInputEndpoint name="<instance-input-endpoint-name>" localPort="<port-number>" protocol="[udp|tcp]">  
         <AllocatePublicPortFrom>  
            <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>  
         </AllocatePublicPortFrom>  
      </InstanceInputEndpoint>  
    </Endpoints>  
    <LocalResources>  
      <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    </LocalResources>  
    <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />  
    <Runtime executionContext="[limited|elevated]">  
      <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
      </Environment>  
      <EntryPoint>  
         <NetFxEntryPoint assemblyName="<name-of-assembly-containing-entrypoint>" targetFrameworkVersion="<.net-framework-version>"/>  
      </EntryPoint>  
    </Runtime>  
    <Sites>  
      <Site name="<web-site-name>">  
        <VirtualApplication name="<application-name>" physicalDirectory="<directory-path>"/>  
        <VirtualDirectory name="<directory-path>" physicalDirectory="<directory-path>"/>  
        <Bindings>  
          <Binding name="<binding-name>" endpointName="<endpoint-name-bound-to>" hostHeader="<url-of-the-site>"/>  
        </Bindings>  
      </Site>  
    </Sites>  
    <Startup priority="<for-internal-use-only>">  
      <Task commandLine="<command-to=execute>" executionContext="[limited|elevated]" taskType="[simple|foreground|background]">  
        <Environment>  
         <Variable name="<variable-name>" value="<variable-value>">  
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>  
          </Variable>            
        </Environment>  
      </Task>  
    </Startup>  
    <Contents>  
      <Content destination="<destination-folder-name>" >  
        <SourceDirectory path="<local-source-directory>" />  
      </Content>  
    </Contents>  
  </WebRole>  
</ServiceDefinition>

عناصر المخطط

يتضمن ملف تعريف الخدمة هذه العناصر الموضحة بالتفصيل في المقاطع اللاحقة في هذا الموضوع:

InstanceInputEndpoint

AllocatePublicPortFrom

⁧⁩الشهادات⁧⁩

دور الويب

WebRoleيصف العنصر دور مخصص لبرمجة تطبيق الويب، كما يدعمها IIS 7 وASP.NET. قد تحتوي الخدمة على أدوار ويب صفرية أو أكثر.

يُوضح الجدول التالي سمات WebRoleالعنصر.

السمة	النوع	الوصف
الاسم	سلسلة	مطلوب اسم دور الويب. يجب أن يكون هذا الاسم فريداً.
enableNativeCodeExecution	منطقي	‏‏اختياري. القيمة الافتراضية هي `true`؛ يتم تمكين تنفيذ التعليمات البرمجية الأصلية والثقة الكاملة بشكل افتراضي. تعيين هذه السمة `false` لتعطيل تنفيذ التعليمات البرمجية الأصلية لدور الويب واستخدام الثقة الجزئية لـ Azure بدلاً من ذلك.
vmSize	سلسلة	‏‏اختياري. تعيين هذه القيمة لتغيير حجم الجهاز الظاهري المخصص للدور. القيمة الافتراضية هي `Small`. لمزيد من المعلومات، راجع الجهاز الظاهري وأحجام الخدمة السحابية لـ Azure.

إعدادات التكوين

ConfigurationSettingsيصف العنصر مجموعة إعدادات التكوين لدور ويب. هذا العنصر هو أصلSetting العنصر.

إعداد

Settingيصف العنصر زوج الاسم والقيمة الذي يحدد إعداد التكوين لمثيل الدور.

يُوضح الجدول التالي سمات Settingالعنصر.

السمة	النوع	الوصف
الاسم	سلسلة	مطلوب اسم فريد لإعدادات التكوين.

إعدادات التكوين لدور ما هي أزواج الاسم والقيم التي تم تعريفها في ملف تعريف الخدمة وتعيينها في ملف تكوين الخدمة.

المصادر المحلية

LocalResourcesيصف العنصر مجموعة إعدادات التكوين لدور الويب. هذا العنصر هو أصلLocalStorage العنصر.

التخزين الداخلي

LocalStorageيعرف العنصر مورد تخزين محلي يوفر مساحة نظام الملفات للخدمة في وقت التشغيل. قد يحدد الدور صفر أو أكثر من موارد التخزين المحلية.

ملاحظة

LocalStorageيمكن أن يظهر العنصر كتابع WebRole للعنصر لدعم التوافق مع الإصدارات السابقة من SDK Azure.

يُوضح الجدول التالي سمات LocalStorageالعنصر.

السمة	النوع	الوصف
الاسم	سلسلة	مطلوب اسم فريد للمخزن الداخلي.
cleanOnRoleRecycle	منطقي	‏‏اختياري. يشير إلى ما إذا كان يجب تنظيف المخزن المحلي عند إعادة تشغيل الدور. القيمة الافتراضية هي ⁧`true`⁩.
sizeInMb	Int	‏‏اختياري. الكمية المطلوبة من مساحة التخزين لتخصيصها للمتجر المحلي، بالميغابايت. إذا لم يتم تحديد مساحة التخزين الافتراضية المخصصة 100 ميغابايت. الحد الأدنى لمساحة التخزين التي قد يتم تخصيصها هو 1 ميغابايت. يعتمد الحجم الأقصى للموارد المحلية على حجم الجهاز الظاهري. لمزيد من المعلومات، راجع الجهاز الظاهري وأحجام الخدمة السحابية لـ Azure.

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

نقاط النهاية

Endpointsيصف العنصر مجموعة نقاط نهاية الإدخال (الخارجية) والداخلية ونقاط نهاية الإدخال للمثيل لدور ما. هذا العنصر هو أصل العناصر InputEndpoint وInternalEndpoint وInstanceInputEndpoint.

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

ملاحظة

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

نقطة نهاية الإدخال

InputEndpointيصف العنصر نقطة نهاية خارجية لدور ويب.

يمكنك تعريف نقاط نهاية متعددة هي مزيج من نقاط النهاية HTTP وHTTPS وUDP وTCP. يمكنك تحديد أي رقم منفذ تختاره لنقطة نهاية إدخال، ولكن يجب أن تكون أرقام المنافذ المحددة لكل دور في الخدمة فريدة. على سبيل المثال، إذا حددت أن دور ويب يستخدم المنفذ 80 ل HTTP والمنفذ 443 ل HTTPS، فقد تحدد بعد ذلك أن دور ويب ثانٍ يستخدم المنفذ 8080 ل HTTP والمنفذ 8043 ل HTTPS.

يُوضح الجدول التالي سمات InputEndpointالعنصر.

السمة	النوع	الوصف
الاسم	سلسلة	مطلوب اسم فريد لنقطة النهاية الخارجية.
البروتوكول	سلسلة	مطلوب بروتوكول النقل لنقطة النهاية الخارجية. بالنسبة لدور ويب، تكون القيم المحتملة هي `HTTP` أو `HTTPS` أو `UDP` أو `TCP`.
المنفذ	Int	مطلوب منفذ نقطة النهاية الخارجية. يمكنك تحديد أي رقم منفذ تختاره، ولكن يجب أن تكون أرقام المنافذ المحددة لكل دور في الخدمة فريدة. تتراوح القيم المحتملة بين 1 و65535، شاملة (الإصدار 1.7 من Azure SDK أو أعلى).
الشهادة	سلسلة	مطلوب لنقطة نهاية HTTPS. اسم الشهادة المعرفة بواسطة `Certificate` عنصر.
المنفذ المحلي	Int	‏‏اختياري. تحديد منفذ يستخدم للاتصالات الداخلية على نقطة النهاية. `localPort`تعين سمة المنفذ الخارجي على نقطة النهاية إلى منفذ داخلي على دور. هذا مفيد في السيناريوهات حيث يجب أن يتصل دور إلى مكون داخلي على منفذ مختلف عن المنفذ الذي يتم كشفه خارجياً. إذا لم يتم التحديد، تكون قيمة `localPort` هي نفس قيمة السمة `port`. تعيين قيمة `localPort` إلى “*” وذلك لتعيين منفذ غير مخصص تلقائياً والذي تم اكتشافه باستخدام واجهة برمجة تطبيقات وقت التشغيل. تتراوح القيم المحتملة بين 1 و65535، شاملة (الإصدار 1.7 من Azure SDK أو أعلى). تتوفر `localPort`السمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.
ignoreRoleInstanceStatus	منطقي	‏‏اختياري. عند تعيين قيمة هذه السمة إلى `true`، يتم تجاهل حالة الخدمة ولن تتم إزالة نقطة النهاية بواسطة موازن التحميل. يفيد تعيين هذه القيمة إلى `true` في تصحيح أخطاء المثيلات المشغولة لخدمة ما. القيمة الافتراضية هي `false`. ملاحظة: لا يزال بإمكان نقطة النهاية تلقي حركة انتقال البيانات حتى عندما لا يكون الدور في حالة "استعداد".
loadBalancerProbe	سلسلة	‏‏اختياري. اسم أداة تحقيق موازن التحميل المقترن بنقطة نهاية الإدخال. لمزيد من المعلومات، راجع مخطط LoadBalancerProbe.

نقطة نهاية داخلية

InternalEndpointيصف العنصر نقطة نهاية خارجية لدور ويب. تتوفر نقطة نهاية داخلية فقط لمثيلات الأدوار الأخرى التي تعمل داخل الخدمة؛ وهي غير متوفرة للعملاء خارج الخدمة. يمكن أن يكون لأدوار ويب التي لا تتضمن Sitesالعنصر نقطة نهاية داخلية واحدة فقط ل HTTP أو UDP أو TCP.

يُوضح الجدول التالي سمات InternalEndpointالعنصر.

السمة	النوع	الوصف
الاسم	سلسلة	مطلوب اسم فريد لنقطة النهاية الخارجية.
البروتوكول	سلسلة	مطلوب بروتوكول النقل لنقطة النهاية الداخلية. القيم المُحتملة هي `HTTP` و`TCP` و`UDP` و`ANY`. تحدد قيمة `ANY` أي بروتوكول، أي منفذ مسموح به.
المنفذ	Int	‏‏اختياري. المنفذ المستخدم للاتصالات الداخلية متوازنة التحميل على نقطة النهاية. تستخدم نقطة النهاية المتوازنة تحميل منفذين. المنفذ المستخدم لعنوان IP العمومي والمنفذ المستخدم على عنوان IP الخاص. عادة ما يتم تعيين هذه إلى نفس، ولكن يمكنك اختيار استخدام منافذ مختلفة. تتراوح القيم المحتملة بين 1 و65535، شاملة (الإصدار 1.7 من Azure SDK أو أعلى). تتوفر `Port`السمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

InstanceInputEndpoint

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

تتوفر InstanceInputEndpointالسمة فقط باستخدام الإصدار 1.7 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات InstanceInputEndpointالعنصر.

السمة	النوع	الوصف
الاسم	سلسلة	مطلوب اسم فريد لنقطة النهاية.
المنفذ المحلي	Int	مطلوب تعين المنفذ الداخلي الذي ستستمع إليه جميع مثيلات الدور لتلقي حركة انتقال البيانات الواردة التي يتم إعادة توجيهها من موازن التحميل. تتراوح القيم المحتملة بين 1 و65535، شاملة.
البروتوكول	سلسلة	مطلوب بروتوكول النقل لنقطة النهاية الداخلية. القيم المُحتملة هي `udp` أو `tcp`. استخدام `tcp` لحركة انتقال البيانات على أساس http/https.

AllocatePublicPortFrom

AllocatePublicPortFromيصف العنصر نطاق المنفذ العام الذي يمكن استخدامه من قبل العملاء الخارجيين للوصول إلى كل نقطة نهاية إدخال مثيل. يتم تخصيص رقم المنفذ العام (VIP) من هذا النطاق وتعيينه لكل نقطة نهاية مثيل دور فردي أثناء توزيع المستأجر وتحديثه. هذا العنصر هو أصل العنصر FixedPortRange.

تتوفر AllocatePublicPortFromالسمة فقط باستخدام الإصدار 1.7 Azure SDK أو أعلى.

FixedPort

FixedPortيحدد العنصر منفذ نقطة النهاية الداخلية، والذي يتيح تحميل اتصالات متوازنة على نقطة النهاية.

تتوفر FixedPortالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات FixedPortالعنصر.

السمة	النوع	الوصف
المنفذ	Int	مطلوب منفذ نقطة النهاية الداخلية. هذا له نفس التأثير مثل تعيين `FixedPortRange`الحد الأدنى والحد الأقصى إلى نفس المنفذ. تتراوح القيم المحتملة بين 1 و65535، شاملة (الإصدار 1.7 من Azure SDK أو أعلى).

FixedPortRange

FixedPortRangeيحدد العنصر نطاق المنافذ المعينة إلى نقطة النهاية الداخلية أو نقطة نهاية إدخال المثيل، ويعين المنفذ المستخدم للاتصالات متوازنة التحميل على نقطة النهاية.

ملاحظة

FixedPortRangeيعمل العنصر بشكل مختلف اعتماداً على العنصر الذي يقيم فيه. عندما FixedPortRange يكون العنصر في عنصر InternalEndpoint، فإنه يفتح جميع المنافذ على موازنة التحميل ضمن نطاق سمات الحد الأدنى والأقصى لجميع الأجهزة الظاهرية التي يتم تشغيل الدور فيها. عندما FixedPortRange يكون العنصر في عنصر InstanceInputEndpoint، فإنه يفتح جميع المنافذ على موازنة التحميل ضمن نطاق سمات الحد الأدنى والأقصى لجميع الأجهزة الظاهرية التي يتم تشغيل الدور فيها.

تتوفر FixedPortRangeالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات FixedPortRangeالعنصر.

السمة	النوع	الوصف
دقيقة	Int	مطلوب المنفذ الأدنى في النطاق. تتراوح القيم المحتملة بين 1 و65535، شاملة (الإصدار 1.7 من Azure SDK أو أعلى).
الحد الأقصى	سلسلة	مطلوب المنفذ الأقصى في النطاق. تتراوح القيم المحتملة بين 1 و65535، شاملة (الإصدار 1.7 من Azure SDK أو أعلى).

الشهادات

Certificatesيصف العنصر مجموعة إعدادات التكوين لدور ويب. هذا العنصر هو أصلCertificate العنصر. قد يكون للدور أي عدد من الشهادات المقترنة. لمزيد من المعلومات حول استخدام عنصر الشهادات، انظر تعديل ملف تعريف الخدمة مع شهادة.

الشهادة

Certificateيصف العنصر شهادة مقترنة بدور ويب.

يُوضح الجدول التالي سمات Certificateالعنصر.

السمة	النوع	الوصف
الاسم	سلسلة	مطلوب اسم لهذه الشهادة، والذي يستخدم للإشارة إليه عند اقترانه `InputEndpoint` بعنصر HTTPS.
موقع المتجر	سلسلة	مطلوب موقع مخزن الشهادات حيث يمكن العثور على هذه الشهادة على الجهاز المحلي. القيم المُحتملة هي `CurrentUser` و`LocalMachine`.
storeName	سلسلة	مطلوب اسم مخزن الشهادات حيث توجد هذه الشهادة على الجهاز المحلي. تتضمن القيم المحتملة أسماء المتاجر المضمنة `My` أو `Root` أو `CA` أو `Trust` أو `Disallowed` أو `TrustedPeople` أو `TrustedPublisher` أو `AuthRoot` أو `AddressBook` أو أي اسم مخزن مخصص. إذا تم تحديد اسم مخزن مخصص، يتم إنشاء المخزن تلقائياً.
permissionLevel	سلسلة	‏‏اختياري. تحديد أذونات الوصول الممنوحة لعمليات الدور. إذا كنت تريد العمليات المرتفعة فقط حتى تتمكن من الوصول إلى المفتاح الخاص، فحدد الإذن`elevated`. `limitedOrElevated`يسمح إذن limitedOrElevated لجميع عمليات الدور بالوصول إلى المفتاح الخاص. القيم المُحتملة هي `limitedOrElevated` أو `elevated`. القيمة الافتراضية هي `limitedOrElevated`.

الاستيراد

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

تتوفر Importsالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

استيراد

Importيحدد العنصر وحدة نمطية لإضافتها إلى نظام التشغيل الضيف.

تتوفر Importالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات Importالعنصر.

السمة	النوع	الوصف
اسم الوحدة النمطية	سلسلة	مطلوب اسم الوحدة النمطية التي تريد استيرادها. الوحدات النمطية صالحة الاستيراد هي: - RemoteAccess - RemoteForwarder - التشخيصات تسمح لك الوحدات النمطية RemoteAccess وRemoteForwarder بتكوين مثيل دورك لاتصالات سطح المكتب البعيدة. لمزيد من المعلومات، راجع الإضافات. تسمح لك الوحدة النمطية "التشخيصات" بتجميع بيانات تشخيصية لمثيل دور.

وقت التشغيل

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

تتوفر Runtimeالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات Runtimeالعنصر:

السمة	النوع	الوصف
executionContext	سلسلة	‏‏اختياري. تحديد السياق الذي يتم فيه تشغيل عملية الدور. السياق الافتراضي هو `limited`. - `limited` - تعمل العملية دون امتيازات "المسؤول". - `elevated` - تعمل العملية مع امتيازات "المسؤول".

البيئة

Environmentيصف العنصر مجموعة من إعدادات متغيرات البيئة لدور ويب. هذا العنصر هو أصلVariable العنصر. قد يكون دور أي عدد من متغيرات البيئة تعيين.

المتغير

Variableيحدد العنصر متغير بيئة لتعيينه في تشغيل الضيف.

تتوفر Variableالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات Variableالعنصر:

السمة	النوع	الوصف
الاسم	سلسلة	مطلوب تعيين اسم متغير البيئة.
القيمة	سلسلة	‏‏اختياري. القيمة التي يجب تعيينها لمتغير البيئة. يجب تضمين سمة قيمة أو `RoleInstanceValue` عنصر.

RoleInstanceValue

RoleInstanceValueيحدد العنصر xPath الذي يمكن استرداد قيمة المتغير منه.

يُوضح الجدول التالي سمات RoleInstanceValueالعنصر.

السمة	النوع	الوصف
xpath	سلسلة	‏‏اختياري. مسار موقع إعدادات توزيع المثيل. انظر متغيرات التكوين باستخدام XPath للحصول على مزيدٍ من المعلومات. يجب تضمين سمة قيمة أو `RoleInstanceValue` عنصر.

نقطة الإدخال

EntryPointيحدد العنصر نقطة الإدخال لدور. هذا العنصر هو أصلNetFxEntryPoint العنصر. تسمح لك هذه العناصر بتحديد تطبيق آخر غير WaWorkerHost.exe الافتراضي للعمل كنقطة إدخال دور.

تتوفر EntryPointالسمة فقط باستخدام الإصدار 1.5 Azure SDK أو أعلى.

NetFxEntryPoint

NetFxEntryPointيحدد العنصر برنامج لتشغيل دور.

ملاحظة

تتوفر NetFxEntryPointالسمة فقط باستخدام الإصدار 1.5 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات NetFxEntryPointالعنصر.

السمة	النوع	الوصف
اسم التجميع	سلسلة	مطلوب المسار واسم ملف التجميع الذي يحتوي على نقطة الإدخال. يتعلق المسار بالمجلد \%ROLEROOT%\Approot (لا تحدد \%ROLEROOT%\Approot في `commandLine`، إذ يتم افتراضه). ٪ROLEROOT٪ هو متغير بيئة يحتفظ به Azure ويمثل موقع مجلد الجذر لدورك. يمثل المجلد %ROLEROOT%\Approot مجلد التطبيق لدورك. بالنسبة لأدوار HWC، يتعلق المسار دائماً بالمجلد \%ROLEROOT%\Approot\bin. بالنسبة لأدوار الويب الكاملة IIS وIIS Express، إذا تعذّر العثور على التجميع المتعلق بالمجلد \%ROLEROOT%\Approot، يتم البحث عن \%ROLEROOT%\Approot\bin. لا يوصى بسلوك تراجع IIS الكامل كأفضل ممارسة وربما تتم إزالته في الإصدارات المستقبلية.
targetFrameworkVersion	سلسلة	مطلوب إصدار إطار عمل .NET الذي تم إنشاء التجميع عليه. على سبيل المثال، ⁧`targetFrameworkVersion="v4.0"`⁩.

المواقع

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

تتوفر Sitesالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

الموقع

Siteيحدد العنصر موقع ويب أو تطبيق ويب الذي يعد جزءاً من دور الويب.

تتوفر Siteالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات Siteالعنصر.

السمة	النوع	الوصف
الاسم	سلسلة	مطلوب اسم الموقع أو التطبيق.
physicalDirectory	سلسلة	موقع دليل المحتوى لجذر الموقع. يمكن تحديد الموقع كمسار مطلق أو بالنسبة لموقع csdef.

التطبيق الظاهري

VirtualApplicationيعرف العنصر تطبيق في خدمات معلومات الإنترنت (IIS) 7 هو تجميع الملفات التي توفر محتوى أو توفر خدمات عبر بروتوكولات مثل HTTP. عند إنشاء تطبيق في IIS 7 يصبح مسار التطبيق جزءاً من URL للموقع.

تتوفر VirtualApplicationالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات VirtualApplicationالعنصر.

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

الدليل الظاهري

VirtualDirectoryيحدد العنصر اسم دليل (يشار إليه أيضاً باسم المسار) الذي تحدده في IIS وتعيينه إلى دليل فعلي على خادم محلي أو بعيد.

تتوفر VirtualDirectoryالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات VirtualDirectoryالعنصر.

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

Bindings

Bindingsيصف العنصر مجموعة من الارتباطات لموقع ويب. هذا العنصر هو أصل العنصر Binding. العنصر مطلوب لكل Site عنصر. لمزيد من المعلومات حول تكوين نقاط النهاية، راجع تمكين الاتصال لمثيلات الدور.

تتوفر Bindingsالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

Binding

Bindingيحدد العنصر معلومات التكوين المطلوبة لطلبات الاتصال بموقع ويب أو تطبيق ويب.

تتوفر Bindingالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

السمة	النوع	الوصف
الاسم	سلسلة	مطلوب تعين اسماً لتعريف الربط.
اسم نقطة النهاية	سلسلة	مطلوب تحديد اسم نقطة النهاية لربطه.
hostHeader	سلسلة	‏‏اختياري. تحديد اسم مضيف يسمح لك باستضافة مواقع متعددة، بأسماء مضيف مختلفة، على مجموعة أرقام IP/Port واحدة.

البداية

Startupيصف العنصر مجموعة من المهام التي يتم تشغيلها عند بدء تشغيل الدور. هذا العنصر هو أصلVariable العنصر. لمزيد من المعلومات حول استخدام مهام بدء التشغيل الدور، انظر كيفية تكوين مهام بدء التشغيل. هذا العنصر اختياري ويمكن أن يكون دور كتلة بدء تشغيل واحدة فقط.

يُوضح الجدول التالي سمات Startupالعنصر.

السمة	النوع	الوصف
الأولوية	Int	للاستخدام الداخلي فقط.

المهمة

Taskيحدد العنصر مهمة بدء التشغيل التي تحدث عند بدء تشغيل الدور. يمكن استخدام مهام بدء التشغيل لتنفيذ المهام التي تُعِد الدور لتشغيل مكونات البرامج تثبيت مثل هذه أو تشغيل تطبيقات أخرى. تنفذ المهام بالترتيب الذي تظهر به داخل Startup كتلة العنصر.

تتوفر Taskالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات Taskالعنصر.

السمة	النوع	الوصف
commandLine	سلسلة	مطلوب برنامج نصي، مثل ملف CMD، يحتوي على أوامر التشغيل. يجب حفظ أمر بدء التشغيل والملفات الدُفَعية بتنسيق ANSI. لن تُعالَج تنسيقات الملفات التي تقوم بتعيين علامة ترتيب البايت في بداية الملف بشكل صحيح.
executionContext	سلسلة	تحديد السياق الذي يتم تشغيل البرنامج النصي فيه. - `limited` [افتراضي] - التشغيل مع نفس امتيازات كاستضافة دور العملية. - `elevated` - التشغيل مع نفس امتيازات المسؤول.
نوع المهمة	سلسلة	تحديد سلوك تنفيذ الأمر. - `simple` [افتراضي] - ينتظر النظام خروج المهمة قبل تشغيل أي مهام أخرى. - `background` - لا ينتظر النظام خروج المهمة. - `foreground` - تماما مثل الواجهة الخلفية، لا تتم إعادة تشغيل الدور إلا عند خروج مهام الواجهة الأمامية.

المحتويات

Contentsيصف العنصر مجموعة إعدادات التكوين لدور ويب. هذا العنصر هو أصلContent العنصر.

تتوفر Contentsالسمة فقط باستخدام الإصدار 1.5 Azure SDK أو أعلى.

المحتوى

Contentيعرف العنصر موقع مصدر المحتوى المراد نسخه إلى الجهاز الظاهري Azure ومسار الوجهة التي يتم نسخها إليه.

تتوفر Contentالسمة فقط باستخدام الإصدار 1.5 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات Contentالعنصر.

السمة	النوع	الوصف
الوجهة	سلسلة	مطلوب الموقع على الجهاز الظاهري Azure الذي يتم وضع المحتوى إليه. هذا الموقع يُنسب إلى المجلد ٪ROLEROOT٪\Approot.

هذا العنصر هو أصلSourceDirectory العنصر.

مصدر الدليل

SourceDirectoryيعرف العنصر الدليل المحلي الذي يتم نسخ المحتوى منه. استخدم هذا العنصر لتحديد المحتويات المحلية لنسخها إلى الجهاز الظاهري Azure.

تتوفر SourceDirectoryالسمة فقط باستخدام الإصدار 1.5 Azure SDK أو أعلى.

يُوضح الجدول التالي سمات SourceDirectoryالعنصر.

السمة	النوع	الوصف
مسار	سلسلة	مطلوب تُنسخ محتويات المسار النسبي أو المطلق لدليل محلي إلى الجهاز الظاهري Azure. يتم اعتماد توسيع متغيرات البيئة في مسار الدليل.

راجع أيضًا

مخطط تعريف الخدمة السحابية (الدعم الموسع).

Azure Cloud Services (الدعم الموسع) تعريف مخطط WebRole

هل هذه الصفحة مفيدة؟

مخطط تعريف الخدمة الأساسية لدور الويب

عناصر المخطط

دور الويب

إعدادات التكوين

إعداد

المصادر المحلية

التخزين الداخلي

نقاط النهاية

نقطة نهاية الإدخال

نقطة نهاية داخلية

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

الشهادات

الشهادة

الاستيراد

استيراد

وقت التشغيل

البيئة

المتغير

RoleInstanceValue

نقطة الإدخال

NetFxEntryPoint

المواقع

الموقع

التطبيق الظاهري

الدليل الظاهري

Bindings

Binding

البداية

المهمة

المحتويات

المحتوى

مصدر الدليل

راجع أيضًا