استيراد تحديث إلى Device Update من أجل IoT Hub

تعلم كيفية الحصول على تحديث جديد واستيراده إلى Device Update من أجل IoT Hub. في حال لم تكن قد قمت بالفعل، فتأكد من مراجعة مفاهيم الاستيراد الرئيسية وكيفية إعداد تحديث ليتم استيراده.

المتطلبات الأساسية

• الوصول إلى IoT Hub مع تمكين Device Update ل IoT Hub.
• جهاز IoT (أو جهاز محاكاة) تم يتم تكوين إعدادات تشغيله لـ Device Update داخل IoT Hub.
• اتبع الخطوات الواردة في إعداد تحديث للاستيراد إلى Device Update ل IoT Hub لإنشاء بيان الاستيراد لملفات التحديث الخاصة بك.

مدخل Microsoft Azure

المستعرضات المدعومة:

• Microsoft Edge
• Google Chrome

Azure CLI

بيئة Azure CLI:

• استخدم بيئة Bash في Azure Cloud Shell.

  

• أو، إذا كنت تفضل تشغيل أوامر مرجع CLI محليًا قم بتثبيت CLI Azure

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

تلميح

تستخدم أوامر Azure CLI في هذه المقالة حرف خط مائل \ عكسي لمتابعة السطر بحيث تكون وسيطات الأمر أسهل في القراءة. يعمل بناء الجملة هذا في بيئات Bash. إذا كنت تقوم بتشغيل هذه الأوامر في PowerShell، فاستبدل كل مائل عكسي بخلفية ''، أو قم بإزالتها بالكامل.

استيراد تحديث

يوضح هذا القسم كيفية استيراد تحديث باستخدام مدخل Azure أو Azure CLI. بإمكانك أيضًا استخدام تحديث الجهاز لواجهات برمجة تطبيقات IoT Hub لاستيراد تحديث بدلًا من ذلك.

لاستيراد تحديث، يمكنك أولا تحميل ملفات التحديث واستيراد بيان إلى حاوية Azure Storage. بعد ذلك، يمكنك استيراد التحديث من Azure Storage إلى Device Update ل IoT Hub، حيث سيتم تخزينه للنشر على الأجهزة.

مدخل Microsoft Azure

1. في مدخل Microsoft Azure، انتقل إلى IoT Hub الخاص بك باستخدام Device Update.

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

   

3. حدد علامة التبويب التحديثات من قائمة علامات التبويب في أعلى الشاشة.

   

4. حدد + استيراد تحديث جديد أسفل عنوان التحديثات المتوفرة.

   

5. حدد + Select from storage container. يتم عرض واجهة المستخدم لحسابات التخزين. حدد حسابا موجودا، أو أنشئ حسابا باستخدام + Storage account. يستخدم هذا الحساب لحاوية لعرض تحديثاتك للاستيراد. يجب ألا يكون للحساب نقاط نهاية عامة وخاصة ممكنة في نفس الوقت.

   

6. بمجرد اختيار حساب تخزين، يتم عرض واجهة مستخدم الحاويات. حدد حاوية موجودة، أو أنشئ حاوية باستخدام + Container. يتم استخدام هذه الحاوية لتنظيم ملفات التحديث الخاصة بك لاستيرادها

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

   

7. في الحاوية الخاصة بك، حدد Upload. تعرض واجهة مستخدم التحميل.

   

8. حدد أيقونة المجلد على الجانب الأيسر من قسم الملفات ضمن رأس تحميل كائن ثنائي كبير الحجم. استخدم أداة انتقاء الملفات للانتقال إلى موقع ملفات التحديث واستيراد بيان، وحدد جميع الملفات، ثم حدد فتح. يمكنك الضغط باستمرار فوق المفتاح Shift والنقر لتحديد ملفات متعددة.

   

9. عند تحديد جميع ملفات التحديث، حدد تحميل.

   

10. قم بتحديد الملفات التي تم تحميلها لتعيينها ليتم استيرادها. ثم حدد الزر Select للعودة إلى صفحة Import update.

    

11. في صفحة Import update، راجع الملفات التي ستستورد. بعد ذلك حدد Import update لبدء عملية الاستيراد. لحل أي أخطاء، راجع استكشاف أخطاء تحديث الوكيل وإصلاحها.

    

12. تبدأ عملية الاستيراد وتتغير الشاشة إلى قسم Import History. حدد تحديث لعرض التقدم حتى تكتمل عملية الاستيراد (اعتمادا على حجم التحديث، قد تكتمل العملية في بضع دقائق ولكن قد تستغرق وقتا أطول).

    

13. عندما يشير عمود الحالة إلى نجاح عملية الاستيراد، حدد رأس التحديثات المتوفرة. يجب أن ترى التحديث الذي تم استيراده في القائمة الآن.

    

Azure CLI

يعالج الأمر az iot du update stage الخطوات الأساسية لاستيراد تحديث، بما في ذلك تحميل ملفات التحديث إلى حاوية تخزين مستهدفة. تتيح العلامة الاختيارية أيضا لهذا الأمر استيراد الملفات تلقائيا بعد إعدادها. وإلا، فإن الأمر az iot du update import يكمل العملية.

stage يأخذ الأمر الوسيطات التالية:

• --account: اسم حساب تحديث الجهاز.
• --instance: اسم مثيل تحديث الجهاز.
• --manifest-path: مسار الملف إلى بيان الاستيراد الذي يجب أن يكون مرحلي.
• --storage-account: اسم حساب التخزين لإعداد التحديث.
• --storage-container: اسم الحاوية داخل حساب التخزين المحدد لإعداد التحديث.
• --overwrite: علامة اختيارية تشير إلى ما إذا كان يجب الكتابة فوق الكائنات الثنائية كبيرة الحجم الموجودة في حاوية التخزين إذا كان هناك تعارض.
• --then-import: علامة اختيارية تشير إلى ما إذا كان يجب استيراد التحديث إلى تحديث الجهاز بعد تشغيله مرحلي.

az iot du update stage \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    --manifest-path <Replace with the full path to your import manifest> \
    --storage-account <Replace with your Storage account name> \
    --storage-container <Replace with your container name> \
    --overwrite --then-import

على سبيل المثال:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/file.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

إذا كان لديك العديد من بيانات الاستيراد، يمكنك تضمينها جميعا في أمر واحد. على سبيل المثال:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/parent.importmanifest.json \
    --manifest-path /my/apt/manifest/child1.importmanifest.json \
    --manifest-path /my/apt/manifest/child2.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

إذا لم تستخدم العلامة --then-import ، يتضمن إخراج stage الأمر مطالبة بتشغيل az iot du update import، بما في ذلك الوسيطات التي تم ملؤها مسبقا.

استخدم قائمة az iot du update للتحقق من استيراد التحديث أو التحديثات بنجاح.

az iot du update list \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    -o table

إذا كنت تقوم بالاستيراد باستخدام واجهات برمجة التطبيقات بدلا من ذلك

يمكنك أيضا استيراد تحديث برمجيا عن طريق:

• استخدام Azure SDK لأجل .NET أو Java أو JavaScript أو Python
• استعمال واجهة برمجة تطبيقات REST لتحديث الاستيراد
• استعمال نموذج وحدات PowerShell النمطية
  • يتطلب PowerShell 5 أو أحدث (بما في ذلك تثبيتات Linux وmacOS وWindows)

إشعار

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

يتم تحميل ملفات التحديث وبيان الاستيراد إلى حاوية Azure Storage Blob للتقسيم المرحلي. لاستيراد الملفات المرحلية، قم بتقديم عنوان URL للكائن الثنائي كبير الحجم أو توقيع الوصول المشترك (SAS) للكائنات الثنائية كبيرة الحجم الخاصة، إلى واجهة برمجة تطبيقات تحديث الجهاز. إذا كنت تستخدم SAS، فتأكد من توفير نافذة انتهاء صلاحية من ثلاث ساعات أو أكثر

تلميح

لتحميل ملفات تحديث كبيرة إلى حاوية Azure Storage Blob، بإمكانك استخدام أحد الإجراءات التالية للحصول على أداء أفضل:

• AzCopy
• Azure Storage Explorer

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

• إنشاء مجموعات
• تعرف على مفاهيم الاستيراد