التشغيل السريع: توزيع وحدة IoT Edge النمطية خاصتك الأولى على جهاز Windows

ينطبق على: IoT Edge 1.5 IoT Edge 1.4

هام

IoT Edge 1.5 LTS وIoT Edge 1.4 LTS هي إصدارات مدعومة. IoT Edge 1.4 LTS هو نهاية العمر الافتراضي في 12 نوفمبر 2024. إذا كنت تستخدم إصدارا سابقا، فشاهد تحديث IoT Edge.

جرِّب Azure IoT Edge في هذا التشغيل السريع عن طريق نشر التعليمات البرمجية المعبأة في حاويات إلى Linux على جهاز IoT Edge يعمل بنظام التشغيل Windows. يُتيح لك IoT Edge إدارة التعليمات البرمجية على أجهزتك عن بعد حتى يُمكنك إرسال المزيد من أحمال العمل الخاصة بك إلى الحافة. لهذا التشغيل السريع، نوصي باستخدام جهاز عميل Windows الخاص بك لمعرفة مدى سهولة استخدام Azure IoT Edge ل Linux على Windows. إذا كنت ترغب في استخدام Windows Server أو Azure VM لإنشاء النشر الخاص بك، فاتبع الخطوات الواردة في دليل الكيفية حول تثبيت Azure IoT Edge لنظام التشغيل Linux وتوفيره على جهاز Windows.

في هذا التشغيل السريع، ستتعلم كيفية:

• إنشاء مركز IoT.
• تسجيل جهاز IoT Edge في مركز IoT الخاص بك.
• تثبيت IoT Edge لـ Linux على وقت تشغيل Windows وبدء تشغيله على جهازك.
• نشر وحدة نمطية عن بعد إلى جهاز IoT Edge عن بُعد وإرسال بيانات تتبع الاستخدام.

يُوجّهك هذا التشغيل السريع خلال كيفية إعداد Azure IoT Edge لـ Linux على جهاز Windows الخاص بك. بعد ذلك، ستقوم بنشر وحدة نمطية من مدخل Azure إلى جهازك. الوحدة النمطية التي ستستخدمها عبارة عن أداة استشعار للمحاكاة تُنشئ بيانات درجة الحرارة، والرطوبة والضغط. تستكمل برامج Azure IoT Edge التعليمية الأخرى العمل الذي تقوم به هنا من خلال نشر الوحدات النمطية التي تُحلل البيانات التي تمت محاكاتها لرؤى الأعمال.

في حال لم يكن لديك اشتراك Azure نشط، يُمكنك إنشاء حساب مجاني قبل البدء.

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

تحضير البيئة الخاصة بك لـAzure CLI.

• استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع التشغيل السريع ل Bash في Azure Cloud Shell.

  

• إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.

  • إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.

  • عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.

  • يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.

قم بإنشاء مجموعة موارد السحابة لإدارة جميع الموارد التي ستستخدمها في هذا التشغيل السريع.

az group create --name IoTEdgeResources --location westus2

تأكّد من أن جهاز IoT Edge الخاص بك يُلبّي المتطلبات التالية:

• متطلبات النظام

  • Windows 10¹/11 (Pro, Enterprise, IoT Enterprise) _{¹ Windows 10 الحد الأدنى للإصدار 17763 مع تثبيت جميع التحديثات التراكمية الحالية.}

• متطلبات الجهاز

  • الحدّ الأدنى للذاكرة الحرة: 1 غيغابايت
  • الحدّ الأدنى للمساحة الفارغة على القرص: 10 غيغابايت

إنشاء مركز IoT

ابدأ بإنشاء مركز IoT باستخدام Azure CLI.

يعمل المستوى المجاني من Azure IoT Hub لهذا التشغيل السريع. إذا كنت قد استخدمت IoT Hub في الماضي ولديك مركز مُنشأ بالفعل، يُمكنك استخدام مركز IoT هذا.

تعمل التعليمات البرمجية التالية على إنشاء مركز F1 مجاني في مجموعة الموارد IoTEdgeResources. استبدل {hub_name} باسم فريد لـ IoT hub. قد يستغرق إنشاء مركز IoT بضع دقائق.

az iot hub create --resource-group IoTEdgeResources --name {hub_name} --sku F1 --partition-count 2

إذا حدث خطأ ما لأن لديك مركزاً مجانياً واحداً بالفعل في اشتراكك، فقم بتغيير وحدة SKU إلى S1. إذا حدث خطأ ما بسبب أن اسم مركز IoT غير متوفّر، يعني ذلك أن شخصاً آخر لديه مركز يحمل هذا الاسم بالفعل. جرب اسماً جديداً.

تسجيل جهاز IoT Edge

سجل جهاز IoT Edge مع IoT hub الذي تم إنشاؤه حديثاً.

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

تعمل أجهزة IoT Edge ويُمكن إدارتها بشكل مختلف عن أجهزة IoT النموذجية. استخدم علامة --edge-enabled لتوضيح أن هذه الهوية خاصة بجهاز IoT Edge.

1. في Azure Cloud Shell، أدخِل الأمر التالي لإنشاء جهاز باسم "myEdgeDevice" في المركز الخاص بك.

   az iot hub device-identity create --device-id myEdgeDevice --edge-enabled --hub-name {hub_name}
   

   إذا حصلت على خطأ بشأن مفاتيح نهج iothubowner، فتأكّد من تشغيل Cloud Shell لأحدث إصدار من ملحق Azure IoT.

2. اعرض سلسلة الاتصال لجهازك، والتي تربط جهازك الفعلي بهويته في IoT Hub. يحتوي على اسم مركز IoT الخاص بك، واسم جهازك، ومفتاح مشترك يعمل على مصادقة الاتصالات بينهما.

   az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name {hub_name}
   

3. انسخ قيمة المفتاح connectionString من ناتج JSON وقم بحفظها. فتكون هذه القيمة هي سلسلة اتصال الجهاز. ستستخدمها لتكوين وقت تشغيل IoT Edge في القسم التالي.

   على سبيل المثال، يجب أن تبدو سلسلة الاتصال مشابهة ل HostName=contoso-hub.azure-devices.net;DeviceId=myEdgeDevice;SharedAccessKey=<DEVICE_SHARED_ACCESS_KEY>.

تثبيت وقت تشغيل IoT Edge وبدء تشغيله

قم بتثبيت IoT Edge لـ Linux على نظام التشغيل Windows على جهازك، وتكوينه باستخدام سلسلة اتصال الجهاز.

قم بتشغيل أوامر PowerShell التالية على الجهاز الهدف حيث تريد نشر Azure IoT Edge لـ Linux على نظام التشغيل Windows. لنشر جهاز هدف عن بعد باستخدام PowerShell، استخدم "Remote PowerShell" لتأسيس اتصال بجهاز عن بعد وشغل هذه الأوامر عن بعد على هذا الجهاز.

1. في جلسة عمل PowerShell غير مقيدة، قم بتشغيل الأمر التالي لتمكين Hyper-V. لمزيد من المعلومات، تحقق من Hyper-V على Windows 10.

   Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
   

2. في جلسة عمل PowerShell غير مقيدة، قم بتشغيل كل من الأوامر التالية لتنزيل IoT Edge لـ Linux على نظام التشغيل Windows.

   • X64/AMD64

     $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
     $ProgressPreference = 'SilentlyContinue'
     Invoke-WebRequest "https://aka.ms/AzEFLOWMSI_1_4_LTS_X64" -OutFile $msiPath
     

   • ARM64

     $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
     $ProgressPreference = 'SilentlyContinue'
     Invoke-WebRequest "https://aka.ms/AzEFLOWMSI_1_4_LTS_ARM64" -OutFile $msiPath
     

3. قم بتثبيت IoT Edge لـ Linux على نظام التشغيل Windows على جهازك.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
   

4. عيِّن نهج التنفيذ على الجهاز الهدف إلى AllSigned في حال لم يكن عند هذا الإعداد بالفعل. يُمكنك التحقق من نهج التنفيذ الحالي في طلب PowerShell غير مقيد باستخدام:

   Get-ExecutionPolicy -List
   

   إذا لم يُعيِّن نهج تنفيذ local machine إلى AllSigned، يُمكنك تعيين نهج التنفيذ من خلال:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

5. إنشاء عملية نشر IoT Edge لـ Linux على نظام التشغيل Windows.

   Deploy-Eflow
   

6. إدخال 'Y' لقبول شروط الترخيص.

7. إدخال 'O' أو 'R' للتبديل بين تشغيل بيانات التشخيص الاختيارية أو إيقاف تشغيلها وفقاً لتفضيلاتك. يتم التقاط صورة لعملية نشر ناجحة أدناه.

   

8. قم بتوفير جهازك باستخدام سلسلة اتصال الجهاز التي قمت باستردادها في القسم السابق. استبدل نص العنصر النائب بقيمتك الخاصة.

   Provision-EflowVm -provisioningType ManualConnectionString -devConnString "<CONNECTION_STRING_HERE>"
   

تم تكوين جهاز IoT Edge الآن. إنه جاهز لتشغيل الوحدات النمطية التي يتم استخدامها على السحابة.

نشر الوحدة النمطية

قم بإدارة جهاز Azure IoT Edge الخاص بك من السحابة لنشر وحدة نمطية تُرسل بيانات تتبع الاستخدام إلى IoT Hub.

تتمثّل إحدى القدرات الرئيسية لـ Azure IoT Edge في نشر التعليمات البرمجية على أجهزة IoT Edge الخاصة بك من السحابة. وحدات IoT Edge النمطية عبارة عن حِزم تنفيذية يتم تطبيقها كحاويات. في هذا القسم، ستنشر وحدة نمطية مُنشأة مسبقاً من قسم "IoT Edge Modules" في Azure Marketplaceمن Azure IoT Hub مباشرةً.

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

اتبع هذه الخطوات لنشر وحدتك النمطية الأولى من Azure Marketplace.

1. سجل فيمدخل Azure ثم انتقل إلى مركز IoT.

2. من القائمة على اليسار، حدد الأجهزة ضمن قائمة إدارة الأجهزة.

3. حدد معرف الجهاز للجهاز المستهدف من قائمة الأجهزة.

   إشعار

   عند إنشائك جهاز IoT Edge جديدًا، فإنه سيعرض رمز الحالة 417 -- The device's deployment configuration is not set في مدخل Microsoft Azure. هذه الحالة طبيعية، وتعني أن الجهاز جاهز لتلقي وحدة نشر.

4. في الشريط العلوي، حدد "Set Modules".

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

5. ضمن "IoT Edge Modules"، وافتح القائمة المنسدلة "Add"، ومن ثمَّ حدد "Marketplace Module".

6. في "IoT Edge Module Marketplace"، ابحث عن الوحدة النمطية Simulated Temperature Sensor وحددها. تُضاف الوحدة النمطية إلى قسم "IoT Edge Modules" مع حالة التشغيل المطلوبة.

7. حدد Next: Routes لمتابعة تكوين المسارات.

   تم إنشاء مسار يسمى SimulatedTemperatureSensorToIoTHub تلقائيا عند إضافة الوحدة النمطية من Azure Marketplace. يرسل هذا المسار جميع الرسائل من وحدة محاكاة درجة الحرارة إلى IoT Hub.

8. حدّد Next: Review + create.

9. راجع ملف JSON، ثم حدّد "Create". يحدد ملف JSON جميع الوحدات النمطية التي تنشرها على جهاز IoT Edge الخاص بك.

   إشعار

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

بعد إنشاء تفاصيل نشر الوحدة النمطية، يعيدك المعالج إلى صفحة تفاصيل الجهاز. اعرض حالة النشر في علامة التبويب "Modules".

يجب أن تشاهد ثلاث وحدات نمطية: $edgeAgent، و$edgeHub، وSimulatedTemperatureSensor. إذا كانت وحدة نمطية واحدة أو أكثر تحتوي على نعم ضمن محدد في النشر ولكن ليس ضمن تم الإبلاغ عنها بواسطة الجهاز، فلا يزال جهاز IoT Edge يبدأ تشغيلها. انتظر بضع دقائق، ثم قم بتحديث الصفحة.

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

عرض البيانات التي تم إنشاؤها

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

تُنشئ الوحدة النمطية التي قمت بالضغط عليها نموذج بيانات البيئة الذي يُمكنك استخدامه لإجراء الاختبار لاحقاً. يقوم المستشعر المحاكي بمراقبة كل من الآلة والبيئة المحيطة بالآلة. على سبيل المثال، قد تكون أداة الاستشعار تلك في غرفة الخادم، أو على أرضية مصنع، أو على مولدات كهرباء هوائية. وتتضمّن الرسائل التي ترسلها درجة الحرارة والرطوبة المحيطة، ودرجة حرارة الجهاز وضغطه، والطابع الزمني. تستخدم برامج IoT Edge التعليمية البيانات التي أنشأتها هذه الوحدة النمطية كبيانات اختبار لإجراء التحليلات.

1. سجِّل الدخول إلى IoT Edge لـ Linux الخاص بك على جهاز Windows الظاهري باستخدام الأمر التالي في جلسة عمل PowerShell لديك:

   Connect-EflowVm
   

   إشعار

   الحساب الوحيد المسموح له باستخدام بروتوكول SSH إلى الجهاز الظاهري هو المستخدم الذي قام بإنشائه.

2. بمجرّد تسجيلك الدخول، يُمكنك التحقق من قائمة وحدات IoT Edge النمطية قيد التشغيل باستخدام أمر Linux التالي:

   sudo iotedge list
   

   

3. اعرض الرسائل المُرسلة من الوحدة النمطية لأداة استشعار درجة الحرارة إلى السحابة باستخدام أمر Linux التالي:

   sudo iotedge logs SimulatedTemperatureSensor -f
   

   

   تلميح

   تُعدّ أوامر IoT Edge حساسة لحالة الأحرف عندما تُشير إلى أسماء الوحدة النمطية.

تنظيف الموارد

إذا كنت ترغب في المتابعة إلى برامج IoT Edge التعليمية، فتخطَّ هذه الخطوة. يُمكنك استخدام الجهاز الذي قمت بتسجيله وإعداده في هذا التشغيل السريع. وإلا، يمكنك حذف موارد Azure التي قمت بإنشائها لتجنب المصاريف.

إذا قمت بإنشاء الجهاز الظاهري ومركز IoT في مجموعة موارد جديدة، يمكنك حذف هذه المجموعة وكافة الموارد المقترنة. إذا كنت لا ترغب في حذف المجموعة بأكملها، يُمكنك حذف الموارد الفردية بدلاً من ذلك.

هام

تحقق من محتويات مجموعة الموارد للتأكّد من عدم وجود شيء تريد الاحتفاظ به. حذف مجموعة الموارد لا يمكن التراجع عنه.

استخدم الأمر التالي لإزالة مجموعة "IoTEdgeResources". قد يستغرق الحذف بضع دقائق.

az group delete --name IoTEdgeResources

يُمكنك تأكيد إزالة مجموعة الموارد باستخدام هذا الأمر لعرض قائمة مجموعات الموارد.

az group list

إلغاء تثبيت IoT Edge ل Linux على Windows

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

1. فتح الإعدادات على Windows
2. حدد إضافة برامج أو إزالتها
3. حدد تطبيق Azure IoT Edge
4. حدد إلغاء التثبيت

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

في هذا التشغيل السريع، قمت بإنشاء جهاز IoT Edge واستخدمت واجهة سحابة Azure IoT Edge لنشر التعليمات البرمجية على الجهاز. والآن لديك جهاز اختبار يعمل على إنشاء بيانات غير منسقة حول بيئته.

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

مراقبة أجهزة IoT Edge