مخطط 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
يصِف 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. يتم اعتماد توسيع متغيرات البيئة في مسار الدليل. |
(راجع أيضًا )
مخطط تعريف الخدمة السحابية (الدعم الموسع).
الملاحظات
https://aka.ms/ContentUserFeedback.
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجعإرسال الملاحظات وعرضها المتعلقة بـ