إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ينطبق على:
IoT Edge 1.5
هام
IoT Edge 1.5 LTS هو الإصدار المدعوم. IoT Edge 1.4 LTS هو نهاية العمر الافتراضي اعتبارا من 12 نوفمبر 2024. إذا كنت تستخدم إصدارا سابقا، فشاهد تحديث IoT Edge.
عامل IoT Edge ومركز IoT Edge هما وحدتان تشكلان وقت تشغيل IoT Edge. لمزيد من المعلومات حول مسؤوليات كل وحدة نمطية لوقت التشغيل، راجع فهم وقت تشغيل Azure IoT Edge وهندسته.
توفر هذه المقالة الخصائص المطلوبة والخصائص المبلغ عنها لتوائم وحدة وقت التشغيل. لمزيد من المعلومات حول كيفية نشر الوحدات النمطية على أجهزة IoT Edge، راجع معرفة كيفية نشر الوحدات النمطية وإنشاء المسارات في IoT Edge.
تتضمن الوحدة المزدوجة ما يلي:
الخصائص المرغوبة. تعين الواجهة الخلفية للحل الخصائص المطلوبة، وتقرأها الوحدة النمطية. تتلقى الوحدة أيضا إعلامات بالتغييرات في الخصائص المطلوبة. يتم استخدام الخصائص المرغوبة جنبا إلى جنب مع الخصائص المبلغ عنها لمزامنة تكوين الوحدة النمطية أو الشروط.
الخصائص المبلغ عنها. تعين الوحدة النمطية الخصائص التي تم الإبلاغ عنها، وتقرأها الواجهة الخلفية للحل وتستعلم عنها. يتم استخدام الخصائص التي تم الإبلاغ عنها مع الخصائص المرغوبة لمزامنة تكوين الوحدة النمطية أو الشروط.
حافة العامل الخاصة بالخصائص المطلوبة
تسمى $edgeAgentالوحدة المزدوجة لعامل IoT Edge . وهو ينسق الاتصالات بين عامل IoT Edge الذي يعمل على جهاز وIoT Hub. يتم تعيين الخصائص المطلوبة عند تطبيق بيان التوزيع على جهاز معين كجزء من توزيع جهاز واحد أو على نطاق توزيع واسع.
| الخاصية | الوصف | مطلوب |
|---|---|---|
| نهج وحدة معالجة الصورة | تحديد وقت سحب الصورة: OnCreate أو Never. استخدم أبدا إذا كانت الصورة موجودة بالفعل على الجهاز. | نعم |
| إعادة تشغيل النهج | متى يجب إعادة تشغيل الوحدة النمطية. القيم المحتملة هي: أبدا: لا تقم بإعادة تشغيل الوحدة النمطية إذا لم تكن قيد التشغيل، دائما: إعادة تشغيل الوحدة النمطية دائما إذا لم تكن قيد التشغيل، تشغيل غير صحي: إعادة تشغيل الوحدة النمطية إذا كانت غير صحية. غير سليم هو ما تقارير Docker استنادا إلى فحص السلامة، على سبيل المثال "غير صحية - الحاوية لا تعمل بشكل صحيح"، عند الفشل: إعادة التشغيل إذا فشل. | نعم |
| نوع. وقت التشغيل | يجب أن يكون docker. | نعم |
| وقت التشغيل.الخاص بإعداد إصدار Docker | يحدد الحد الأدنى لإصدار Docker المطلوب بواسطة بيان النشر هذا. | نعم |
| خيارات إعدادات تسجيل الدخول في وقت التشغيل | يحدد JSON سلسلة مع خيارات التسجيل لحاوية عامل IoT Edge. تعرف على المزيد حول خيارات تسجيل Docker. | لا |
| runtime.settings.registryCredentials. {registryId}.username | يحدد اسم المستخدم الخاص بسجل الحاوية. بالنسبة لـAzure Container Registry، يكون اسم المستخدم عادة هو اسم التسجيل. بيانات اعتماد السجل مطلوبة لصور الوحدة النمطية الخاصة. | لا |
| runtime.settings.registryCredentials. {registryId}.password | رمز الوصول الخاص بتسجيل الحاوية. | لا |
| runtime.settings.registryCredentials. {registryId}.address | عنوان التسجيل الخاص بالحاوية. بالنسبة إلى Azure Container Registry، يكون العنوان عادة {registry name}.azurecr.io. | لا |
| إصدار المخطط | يحدد إما 1.0 أو 1.1. يوصى بالإصدار 1.1، المقدم مع الإصدار 1.0.10 من IoT Edge. | نعم |
| الحالة | الحالة المطلوبة للوحدة النمطية: قيد التشغيل أو متوقف. | مطلوب |
| systemModules.edgeAgent.type | يجب أن يكون docker. | نعم |
| systemModules.edgeAgent.startupOrder | تحديد عدد صحيح لموضع الوحدة النمطية في ترتيب بدء التشغيل. 0 هو الأول، والحد الأقصى لعدد صحيح (4294967295) هو الأخير. إذا لم يتم توفير أي قيمة، يكون الافتراضي هو الحد الأقصى لعدد صحيح. | لا |
| systemModules.edgeAgent.settings.image | تحديد URI لصورة عامل IoT Edge. لا يمكن لعامل IoT Edge تحديث نفسه. | نعم |
| systemModules.edgeAgent.settings.createOptions | يحدد JSON سلسلة مع خيارات لإنشاء حاوية عامل IoT Edge. تعرف على المزيد حول خيارات إنشاء Docker. | لا |
| systemModules.edgeAgent.configuration.id | معرف التوزيع الذي يوزع هذه الوحدة النمطية. | يقوم مركز IoT بتعيين هذه الخاصية عند تطبيق البيان باستخدام التوزيع. ليس جزءا من بيان التوزيع. |
| systemModules.edgeHub.type | يجب أن يكون docker. | نعم |
| systemModules.edgeHub.status | يجب أن يكون قيد التشغيل. | نعم |
| systemModules.edgeHub.restartPolicy | يجب أن يكون دائما. | نعم |
| systemModules.edgeHub.startupOrder | القيمة الخاصة بعدد صحيح تحتوي على موضع في الوحدة النمطية بترتيب بدء التشغيل. القيمة 0 هي الأولى والحد الأقصى لعدد صحيح (4294967295) هو الأخير. إذا لم يتم توفير قيمة، فإن القيمة الافتراضية هي الحد الأقصى للعدد الصحيح. | لا |
| systemModules.edgeHub.settings.image | URI الصورة الخاصة بمركز IoT Edge. | نعم |
| systemModules.edgeHub.settings.createOptions | JSON سلسلة تحتوي على خيارات لإنشاء حاوية مركز IoT الحاوية. خيارات إنشاء Docker | لا |
| systemModules.edgeHub.configuration.id | معرف التوزيع الذي يوزع هذه الوحدة النمطية. | يقوم مركز IoT بتعيين هذه الخاصية عند تطبيق البيان باستخدام التوزيع. ليس جزءا من بيان التوزيع. |
| وحدات. {moduleId}.version | سلسلة الخاصة بالمعرف من قبل المستخدم تمثل إصدار هذه الوحدة النمطية. | نعم |
| وحدات. {moduleId}.type | يجب أن يكون docker. | نعم |
| وحدات. {moduleId}.status | {تم إيقاف التشغيل | } | نعم |
| وحدات. {moduleId}.restartPolicy | {أبدا دائما | } | نعم |
| وحدات. {moduleId}.startupOrder | قيمة عدد صحيح للموقع الذي تحتوي عليه الوحدة النمطية في ترتيب بدء التشغيل. القيمة 0 هي الأولى والحد الأقصى لعدد صحيح (4294967295) هو الأخير. إذا لم يتم توفير قيمة، فإن القيمة الافتراضية هي الحد الأقصى للعدد الصحيح. | لا |
| وحدات. {moduleId}.imagePullPolicy | {عند الإنشاء | أبدا} | لا |
| وحدات. {moduleId}.env | قائمة متغيرات البيئة لتمريرها إلى الوحدة النمطية. يأخذ التنسيق "<name>": {"value": "<value>"}. |
لا |
| وحدات. {moduleId}.settings.image | URI إلى الصورة الخاصة بالوحدة النمطية. | نعم |
| وحدات. {moduleId}.settings.createOptions | JSON سلسلة تحتوي على خيارات لإنشاء حاوية خاصة بالوحدة النمطية. خيارات إنشاء Docker | لا |
| وحدات. {moduleId}.configuration.id | معرف التوزيع الذي يوزع هذه الوحدة النمطية. | يقوم مركز IoT بتعيين هذه الخاصية عند تطبيق البيان باستخدام التوزيع. ليس جزءا من بيان التوزيع. |
| إصدار | التكرار الحالي الذي يحتوي على إصدار وتثبيت وبناء. | لا |
EdgeAgent الخصائص المبلغ عنها
تتضمن الخصائص المبلغ عنها لعامل IoT Edge ثلاثة أجزاء رئيسية من المعلومات:
- حالة تطبيق آخر الخصائص المطلوبة التي تمت رؤيتها،
- حالة الوحدات النمطية التي تعمل حاليا على الجهاز كما تم الإبلاغ عنها من قبل عامل IoT Edge، و
- نسخة من الخصائص المطلوبة قيد التشغيل حاليا على الجهاز.
تساعد نسخة الخصائص المطلوبة الحالية في تحديد ما إذا كان الجهاز قد طبق أحدث عملية نشر أو لا يزال يقوم بتشغيل بيان نشر سابق.
إشعار
يمكنك الاستعلام عن الخصائص التي أبلغ عنها عامل IoT Edge باستخدام لغة استعلام IoT Hub للتحقيق في حالة النشر على نطاق واسع. تعرف على كيفية استخدام خصائص عامل IoT Edge للحالة في فهم عمليات توزيع IoT Edge للأجهزة الفردية أو على نطاق واسع.
لا يتضمن الجدول التالي المعلومات التي يتم نسخها من الخصائص المطلوبة.
| الخاصية | الوصف |
|---|---|
| lastDesiredStatus.code | رمز الحالة لآخر الخصائص المطلوبة التي يراها عامل IoT Edge. القيم المسموح بها: 200 نجاح، 400 تكوين غير صالح، 412 إصدار مخطط غير صالح، 417 الخصائص المطلوبة فارغة، 500 فاشلة. |
| وصف lastDesiredStatus. | الوصف النصي الخاص بالحالة. |
| lastDesiredVersion | يشير هذا العدد الصحيح إلى الإصدار الأخير من الخصائص المطلوبة معالجتها بواسطة عامل IoT Edge. |
| runtime.platform.OS | يبلغ عن نظام التشغيل الذي يعمل على الجهاز. |
| runtime.platform.architecture | يبلغ عن بنية وحدة المعالجة المركزية على الجهاز. |
| إصدار المخطط | إصدار المخطط للخصائص التي تم الإبلاغ عنها. |
| systemModules.edgeAgent.runtimeStatus | الحالة المبلغ عنها لعامل IoT Edge: {running | unhealthy}. |
| systemModules.edgeAgent.statusDescription | وصف نصي للحالة المبلغ عنها عامل IoT Edge. |
| systemModules.edgeAgent.exitCode | رمز الخروج الذي تم الإبلاغ عنه بواسطة حاوية عامل IoT Edge إذا خرجت الحاوية. |
| systemModules.edgeAgent.lastStartTimeUtc | الوقت الذي بدأ فيه عامل IoT Edge آخر مرة. |
| systemModules.edgeAgent.lastExitTimeUtc | الوقت الذي تم فيه إنهاء عامل IoT Edge آخر مرة. |
| systemModules.edgeHub.runtimeStatus | حالة مركز IoT Edge: فشل التراجع غير السليم {قيد التشغيل | | | | }. |
| systemModules.edgeHub.statusDescription | وصف نصي لحالة مركز IoT Edge، إذا كان غير سليم. |
| systemModules.edgeHub.exitCode | رمز الخروج الذي تم الإبلاغ عنه بواسطة حاوية مركز IoT Edge، إذا خرجت الحاوية. |
| systemModules.edgeHub.lastStartTimeUtc | الوقت الذي تم فيه تشغيل مركز IoT Edge آخر مرة. |
| systemModules.edgeHub.lastExitTimeUtc | الوقت الذي تم فيه إنهاء مركز IoT Edge آخر مرة. |
| systemModules.edgeHub.lastRestartTimeUtc | الوقت الذي تم فيه إعادة تشغيل مركز IoT Edge آخر مرة. |
| systemModules.edgeHub.restartCount | عدد المرات التي تمت فيها إعادة تشغيل هذه الوحدة النمطية كجزء من نهج إعادة التشغيل. |
| وحدات. {moduleId}.runtimeStatus | حالة الوحدة النمطية: فشل |
| وحدات. {moduleId}.statusDescription | وصف نصي لحالة الوحدة النمطية، إذا كان غير سليم. |
| وحدات. {moduleId}.exitCode | التعليمة البرمجية للخروج التي تم الإبلاغ عنها بواسطة حاوية الوحدة النمطية، إذا تم إنهاء الحاوية. |
| وحدات. {moduleId}.lastStartTimeUtc | الوقت الذي تم فيه التشغيل الخاص بالوحدة النمطية آخر مرة. |
| وحدات. {moduleId}.lastExitTimeUtc | الوقت الذي تم فيه إنهاء الوحدة النمطية آخر مرة. |
| وحدات. {moduleId}.lastRestartTimeUtc | الوقت الذي تم فيه إعادة التشغيل الخاص بالوحدة النمطية آخر مرة. |
| وحدات. {moduleId}.restartCount | عدد المرات التي تمت فيها إعادة تشغيل هذه الوحدة النمطية كجزء من نهج إعادة التشغيل. |
| إصدار | إصدار الصورة. مثال: "version": { "version": "1.2.7", "build": "50979330", "commit": "d3ec971caa0af0fc39d2c1f91aef21e95bd0c03c" }. |
الخصائص المطلوبة لمركز الحافة
يتم استدعاء الوحدة النمطية المزدوجة لعامل IoT Edge$edgeHubوإحداثيات الاتصالات بين عامل IoT Edge الذي يشغل على الجهاز وIoT Hub. يتم تعيين الخصائص المطلوبة عند تطبيق بيان التوزيع على جهاز معين كجزء من توزيع جهاز واحد أو على نطاق توزيع واسع.
| الخاصية | الوصف | المطلوب في بيان التوزيع |
|---|---|---|
| إصدار المخطط | إما 1.0 أو 1.1. تم تقديم الإصدار 1.1 مع IoT Edge الإصدار 1.0.10 ، ويوصى به. | نعم |
| طرق. {routeName} | سلسلة تمثل مسار مركز IoT Edge. لمزيد من المعلومات، راجع تعريف المسارات. |
routes يمكن أن يكون العنصر موجودا ولكنه فارغ. |
| storeAndForwardConfiguration.timeToLiveSecs | وقت الجهاز بالثوان الذي يحتفظ فيه مركز IoT Edge بالرسائل إذا تم قطع اتصاله بنقاط نهاية التوجيه، سواء كان IoT Hub أو وحدة نمطية محلية. يستمر هذا الوقت عبر أي إيقاف تشغيل أو إعادة تشغيل. لمزيد من المعلومات، راجع قدرات دون اتصال. | نعم |
الخصائص مركز الحافة المبلغ عنها
| الخاصية | الوصف |
|---|---|
| lastDesiredVersion | يشير هذا العدد الصحيح إلى الإصدار الأخير من الخصائص المطلوبة معالجتها بواسطة مركز IoT Edge. |
| lastDesiredStatus.code | تعليمة برمجية الحالة يشير إلى آخر الخصائص المطلوبة التي يشاهدها مركز IoT Edge. القيم المسموح بها: 200 نجاح، 400 تكوين غير صالح، 500 فشل |
| وصف lastDesiredStatus. | الوصف النصي الخاص بالحالة. |
| العملاء | جميع العملاء المتصلين ب edgeHub بالحالة وآخر وقت متصل. مثال: "العملاء": { "device2/SimulatedTemperatureSensor": { "status": "Connected", "lastConnectedTimeUtc": "2022-11-17T21:49:16.4781564Z" } }. |
| العملاء. {device or moduleId}.status | حالة الاتصال الخاصة بهذا الجهاز أو الوحدة النمطية. القيم المحتملة {connected | disconnected}. يمكن أن تكون الهويات الخاصة بالوحدة النمطية فقط في حالة قطع الاتصال. تظهر أجهزة انتقال البيانات من الخادم المتلقين للمعلومات المتصل إلى مركز IoT Edge فقط عند الاتصال. |
| العملاء. {device or moduleId}.lastConnectTime | آخر وقت اتصل فيه الجهاز أو الوحدة النمطية. |
| العملاء. {device or moduleId}.lastDisconnectTime | آخر وقت تم قطع اتصال الجهاز أو الوحدة النمطية. |
| إصدار المخطط | إصدار المخطط للخصائص التي تم الإبلاغ عنها. |
| إصدار | إصدار الصورة. مثال: "version": { "version": "1.2.7", "build": "50979330", "commit": "d3ec971caa0af0fc39d2c1f91aef21e95bd0c03c" }. |
الخطوات التالية
لمعرفة كيفية استخدام هذه الخصائص لإنشاء بيانات النشر، راجع فهم كيفية استخدام وحدات IoT Edge وتكوينها وإعادة استخدامها.