مشاركة عبر

ترحيل الأجهزة والمجموعات إلى آخر تحديث للجهاز لإصدار IoT Hub

  • مقالة

نظراً لأن Device Update لخدمة IoT Hub تصدر إصدارات جديدة، فسترغب في تحديث أجهزتك للحصول على أحدث الميزات وتحسينات الأمان. توفر هذه المقالة معلومات حول كيفية الترحيل من إصدار [تحديث المعاينة العامة (PPR) إلى إصدار GA الحالي. تشرح هذه المقالة أيضاً سلوك المجموعة وUX عبر هذه الإصدارات. إذا لم يكن لديك أجهزة ومجموعات وتوزيعات تستخدم إصدار تحديث المعاينة العامة، يمكنك تجاهل هذه الصفحة.

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

إشعار

سيتم تغيير جميع مجموعات أجهزة PPR التي تم إنشاؤها تلقائيا إلى مجموعات GA. ستتوفر المجموعات والأجهزة بعد الترحيل. لن يتم ترحيل محفوظات النشر إلى مجموعات التوفر العام المحدثة.

تحديث عامل تحديث الجهاز

بالنسبة لإصدار التوفر العام، يمكن تحديث عامل تحديث الجهاز يدويا أو باستخدام خدمة تحديث الجهاز باستخدام البيان المناسب أو تحديثات الصور. إذا كنت تستخدم تحديثات الصور، يمكنك تضمين عامل GA Device Update في التحديث الخاص بك.

ترقية عامل DU اليدوي

  1. قبل تحديث جهازك، ستتضمن سمات الجهاز تفاصيل طراز PnP PPR. سيظهر اسم نموذج العقد نموذج تحديث الجهاز V1 وسيعرض معرف نموذج العقد dtmi:azure:iot:deviceUpdateContractModel؛ 1.

  2. SSH في جهازك وتحديث عامل تحديث الجهاز.

    sudo apt install deviceupdate-agent
sudo systemctl restart deviceupdate-agent
sudo systemctl status deviceupdate-agent

  3. تأكد من تشغيل عامل DU بشكل صحيح. ابحث عن "HealthCheck passed"

    sudo -u adu /usr/bin/AducIotAgent -h

  4. راجع الجهاز المحدث في مدخل تحديث الجهاز. ستعرض سمات الجهاز الآن تفاصيل طراز PnP المحدثة. سيظهر اسم نموذج العقد نموذج تحديث الجهاز V2 وسيعرض معرف نموذج العقد dtmi:azure:iot:deviceUpdateContractModel؛ 2.

ترقية عامل OTA DU على الرغم من بيان APT

  1. قبل تحديث أجهزتك، ستتضمن سمات الجهاز تفاصيل نموذج PnP PPR. سيظهر اسم نموذج العقد نموذج تحديث الجهاز V1 وسيعرض معرف نموذج العقد dtmi:azure:iot:deviceUpdateContractModel؛ 1.

  2. أضف ترقية عامل تحديث الجهاز كخطوة أخيرة في التحديث. يجب أن يكون إصدار بيان الاستيراد "4.0" للتأكد من أنه مستهدف للأجهزة الصحيحة. انظر أدناه نموذج بيان الاستيراد وبيان APT:

    مثال على بيان الاستيراد

    {
   "manifestVersion": "4",
   "updateId": {
     "provider": "Contoso",
     "name": "Sensor",
     "version": "1.0"
   },
   "compatibility": [
     {
       "manufacturer": "Contoso",
       "model": "Sensor"
     }
   ],
   "instructions": {
     "steps": [
       {
     "handler": "microsoft/apt:1",
     "handlerProperties": {
       "installedCriteria": "1.0"
     },
     "files": [
       "fileId0"
     ]
       }
     ]
   },
   "files": {
     "fileId0": {
       "filename": "sample-upgrade-apt-manifest.json",
       "sizeInBytes": 210,
       "hashes": {
     "sha256": "mcB5SexMU4JOOzqmlJqKbue9qMskWY3EI/iVjJxCtAs="
       }
     }
   },
   "createdDateTime": "2022-08-20T18:32:01.8404544Z"
 }

    مثال على بيان APT

      {
    "name": "Sample DU agent upgrade update",
    "version": "1.0.0",
    "packages": [
    {
        "name": "deviceupdate-agent"
    }
    ]
}

إشعار

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

  1. توزيع التحديث.

  2. بمجرد نشر التحديث بنجاح، ستعرض سمات الجهاز الآن تفاصيل نموذج PnP المحدثة. سيظهر اسم نموذج العقد نموذج تحديث الجهاز V2 وسيعرض معرف نموذج العقد dtmi:azure:iot:deviceUpdateContractModel؛ 2.

سلوك التجميع والتوزيع عبر الإصدارات

  • يمكن إدارة الجهاز الذي يحتوي على عامل تحديث DU للمعاينة العامة (0.8.x) وعامل GA DU (1.0.x) من خلال مدخل تحديث الجهاز.

  • لا يمكن إضافة الأجهزة ذات العوامل الأقدم (0.7.0/0.6.0) إلى هذه المجموعات.

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

التعرف على ملف تكوين عامل Device Update

يمكنك استخدام البرامج التعليمية التالية للحصول على عرض توضيحي بسيط لتحديث الجهاز لـ IoT Hub: