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

دور العامل Azure هو دور مفيد للتطوير المعمم، وقد يؤدي معالجة خلفية لدور ويب.

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

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

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

<ServiceDefinition …>
  <WorkerRole name="<worker-role-name>" vmsize="<worker-role-size>" enableNativeCodeExecution="[true|false]">
    <Certificates>
      <Certificate name="<certificate-name>" storeLocation="[CurrentUser|LocalMachine]" storeName="[My|Root|CA|Trust|Disallow|TrustedPeople|TrustedPublisher|AuthRoot|AddressBook|<custom-store>" />
    </Certificates>
    <ConfigurationSettings>
      <Setting name="<setting-name>" />
    </ConfigurationSettings>
    <Endpoints>
      <InputEndpoint name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<local-port-number>" port="<port-number>" certificate="<certificate-name>" 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>
    <Imports>
      <Import moduleName="[RemoteAccess|RemoteForwarder|Diagnostics]"/>
    </Imports>
    <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>"/>
         <ProgramEntryPoint commandLine="<application>" setReadyOnProcessStart="[true|false]"/>
      </EntryPoint>
    </Runtime>
    <Startup priority="<for-internal-use-only>">
      <Task commandLine="" 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>
  </WorkerRole>
</ServiceDefinition>

عناصر المخطط

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

WorkerRole

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

الإعداد

LocalResources

LocalStorage

النهايه

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

الشهادات

شهاده

الاستيراد

استيراد

وقت التشغيل

البيئة

EntryPoint

NetFxEntryPoint

ProgramEntryPoint

متغير

RoleInstanceValue

الشركات الناشئة

مهمة

محتويات

المحتوى

مصدر الدليل

WorkerRole

يصِف WorkerRoleالعنصر دوراً مفيداً للتطوير المعمم، وقد يؤدي معالجة خلفية لدور ويب. قد تحتوي الخدمة على أدوار عامل صفري أو أكثر.

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

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

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

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

الإعدادات

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

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

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

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

LocalResources

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

LocalStorage

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

إشعار

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

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

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

يعتمد الحجم الأقصى للموارد المحلية على حجم الجهاز الظاهري. لمزيد من المعلومات، راجع الجهاز الظاهري وأحجام الخدمة السحابية لـ Azure.

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

نقاط النهاية

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

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

إشعار

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

InputEndpoint

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

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

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

السمة النوع ‏‏الوصف
الاسم سلسلة مطلوب اسم فريد لنقطة النهاية الخارجية.
البروتوكول سلسلة مطلوب بروتوكول النقل لنقطة النهاية الخارجية. بالنسبة لدور ويب، تكون القيم المحتملة هي HTTP أو HTTPS أو UDP أو TCP.
المنفذ العدد الصحيح مطلوب. منفذ نقطة النهاية الخارجية. يمكنك تحديد أي رقم منفذ تختاره، ولكن يجب أن تكون أرقام المنافذ المحددة لكل دور في الخدمة فريدة.

تتراوح القيم المحتملة بين 1 و65535، شاملة (الإصدار 1.7 من Azure SDK أو أعلى).
الشهادة سلسلة مطلوب لنقطة نهاية HTTPS. اسم الشهادة المعرفة بواسطة Certificate عنصر.
المنفذ المحلي العدد الصحيح اختياري. تحديد منفذ يستخدم للاتصالات الداخلية على نقطة النهاية. localPortتعين سمة المنفذ الخارجي على نقطة النهاية إلى منفذ داخلي على دور. وهذا مفيد في السيناريوهات حيث يجب أن يتصل دور إلى مكون داخلي على منفذ مختلف عن المنفذ الذي يتم كشفه خارجياً.

إذا لم يتم التحديد، تكون قيمة localPort هي نفس قيمة السمة port. تعيين قيمة localPort إلى “*” وذلك لتعيين منفذ غير مخصص تلقائياً والذي تم اكتشافه باستخدام واجهة برمجة تطبيقات وقت التشغيل.

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

تتوفر localPortالسمة فقط باستخدام الإصدار 1.3 Azure SDK أو أعلى.
ignoreRoleInstanceStatus boolean اختياري. عند تعيين قيمة هذه السمة إلى true، يتم تجاهل حالة الخدمة ولن تتم إزالة نقطة النهاية بواسطة موازن التحميل. يفيد تعيين هذه القيمة إلى true في تصحيح أخطاء المثيلات المشغولة لخدمة ما. القيمة الافتراضية هي false. ملاحظة: لا يزال بإمكان نقطة النهاية تلقي حركة انتقال البيانات حتى عندما لا يكون الدور في حالة "استعداد".
loadBalancerProbe سلسلة اختياري. اسم مسبار موازن التحميل المقترن بنقطة نهاية الإدخال. لمزيد من المعلومات، راجع مخطط LoadBalancerProbe.

InternalEndpoint

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

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

السمة النوع ‏‏الوصف
الاسم سلسلة مطلوب اسم فريد لنقطة النهاية الداخلية.
البروتوكول سلسلة مطلوب بروتوكول النقل لنقطة النهاية الداخلية. القيم المحتملة هي HTTP أو TCP أو UDP أو ANY.

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

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

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

InstanceInputEndpoint

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

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

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

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

AllocatePublicPortFrom

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

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

FixedPort

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

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

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

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

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

FixedPortRange

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

إشعار

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

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

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

السمة النوع ‏‏الوصف
دقيقة العدد الصحيح مطلوب. المنفذ الأدنى في النطاق. تتراوح القيم المحتملة بين 1 و65535، شاملة (الإصدار 1.7 من Azure SDK أو أعلى).
max سلسلة مطلوب المنفذ الأقصى في النطاق. تتراوح القيم المحتملة بين 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

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

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

NetFxEntryPoint

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

إشعار

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

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

السمة النوع ‏‏الوصف
assemblyName سلسلة مطلوب المسار واسم الملف للتجميع الذي يحتوي على نقطة الإدخال. يتعلق المسار بالمجلد \%ROLEROOT%\Approot (لا تحدد \%ROLEROOT%\Approot في commandLine، إذ يتم افتراضه). ٪ROLEROOT٪ هو متغير بيئة يحتفظ به Azure ويمثل موقع مجلد الجذر لدورك. يمثل المجلد %ROLEROOT%\Approot مجلد التطبيق لدورك.
targetFrameworkVersion سلسلة مطلوب إصدار إطار عمل .NET الذي تم إنشاء التجميع عليه. على سبيل المثال، targetFrameworkVersion="v4.0".

ProgramEntryPoint

ProgramEntryPointيحدد العنصر برنامج لتشغيل دور. يسمح لك العنصر ProgramEntryPoint بتحديد نقطة إدخال برنامج لا يستند إلى تجميع .NET.

إشعار

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

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

السمة النوع ‏‏الوصف
commandLine سلسلة مطلوب المسار واسم الملف وأي وسيطات سطر الأوامر للبرنامج لتنفيذها. يتعلق المسار بالمجلد %ROLEROOT%\Approot (لا تحدد %ROLEROOT%\Approot في commandLine، حيث يتم افتراضه). ٪ROLEROOT٪ هو متغير بيئة يحتفظ به Azure ويمثل موقع مجلد الجذر لدورك. يمثل المجلد %ROLEROOT%\Approot مجلد التطبيق لدورك.

إذا انتهى البرنامج، تتم إعادة تدوير الدور، لذلك بشكل عام عيّن البرنامج للاستمرار في التشغيل، بدلاً من أن يكون برنامجاً يبدأ ويشغّل مهمة محدودة.
setReadyOnProcessStart boolean مطلوب. تحديد ما إذا كان مثيل الدور ينتظر برنامج سطر الأوامر للإشارة إلى بدء تشغيله. يجب تعيين هذه القيمة إلى true في هذا الوقت. يتم حجز تعيين القيمة false إلى للاستخدام في المستقبل.

البدء

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

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

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

المهمة

يحدد العنصر 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العنصر.

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

(راجع أيضًا )

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