استيراد تحديث إلى Azure Device Update ل IoT Hub

• المستعرضات المدعومة Microsoft Edge أو Google Chrome.

• بيئة Bash.

  يمكنك استخدام بيئة 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. في مدخل Microsoft Azure، في صفحة مركز IoT لمثيل Device Update، حدد Device management>Updates من التنقل الأيسر.

   

2. في صفحة التحديثات ، حدد استيراد تحديث جديد.

   

3. في صفحة Import update ، حدد Select from storage container.

4. في صفحة Storage accounts ، حدد حساب تخزين موجودا أو أنشئ حسابا جديدا عن طريق تحديد Storage account. يمكنك استخدام حساب التخزين لحاوية لإعداد ملفات التحديث.

5. في صفحة Containers ، حدد حاوية موجودة أو أنشئ حاوية جديدة عن طريق تحديد Container. يمكنك استخدام الحاوية لتنظيم ملفات التحديث للاستيراد.

   

   تلميح

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

6. في صفحة الحاوية، حدد Upload.

   

7. في شاشة Upload blob، حدد رمز المجلد بجوار Files. استخدم أداة انتقاء الملفات للانتقال إلى موقع التحديث واستيراد ملفات البيان، وحدد الملفات، ثم حدد فتح. يمكنك استخدام المفتاح Shift لتحديد الملفات متعددة.

   

8. بعد تحديد جميع الملفات، حدد تحميل.

   

9. بعد تحميلها، تظهر الملفات على صفحة الحاوية. في صفحة الحاوية، راجع الملفات المراد استيرادها وحددها، ثم حدد تحديد.

   

10. في شاشة Import update ، حدد Import update.

    

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

يعالج الأمر 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