مشاركة عبر

تحديث IoT Edge

  • مقالة

ينطبق على: علامة اختيار IoT Edge 1.5 IoT Edge 1.5 علامة اختيار IoT Edge 1.4 IoT Edge 1.4

هام

IoT Edge 1.5 LTS وIoT Edge 1.4 LTS هي إصدارات مدعومة. IoT Edge 1.4 LTS هو نهاية العمر الافتراضي في 12 نوفمبر 2024.

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

يجب تحديث مكونين منطقيين لجهاز IoT Edge إذا كنت تريد الانتقال إلى إصدار أحدث.

  • نظام الأمان الفرعي - يعمل على الجهاز، ويعالج المهام المستندة إلى الأمان، ويبدأ الوحدات النمطية عند بدء تشغيل الجهاز. لا يمكن تحديث نظام الأمان الفرعي إلا من الجهاز نفسه.

  • وقت تشغيل IoT Edge - يتكون وقت تشغيل IoT Edge من الوحدات النمطية لمركز IoT Edge (edgeHub) وعامل IoT Edge (edgeAgent). اعتمادا على كيفية تنظيم التوزيع الخاص بك، يمكن تحديث وقت التشغيل إما من الجهاز أو عن بعد.

كيفية عمل التحديث

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

إصدارات التصحيح

عند الترقية بين إصدارات التصحيح ، على سبيل المثال 1.4.1 إلى 1.4.2، لا يكون ترتيب التحديث مهما. يمكنك ترقية نظام الأمان الفرعي أو حاويات وقت التشغيل قبل الآخر أو بعده. للتحديث بين إصدارات التصحيح:

  1. تحديث النظام الفرعي للأمان
  2. تحديث حاويات وقت التشغيل
  3. التحقق من تطابق الإصدارات

يمكنك استكشاف أخطاء عملية الترقية وإصلاحها في أي وقت.

الإصدارات الرئيسية أو الثانوية

عند الترقية بين الإصدارات الرئيسية أو الثانوية، على سبيل المثال من 1.4 إلى 1.5، قم بتحديث كل من نظام الأمان الفرعي وحاويات وقت التشغيل. قبل الإصدار، نختبر نظام الأمان الفرعي ومجموعة إصدار حاوية وقت التشغيل. للتحديث بين إصدارات المنتجات الرئيسية أو الثانوية:

  1. على الجهاز، أوقف IoT Edge باستخدام الأمر sudo systemctl stop iotedge وقم بإلغاء التثبيت.

  2. على الجهاز، قم بترقية محرك الحاوية، إما Docker أو Moby.

  3. على الجهاز، قم بتثبيت IoT Edge.

    إذا كنت تقوم باستيراد تكوين قديم باستخدام iotedge config import، فقم بتعديل صورة [agent.config] للملف الذي تم /etc/aziot/config.toml إنشاؤه لاستخدام الصورة 1.4 ل edgeAgent.

    لمزيد من المعلومات، راجع تكوين إعدادات جهاز IoT Edge.

  4. في IoT Hub، قم بتحديث نشر الوحدة النمطية للإشارة إلى أحدث وحدات النظام.

  5. على الجهاز، ابدأ تشغيل IoT Edge باستخدام sudo iotedge config apply.

يمكنك استكشاف أخطاء عملية الترقية وإصلاحها في أي وقت.

تحديث النظام الفرعي للأمان

يتضمن النظام الفرعي لأمان IoT Edge مجموعة من المكونات الأصلية التي تحتاج إلى تحديث باستخدام مدير الحزمة على جهاز IoT Edge.

تحقق من إصدار نظام الأمان الفرعي الذي يعمل على جهازك باستخدام الأمر iotedge version. إذا كنت تستخدم IoT Edge ل Linux على Windows، فأنت بحاجة إلى SSH في الجهاز الظاهري Linux للتحقق من الإصدار.

على أجهزة Linux x64، استخدم apt-get أو مدير الحزم المناسب لتحديث النظام الفرعي للأمان إلى أحدث إصدار.

تحديث apt:

sudo apt-get update

إشعار

للحصول على إرشادات للحصول على أحدث تكوين مستودع من Microsoft، راجع الخطوات الأولية لتثبيت IoT Edge.

تحقق لمعرفة إصدارات IoT Edge المتوفرة:

apt list -a aziot-edge

تحديث IoT Edge:

sudo apt-get install aziot-edge defender-iot-micro-agent-edge

يؤدي تشغيل apt-get install aziot-edge إلى ترقية النظام الفرعي للأمان وتثبيت خدمة الهوية، aziot-identity-service، كتبعية مطلوبة.

يوصى بتثبيت العامل الصغير مع عامل Edge لتمكين مراقبة الأمان وتصلب أجهزة Edge. لمعرفة المزيد حول Microsoft Defender for IoT، راجع ما هو Microsoft Defender for IoT لمنشئي الأجهزة.

ثم أعد تطبيق التكوين لضمان تحديث النظام بالكامل.

sudo iotedge config apply

تحديث حاويات وقت التشغيل

تعتمد الطريقة التي تقوم بها بتحديث عامل IoT Edge وحاويات مركز IoT Edge على ما إذا كنت تستخدم علامات المتداول (مثل 1.5) أو علامات محددة (مثل 1.5.1) في النشر الخاص بك.

تحقق من إصدار عامل IoT Edge والوحدات النمطية لمركز IoT Edge حاليا على جهازك باستخدام الأوامر iotedge logs edgeAgent أو iotedge logs edgeHub. إذا كنت تستخدم IoT Edge ل Linux على Windows، فأنت بحاجة إلى SSH في الجهاز الظاهري Linux للتحقق من إصدارات وحدة وقت التشغيل.

لقطة شاشة لمكان العثور على إصدار الحاوية في سجلات وحدة التحكم.

فهم علامات IoT Edge

يتم وضع علامة على صور عامل IoT Edge وصور مركز IoT Edge بإصدار IoT Edge الذي يرتبطان به. هناك طريقتان مختلفتان لاستخدام العلامات مع نسح وقت التشغيل:

  • العلامات المتداولة - استخدم القيمتين الأوليين فقط من رقم الإصدار للحصول على أحدث صورة تطابق تلك الأرقام. على سبيل المثال، يتم تحديث 1.5 كلما كان هناك إصدار جديد للإشارة إلى أحدث إصدار 1.5.x. إذا كان وقت تشغيل الحاوية على جهاز IoT Edge يسحب الصورة مرة أخرى، يتم تحديث وحدات وقت التشغيل إلى أحدث إصدار. عمليات التوزيع من مدخل Microsoft Azure الافتراضي إلى المتداول العلامات. ويقترح هذا النهج لأغراض التنمية.

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

تحديث صورة علامة متجددة

إذا كنت تستخدم العلامات المتداولة في التوزيع الخاص بك (على سبيل المثال، mcr.microsoft.com/azureiotedge-hub:1.5) فأنت بحاجة إلى فرض وقت تشغيل الحاوية على جهازك لسحب أحدث إصدار من الصورة.

احذف الإصدار المحلي للصورة من جهاز IoT Edge. على أجهزة Windows، يؤدي إلغاء تثبيت النظام الفرعي للأمان أيضا إلى إزالة صور وقت التشغيل، لذلك لا تحتاج إلى اتخاذ هذه الخطوة مرة أخرى.

docker rmi mcr.microsoft.com/azureiotedge-hub:1.5
docker rmi mcr.microsoft.com/azureiotedge-agent:1.5

قد تحتاج إلى استخدام علامة القوة -f لإزالة الصور.

تسحب خدمة IoT Edge أحدث إصدارات صور وقت التشغيل وتبدأها تلقائيا على جهازك مرة أخرى.

تحديث صورة علامة معينة

إذا كنت تستخدم علامات معينة في النشر (على سبيل المثال، mcr.microsoft.com/azureiotedge-hub:1.4) فإن كل ما عليك القيام به هو تحديث العلامة في بيان التوزيع وتطبيق التغييرات على جهازك.

  1. في مركز IoT في مدخل Microsoft Azure، حدد جهاز IoT Edge، وحدد تعيين الوحدات النمطية.

  2. في علامة التبويب Modules، حدد Runtime Settings.

  3. في إعدادات وقت التشغيل، قم بتحديث قيمة Image URI في قسم Edge Agent بالإصدار المطلوب. على سبيل المثال، mcr.microsoft.com/azureiotedge-agent:1.5 لا تحدد تطبيق بعد.

  4. حدد علامة التبويب Edge Hub وقم بتحديث قيمة Image URI بنفس الإصدار المطلوب. على سبيل المثال، mcr.microsoft.com/azureiotedge-hub:1.5

  5. حدد تطبيق لحفظ التغييرات.

  6. حدد Review + create، وراجع التوزيع كما يظهر في ملف JSON، وحدد Create.

تحديث معرفات URI لوحدة الشريك

إذا كنت تستخدم وحدات الشركاء النمطية، فقم بتحديث عمليات نشر الوحدة النمطية الخاصة بك بعناوين URL للصورة التي يوفرها الشريك. اتصل بناشر وحدة IoT Edge للحصول على عنوان URI لصورة الحاوية المحدثة. قم بتحديث تكوينات جهازك باستخدام URI للصورة الجديدة التي يوفرها الناشر.

  1. سجل الدخول إلى مدخل Microsoft Azure وانتقل إلى IoT Hub.
  2. في الجزء الأيمن، حدد الأجهزة ضمن قائمة إدارة الأجهزة.
  3. حدد جهاز IoT Edge الذي يستخدم وحدة الشريك من القائمة.
  4. في الشريط العلوي، حدد "Set Modules".
  5. اختر الوحدة النمطية لشريك IoT Edge التي تريد تحديثها باستخدام URI للصورة الجديدة.
  6. قم بتحديث قيمة Image URI بالصورة الجديدة URI التي يوفرها الناشر.
  7. حدد تطبيق لحفظ التغييرات.
  8. حدد Review + create، وراجع التوزيع كما يظهر في ملف JSON، وحدد Create.

التحقق من تطابق الإصدارات

  1. على جهازك، استخدم iotedge version للتحقق من إصدار النظام الفرعي للأمان. يتضمن الإخراج أرقام الإصدارات الرئيسية والثانوية والمراجعة. على سبيل المثال، iotedge 1.4.2.

  2. في إعدادات وقت تشغيل نشر الجهاز، تحقق من تطابق إصدارات URI للصورة edgeHub وedgeAgent مع الإصدار الرئيسي والثانوي من نظام الأمان الفرعي. إذا كان إصدار النظام الفرعي للأمان هو 1.4.2، فإن إصدارات الصورة ستكون 1.4. على سبيل المثال، mcr.microsoft.com/azureiotedge-hub:1.4 mcr.microsoft.com/azureiotedge-agent:1.4.

إشعار

تحديث النظام الفرعي لأمان IoT Edge وحاويات وقت التشغيل إلى نفس إصدار الإصدار المدعوم. بينما يتم دعم الإصدارات غير المتطابقة، لم نختبر جميع مجموعات الإصدارات.

للعثور على أحدث إصدار من Azure IoT Edge، راجع إصدارات Azure IoT Edge.

استكشاف الأخطاء وإصلاحها

يمكنك عرض سجلات النظام في أي وقت عن طريق تشغيل الأوامر التالية من جهازك.

  • ابدأ استكشاف الأخطاء وإصلاحها باستخدام أمر التحقق . يقوم بتشغيل مجموعة من اختبارات التكوين والاتصال للمشكلات الشائعة.

    sudo iotedge check --verbose

  • لعرض حالة نظام IoT Edge، قم بتشغيل:

    sudo iotedge system status

  • لعرض سجلات مكونات المضيف، قم بتشغيل:

    sudo iotedge system logs

  • للتحقق من وجود مشكلات متكررة تم الإبلاغ عنها مع edgeAgent وedgeHub، قم بتشغيل:

    تأكد من استبدال <module> باسم الوحدة النمطية الخاصة بك. إذا لم تكن هناك مشكلات، فلن ترى أي إخراج.

    sudo iotedge logs <module>

لمزيد من المعلومات، راجع استكشاف أخطاء جهاز IoT Edge وإصلاحها.

الخطوات التالية

عرض أحدث إصدارات Azure IoT Edge.

البقاء على اطلاع دائم بالتحديثات والإعلانات الأخيرة في مدونة إنترنت الأشياء