نشر تحديث باستخدام Azure Device Update ل IoT Hub

1. في مدخل Microsoft Azure توجه إلى مركز IoT.

2. حدد التحديثات ضمن إدارة الأجهزة في التنقل الأيمن.

   

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

4. ضمن الحالة في قائمة المجموعة، حدد نشر بجوار تحديث واحد أو أكثر من التحديثات الجديدة المتوفرة لهذه المجموعة.

   

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

6. حدد Deploy بجوار حالة التحديثات المتوفرة واحدة أو أكثر.

7. من القائمة على اليمين، حدد التحديث المطلوب للنشر.

   

8. جدوِل التوزيع للبدء في الحال أو مستقبلًا.

   تلميح

   يكون تاريخ ووقت البدء 24 ساعة من وقتك الحالي بشكل افتراضي. تأكد من تحديد تاريخ ووقت مختلفين إذا كنت تريد بدء النشر عاجلا أم آجلا.

   

9. إنشاء نهج التراجع التلقائي إذا لزم الأمر. وبعد ذلك، حدد إنشاء.

10. في علامة التبويب التحديثات الحالية، يمكنك عرض حالة النشر.

    

11. في طريقة عرض أساسيات المجموعة، يظهر مخطط التوافق أن التحديث قيد التقدم الآن.

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

يمكنك استخدام بيئة Bash في Azure Cloud Shell لتشغيل الأوامر التالية. حدد Launch Cloud Shell لفتح Cloud Shell، أو حدد أيقونة Cloud Shell في شريط الأدوات العلوي من مدخل Microsoft Azure.

أو، إذا كنت تفضل ذلك، يمكنك تشغيل أوامر Azure CLI محليا:

1. تثبيت Azure CLI. قم بتشغيل az version لمشاهدة إصدار Azure CLI المثبت والمكتبات التابعة، وقم بتشغيل ترقية az لتثبيت أحدث إصدار.
2. قم بتسجيل الدخول إلى Azure عن طريق تشغيل az login.
3. قم بتثبيت الملحق azure-iot عند مطالبتك عند الاستخدام الأول. للتأكد من أنك تستخدم أحدث إصدار من الملحق، قم بتشغيل az extension update --name azure-iot.

التحقق من توفر التحديث

1. az iot du device group list استخدم الأمر لتحديد مجموعة أجهزتك.

   az iot du device group list \
       --account <Device Update account name> \
       --instance <Device Update instance name>\
   

2. ثم استخدم az iot du device group show لإظهار أفضل تحديث متوفر لمجموعتك. يأخذ الأمر الوسيطات التالية:

   • --account: اسم حساب تحديث الجهاز.
   • --instance: اسم مثيل تحديث الجهاز.
   • --group-id: معرف مجموعة الأجهزة الذي تستهدفه مع هذا النشر، وهو إما قيمة العلامة ADUGroup ، أو $default للأجهزة التي لا تحتوي على علامة.
   • --resource-group: اسم مجموعة موارد حساب تحديث الجهاز.
   • --best-updates: إرجاع أفضل التحديثات المتوفرة لمجموعة الأجهزة، بما في ذلك عدد الأجهزة التي تحتاج إلى كل تحديث.
   • --update-compliance: إرجاع معلومات التوافق لتحديث مجموعة الأجهزة، مثل عدد الأجهزة الموجودة على آخر تحديث لها، وعدد الأجهزة التي تحتاج إلى تحديثات جديدة، وعدد الأجهزة التي تتلقى حاليا تحديثا جديدا.

   للتحقق من أفضل تحديث متوفر لمجموعتك، قم بتشغيل الأمر كما يلي:

   az iot du device group show \
       --account <Device Update account name> \
       --instance <Device Update instance name>\
       --group-id <device group ID>\
       --best-updates
   

إنشاء النشر

استخدم az iot du device deployment create لإنشاء نشر لمجموعة الأجهزة. يأخذ الأمر الوسيطات التالية:

• --account: اسم حساب تحديث الجهاز.
• --instance: اسم مثيل تحديث الجهاز.
• --group-id: معرف مجموعة الأجهزة الذي تستهدفه مع هذا النشر، وهو إما قيمة العلامة ADUGroup ، أو $default للأجهزة التي لا تحتوي على علامة.
• --deployment-id: معرف لتعريف هذا النشر.
• --update-nameو --update-providerو --update-version: المعلمات التي تحدد updateId الكائن، وهو معرف فريد للتحديث في هذا النشر.

قم بتشغيل الأمر كما يلي:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version>

استخدام الوسيطات الاختيارية

تسمح لك الوسيطات الاختيارية بتكوين النشر بشكل أكبر. للحصول على القائمة الكاملة للوسيطات الاختيارية، راجع المعلمات الاختيارية.

لإنشاء نهج التراجع التلقائي، أضف المعلمات التالية:

• --failed-count: عدد الأجهزة الفاشلة في عملية نشر تؤدي إلى العودة إلى الحالة السابقة.
• --failed-percentage: النسبة المئوية للأجهزة الفاشلة في عملية نشر تؤدي إلى العودة إلى الحالة السابقة.
• --rollback-update-name، --rollback-update-provider، --rollback-update-version: معلمات التحديث لاستخدامها في حالة بدء العودة إلى الحالة السابقة.

قم بتشغيل الأمر كما يلي:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --failed-count 10 \
    --failed-percentage 5 \
    --rollback-update-name <rollback update name> \
    --rollback-update-provider <rollback update provider> \
    --rollback-update-version <rollback update version>

لتعيين وقت بدء النشر، استخدم المعلمة --start-time لتوفير التاريخ والوقت المستهدفين للتوزيع، كما يلي:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --start-time "2022-12-20T01:00:00"

1. في علامة التبويب المجموعات والنشرات في صفحة التحديثات ، حدد المجموعة التي قمت بالنشر إليها.

2. في صفحة تفاصيل المجموعة، انتقل إلى علامة التبويب التوزيع الحالي أو محفوظات النشر للتأكد من أن عملية التوزيع قيد التقدم.

   

3. حدد Details بجوار التوزيع لعرض تفاصيل التوزيع وتفاصيل التحديث وتفاصيل فئة الجهاز الهدف. يمكنك اختياريا إضافة اسم مألوف لفئة الجهاز.

4. حدد "تحديث" لعرض تفاصيل الحالة الأخيرة.

   

انتقل إلى علامة التبويب أساسيات المجموعة في صفحة تفاصيل المجموعة للبحث عن حالة جهاز معين، أو قم بالتصفية لعرض الأجهزة التي فشلت في النشر.

استخدم az iot du device deployment list لعرض جميع عمليات التوزيع لمجموعة الأجهزة.

az iot du device deployment list \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id>

استخدم az iot du device deployment show لعرض تفاصيل توزيع معين.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID>

أضف العلامة --status لإرجاع معلومات حول عدد الأجهزة قيد التقدم أو المكتملة أو الفاشلة.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --status

1. انتقل إلى علامة التبويب "التوزيع الحالي" على شاشة "تفاصيل المجموعة".

2. حدد "إعادة محاولة الأجهزة الفاشلة" وأقر بإشعار التأكيد.

استخدم az iot du device deployment retry لإعادة محاولة توزيع لمجموعة فرعية مستهدفة من الأجهزة.

يأخذ هذا الأمر الوسيطة --class-id التي يتم إنشاؤها من معرف النموذج وخصائص التوافق التي أبلغ عنها عامل تحديث الجهاز.

az iot du device deployment retry \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --deployment-id <deployment ID> \
    --group-id <device group ID> \
    --class-id <device class ID>