إنشاء IoT Edge لنظام التشغيل Linux وتوفيره على جهاز Windows باستخدام شهادات X.509

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

ينطبق على: IoT Edge 1.1 إصدارات أخرى:IoT Edge 1.2

ينطبق على: IoT Edge 1.2 إصدارات أخرى:IoT Edge 1.1

توفر هذه المقالة إرشادات شاملة لتسجيل وتوفير IoT Edge لنظام التشغيل Linux على جهاز Windows.

ملاحظة

يوجد أحدث إصدار من Azure IoT Edge لنظام التشغيل Linux على الإصدار المستمر Windows (EFLOW CR)، استنادا إلى الإصدار 1.2 من IoT Edge، في المعاينة العامة. قد تكون هناك حاجة إلى تثبيت نظيف للأجهزة التي تدخل حيز الاستخدام الإنتاجي بمجرد توفر إصدار التوفر العام (GA). لمزيد من المعلومات، راجع الإصدار المستمر من EFLOW.

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

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

• المفاتيح المتماثلة: عند إنشاء هوية جهاز جديدة في IoT Hub، تقوم الخدمة بإنشاء مفتاحين. يمكنك وضع أحد المفاتيح على الجهاز ، ويعرض مفتاح IoT Hub عند المصادقة.

  طريقة المصادقة هذه أسرع للبدء ، ولكنها ليست آمنة.

• X.509 موقعة ذاتيا: يمكنك إنشاء شهادتي هوية X.509 ووضعهما على الجهاز. عند إنشاء هوية جهاز جديد في IoT Hub، فإنك توفر بصمات إبهام من كلتا الشهادتين. عندما يقوم الجهاز بالمصادقة إلى IoT Hub، فإنه يقدم شهادة واحدة ويتحقق IoT Hub من أن الشهادة تتطابق مع بصمة إبهامه.

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

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

ملاحظة

إذا كان لديك العديد من الأجهزة لإعدادها ولا تريد توفير كل منها يدويا، فاستخدم إحدى المقالات التالية لمعرفة كيفية عمل IoT Edge مع خدمة توفير أجهزة IoT Hub:

• إنشاء أجهزة IoT Edge وتوفيرها على نطاق واسع باستخدام شهادات X.509
• إنشاء أجهزة IoT Edge وتوفيرها على نطاق واسع باستخدام TPM
• إنشاء أجهزة IoT Edge وتوفيرها على نطاق واسع باستخدام مفاتيح متماثلة

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

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

أدوات إدارة الأجهزة

يمكنك استخدام مدخل Azure أو رمز Visual Studio أوAzure CLI للحصول على خطوات تسجيل جهازك. كل أداة لها متطلباتها الخاصة:

المدخل

مركز إنترنت الأشياء مجاني أو قياسي في اشتراكك في Azure.

تعليمة Visual Studio برمجية

• مركز إنترنت الأشياء مجاني أو قياسي في اشتراكك في Azure
• تعليمة Visual Studio برمجية
• Azure IoT Tools for Visual Studio Code

Azure CLI

• مركز إنترنت الأشياء مجاني أو قياسي في اشتراكك في Azure

• Azure CLI في بيئتك

  كحد أدنى، يجب أن يكون إصدار Azure CLI 2.0.70 أو أحدث. استخدم az --version للتحقق من الصحة. يَدعم هذا الإصدار أوامر ملحق az ويقدم إطار قيادة Knack.

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

جهاز Windows بالحد الأدنى من المتطلبات التالية:

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

  • Windows 10 ¹/11 (Pro، المؤسسة، إنترنت الأشياء المؤسسة)
  • Windows سيرفر 20191/2022
    _{¹ Windows 10 و Windows Server 2019 الحد الأدنى للبناء 17763 مع تثبيت كافة التحديثات التراكمية الحالية.}

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

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

• دعم المحاكاة الافتراضية

  • على Windows 10، قم بتمكين Hyper-V. لمزيد من المعلومات، راجع تثبيت Hyper-V على Windows 10.
  • على خادم Windows، قم بتثبيت دور Hyper-V وإنشاء مبدل شبكة افتراضي. لمزيد من المعلومات، راجع المحاكاة الافتراضية المتداخلة ل Azure IoT Edge for Linux على Windows.
  • على جهاز ظاهري، قم بتكوين المحاكاة الافتراضية المتداخلة. لمزيد من المعلومات، راجع المحاكاة الافتراضية المتداخلة.

• دعم الشبكات

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

تلميح

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

ستحتاج إلى تثبيت برامج التشغيل الصحيحة اعتمادا على بنية GPU الخاصة بك ، وقد تحتاج إلى الوصول إلى إنشاء برنامج Windows Insider. لتحديد احتياجات التكوين الخاصة بك وتلبية هذه المتطلبات الأساسية، راجع تسريع GPU ل Azure IoT Edge for Linux على Windows.

تأكد من أنك تأخذ الوقت الكافي لتلبية المتطلبات الأساسية لتسريع GPU الآن. ستحتاج إلى إعادة تشغيل عملية التثبيت إذا قررت أنك تريد تسريع GPU أثناء التثبيت.

أدوات المطور

يمكنك استخدام PowerShell أو Windows Admin Center لإدارة أجهزة IoT Edge. كل أداة لها متطلباتها الخاصة:

PowerShell

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

1. قم بتعيين سياسة التنفيذ على الجهاز المستهدف إلى AllSigned. يمكنك التحقق من نهج التنفيذ الحالي في موجه PowerShell مرتفع باستخدام الأمر التالي:

   Get-ExecutionPolicy -List
   

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

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

لمزيد من المعلومات حول Azure IoT Edge for Linux على وحدة Windows PowerShell، راجع مرجع وظائف PowerShell.

Windows Admin Center

إذا كنت ترغب في استخدام Windows "مركز الإدارة"، فاتبع الخطوات التالية لتنزيل Windows "مركز الإدارة" وتثبيته وتثبيت ملحق "Windows مركز إدارة Azure IoT Edge":

1. قم بتنزيل مثبت مركز إدارة Windows وتشغيله. اتبع مطالبات معالج التثبيت لتثبيت Windows مركز الإدارة.

2. بمجرد التثبيت، استخدم متصفحا مدعوما لفتح Windows "مركز الإدارة". تتضمن المتصفحات المدعومة Microsoft Edge (Windows 10، الإصدار 1709 أو أحدث) وGoogle Chrome و Microsoft Edge Insider.

3. عند الاستخدام الأول Windows "مركز الإدارة"، ستتم مطالبتك بتحديد شهادة لاستخدامها. حدد عميل مركز الإدارة Windows كشهادتك.

4. قم بتثبيت ملحق Azure IoT Edge. حدد رمز الترس في أعلى يسار لوحة معلومات مركز إدارة Windows.

   

5. في القائمة الإعدادات، ضمن بوابة، حدد ملحقات.

6. في علامة التبويب الملحقات المتوفرة ، ابحث عن Azure IoT Edge في قائمة الملحقات. اختره، وحدد المطالبة تثبيت أعلى قائمة الامتدادات.

7. بعد اكتمال التثبيت، يجب أن ترى Azure IoT Edge في قائمة الملحقات المثبتة في علامة التبويب الملحقات المثبتة .

قم بإعداد جهازك المستهدف لتثبيت Azure IoT Edge لنظام التشغيل Linux على Windows ونشر الجهاز الظاهري Linux:

1. قم بتعيين سياسة التنفيذ على الجهاز المستهدف إلى AllSigned. يمكنك التحقق من نهج التنفيذ الحالي في موجه PowerShell مرتفع باستخدام الأمر التالي:

   Get-ExecutionPolicy -List
   

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

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

لمزيد من المعلومات حول Azure IoT Edge for Linux على وحدة Windows PowerShell، راجع مرجع وظائف PowerShell.

إنشاء شهادات هوية الجهاز

يتطلب التوفير اليدوي باستخدام شهادات X.509 الإصدار 1.0.10 من IoT Edge أو أحدث.

عند توفير جهاز IoT Edge مع شهادات X.509، يمكنك استخدام ما يسمى شهادة هوية الجهاز. تستخدم هذه الشهادة فقط لتوفير جهاز IoT Edge ومصادقة الجهاز باستخدام Azure IoT Hub. إنها شهادة ورقة لا توقع شهادات أخرى. شهادة هوية الجهاز منفصلة عن شهادات المرجع المصدق (CA) التي يقدمها جهاز IoT Edge إلى الوحدات النمطية أو الأجهزة النهائية للتحقق منها.

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

لمزيد من المعلومات حول كيفية استخدام شهادات CA في أجهزة IoT Edge، راجع فهم كيفية استخدام Azure IoT Edge للشهادات.

تحتاج إلى الملفات التالية للتوفير اليدوي باستخدام X.509:

• اثنتان من شهادات هوية الجهاز مع شهادات المفتاح الخاص المطابقة الخاصة بهما بتنسيقات .cer أو .pem.

  يتم توفير مجموعة واحدة من ملفات الشهادات / المفاتيح إلى وقت تشغيل IoT Edge. عند إنشاء شهادات هوية الجهاز، قم بتعيين الاسم الشائع للشهادة (CN) مع معرف الجهاز الذي تريد أن يكون للجهاز في مركز إنترنت الأشياء.

• بصمات الإبهام المأخوذة من شهادتي هوية الجهاز.

  قيم بصمة الإبهام هي 40 حرفا سداسيا لتجزئة SHA-1 أو 64 حرفا سداسيا لتجزئة SHA-256. يتم توفير كل من بصمات الإبهام إلى IoT Hub في وقت تسجيل الجهاز.

إذا لم تكن لديك شهادات متوفرة، فيمكنك إنشاء شهادات تجريبية لاختبار ميزات جهاز IoT Edge. اتبع الإرشادات الواردة في هذه المقالة لإعداد البرامج النصية لإنشاء الشهادات، وإنشاء شهادة CA الجذر، ثم إنشاء شهادتي هوية جهاز IoT Edge.

إحدى الطرق لاسترداد بصمة الإبهام من شهادة هي باستخدام الأمر openssl التالي:

openssl x509 -in <certificate filename>.pem -text -fingerprint

سجل جهازك

يمكنك استخدام مدخل Azure أو رمز Visual Studio أو Azure CLI لتسجيل جهازك، وفقا لتفضيلاتك.

المدخل

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

1. سجل الدخول إلى مدخل Azure وانتقل إلى مركز إنترنت الأشياء.

2. في الجزء الأيمن، حدد IoT Edge من القائمة، ثم حدد إضافة جهاز IoT Edge.

   

3. في الصفحة إنشاء جهاز ، قم بتوفير المعلومات التالية:

   • إنشاء معرف جهاز وصفي. دون معرف الجهاز هذا، حيث ستستخدمه لاحقا.
   • حدد X.509 الموقع ذاتيا كنوع المصادقة.
   • توفير بصمات الإبهام لشهادة الهوية الابتدائية والثانوية. قيم بصمة الإبهام هي 40 حرفا سداسيا لتجزئة SHA-1 أو 64 حرفا سداسيا لتجزئة SHA-256.

4. حدد ⁧حفظ⁧.

تعليمة Visual Studio برمجية

حاليا، لا يدعم ملحق Azure IoT ل Visual Studio Code تسجيل الجهاز باستخدام شهادات X.509.

Azure CLI

استخدم الأمر az iot hub device-identity create لإنشاء هوية جهاز جديدة في مركز إنترنت الأشياء. على سبيل المثال:

az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled --auth-method x509_thumbprint --primary-thumbprint primary_SHA_thumbprint_here --secondary-thumbprint secdonary_SHA_thumbprint_here

يتضمن هذا الأمر عدة معلمات:

• --device-id أو -d: قدم اسما وصفيا فريدا لمركز إنترنت الأشياء الخاص بك. دون معرف الجهاز هذا، حيث ستستخدمه في القسم التالي.
• hub-name أو -n: أدخل اسم مركز إنترنت الأشياء الخاص بك.
• --edge-enabled أو --ee: أعلن أن الجهاز هو جهاز IoT Edge.
• --auth-method أو --am: أعلن عن نوع التفويض الذي سيستخدمه الجهاز. في هذه الحالة، نستخدم بصمات إبهام شهادة X.509.
• --primary-thumbprint أو --ptp: قم بتوفير بصمة إبهام شهادة X.509 لاستخدامها كمفتاح أساسي.
• --secondary-thumbprint أو --stp: قم بتوفير بصمة إبهام شهادة X.509 لاستخدامها كمفتاح ثانوي.

الآن بعد أن أصبح لديك جهاز مسجل في IoT Hub، استرجع المعلومات التي تستخدمها لإكمال تثبيت وقت تشغيل IoT Edge وتوفيره.

عرض الأجهزة المسجلة واسترداد معلومات إدارة الحسابات

تحتاج الأجهزة التي تستخدم مصادقة شهادة X.509 إلى اسم مركز إنترنت الأشياء واسم جهازها وملفات الشهادات الخاصة بها لإكمال تثبيت وقت تشغيل IoT Edge وتوفيره.

المدخل

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

تعليمة Visual Studio برمجية

على الرغم من عدم وجود دعم لتسجيل الجهاز باستخدام شهادات X.509 من خلال رمز Visual Studio، إلا أنه لا يزال بإمكانك عرض أجهزة IoT Edge إذا كنت بحاجة إلى ذلك.

يتم سرد جميع الأجهزة التي تتصل بمركز إنترنت الأشياء الخاص بك في قسم Azure IoT Hub في مستكشف التعليمات البرمجية Visual Studio. يمكن تمييز أجهزة IoT Edge عن الأجهزة غير Edge ذات الرمز المختلف ، وحقيقة أن وحدات $edgeAgentو $edgeHub يتم نشرها على كل جهاز IoT Edge.

Azure CLI

استخدم الأمر az iot hub device-identity list لعرض جميع الأجهزة في مركز إنترنت الأشياء. على سبيل المثال:

az iot hub device-identity list --hub-name hub_name_here

أي جهاز مسجل كجهاز IoT Edge سيكون لديه خاصية capabilities.iotEdge مضبوطة على true.

تثبيت إنترنت الأشياء إيدج

انشر Azure IoT Edge لنظام التشغيل Linux على Windows على جهازك المستهدف.

PowerShell

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

ملاحظة

توضح عملية PowerShell التالية كيفية نشر IoT Edge لنظام التشغيل Linux على Windows على الجهاز المحلي. للنشر على جهاز مستهدف بعيد باستخدام PowerShell، يمكنك استخدام PowerShell البعيد لإنشاء اتصال بجهاز بعيد وتشغيل هذه الأوامر عن بعد على هذا الجهاز.

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

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

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

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

   يمكنك تحديد IoT Edge مخصص لنظام التشغيل Linux على Windows التثبيت وأدلة VHDX عن طريق إضافة INSTALLDIR="<FULLY_QUALIFIED_PATH>"VHDXDIR="<FULLY_QUALIFIED_PATH>" معلمات إلى أمر التثبيت.

3. عيِّن نهج التنفيذ على الجهاز الهدف إلى AllSigned في حال لم يكن عند هذا الإعداد بالفعل. راجع المتطلبات الأساسية ل PowerShell للأوامر للتحقق من نهج التنفيذ الحالي وتعيين نهج التنفيذ إلى AllSigned.

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

   Deploy-Eflow
   

   تلميح

   بشكل افتراضي، يقوم الأمر بإنشاء جهاز Linux الظاهري الخاص بك مع 1 غيغابايت من ذاكرة الوصول العشوائي و 1 vCPU core و 16 غيغابايت من مساحة القرص Deploy-Eflow . ومع ذلك، تعتمد الموارد التي يحتاجها الجهاز الظاهري بشكل كبير على أحمال العمل التي تقوم بنشرها. إذا لم يكن الجهاز الظاهري الخاص بك يحتوي على ذاكرة كافية لدعم أحمال العمل الخاصة بك، فسوف يفشل في بدء التشغيل.

   يمكنك تخصيص الموارد المتوفرة للجهاز الظاهري باستخدام المعلمات الاختيارية Deploy-Eflow للأمر.

   على سبيل المثال، يقوم الأمر أدناه بإنشاء جهاز ظاهري يحتوي على 4 نوى vCPU و 4 غيغابايت من ذاكرة الوصول العشوائي (ممثلة في ميغابايت) و 20 غيغابايت من مساحة القرص:

   Deploy-Eflow -cpuCount 4 -memoryInMB 4096 -vmDiskSize 20
   

   للحصول على معلومات حول جميع المعلمات الاختيارية المتوفرة، راجع وظائف PowerShell ل IoT Edge for Linux على Windows.

   تحذير

   بشكل افتراضي، لا يحتوي الجهاز الظاهري EFLOW Linux على تكوين DNS. ستحاول عمليات النشر باستخدام DHCP الحصول على تكوين DNS الذي يتم نشره بواسطة خادم DHCP. يرجى التحقق من تكوين DNS الخاص بك لضمان الاتصال بالإنترنت. لمزيد من المعلومات، راجع AzEFLOW-DNS.

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

   لاستخدام مرور وحدة معالجة الرسومات، أضف معلمات gpuNameوgpuPassthroughType وgpuCount إلى Deploy-Eflow الأمر. للحصول على معلومات حول جميع المعلمات الاختيارية المتوفرة، راجع وظائف PowerShell ل IoT Edge for Linux على Windows.

   تحذير

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

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

6. إدخال 'O' أو 'R' للتبديل بين تشغيل بيانات التشخيص الاختيارية أو إيقاف تشغيلها وفقاً لتفضيلاتك.

7. بمجرد اكتمال النشر، يقوم إطار PowerShell بالإبلاغ عن نجاح النشر.

   

   بعد النشر الناجح، تصبح جاهزا لتوفير جهازك.

Windows Admin Center

ملاحظة

ملحق Azure IoT Edge ل Windows مركز الإدارة حاليا في المعاينة العامة. قد تختلف عملية الإدارة عن الميزات المتوفرة بشكل عام.

1. قم بتثبيت Windows مركز الإدارة وافتحه.

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

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

2. تأكد من أن جهازك المحلي مدرج ضمن جميع الاتصالات، كما هو موضح أدناه.

   

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

3. حدد + إضافة لبدء إنشاء النشر. يقوم النشر بإنشاء جهاز Linux الظاهري الخاص بك وتثبيت وقت تشغيل IoT Edge نيابة عنك.

4. في الجزء إضافة موارد أو إنشائها ، حدد موقع لوحة Azure IoT Edge . حدد إنشاء جديد لتثبيت مثيل جديد من Azure IoT Edge for Linux على Windows على جهاز.

   إذا كان لديك بالفعل IoT Edge for Linux على Windows يعمل على جهاز، فيمكنك تحديد إضافة للاتصال بجهاز IoT Edge الحالي وإدارته باستخدام مركز إدارة Windows.

   

5. سيتم فتح جزء إنشاء Azure IoT Edge لنظام التشغيل Linux على جزء النشر Windows. على 1. علامة التبويب "بدء الاستخدام "، راجع الحد الأدنى من المتطلبات وحدد التالي.

6. راجع شروط الترخيص، وحدد أوافق، وحدد التالي.

7. يمكنك تبديل البيانات التشخيصية الاختيارية أو إيقاف تشغيلها، وفقا لتفضيلاتك.

8. حدد التالي: نشر.

   

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

   

10. في علامة التبويب 2.2 الإعدادات، راجع إعدادات التكوين الخاصة بالنشر. يوضح الجدول أدناه الإعدادات وقيمها الافتراضية.

    الإعداد	القيمة الافتراضية
    حجم القرص الظاهري بالجيجابايت	⁧⁩16⁧⁩
    الذاكرة بالميجابايت (الرقم الزوجي)	1024
    عدد النوى	2
    Azure IoT Edge version	1.1 (LTS)

    ملاحظة

    يستخدم IoT Edge for Linux على Windows مفتاحا افتراضيا ، والذي يعين الجهاز الظاهري Linux عنوان IP داخليا. لا يمكن الوصول إلى عنوان IP الداخلي هذا من خارج جهاز Windows. يمكنك الاتصال بالجهاز الظاهري محليا أثناء تسجيل الدخول إلى جهاز Windows.

    إذا كنت تستخدم خادم Windows، فقم بإعداد مفتاح تبديل افتراضي قبل نشر IoT Edge لنظام التشغيل Linux على Windows.

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

    يتوفر خياران لتمرير وحدة معالجة الرسومات: التعيين المباشر للجهاز (DDA ) والمحاكاة الافتراضية لوحدة معالجة الرسومات (GPU-PV)، اعتمادا على محول وحدة معالجة الرسومات الذي تقوم بتعيينه للنشر.

    بالنسبة لطريقة التعيين المباشر للجهاز، حدد عدد معالجات GPU لتخصيصها لجهاز Linux الظاهري.

    بالنسبة لطريقة المحاكاة شبه الافتراضية، لا يلزم إجراء أي إعدادات إضافية.

    تحذير

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

    بمجرد أن تكون راضيا عن الإعدادات، حدد التالي.

11. في علامة التبويب نشر 2.3 ، يمكنك مشاهدة تقدم عملية النشر. تتضمن العملية الكاملة تنزيل Azure IoT Edge for Linux على حزمة Windows ، وتثبيت الحزمة ، وتكوين الجهاز المضيف ، وإعداد جهاز Linux الظاهري. قد تستغرق هذه العملية عدة دقائق حتى تكتمل. يتم التقاط صورة لعملية نشر ناجحة أدناه.

    

12. بمجرد اكتمال النشر، تصبح جاهزا لتوفير جهازك. حدد التالي: الاتصال للمتابعة إلى 3. الاتصال علامة التبويب، التي تتعامل مع توفير أجهزة Azure IoT Edge.

ملاحظة

توضح عملية PowerShell التالية كيفية نشر IoT Edge لنظام التشغيل Linux على Windows على الجهاز المحلي. للنشر على جهاز مستهدف بعيد باستخدام PowerShell، يمكنك استخدام PowerShell البعيد لإنشاء اتصال بجهاز بعيد وتشغيل هذه الأوامر عن بعد على هذا الجهاز.

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

   • X64/AMD64

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

   • آرم64

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

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

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

   يمكنك تحديد IoT Edge مخصص لنظام التشغيل Linux على Windows التثبيت وأدلة VHDX عن طريق إضافة INSTALLDIR="<FULLY_QUALIFIED_PATH>"VHDXDIR="<FULLY_QUALIFIED_PATH>" معلمات إلى أمر التثبيت.

3. عيِّن نهج التنفيذ على الجهاز الهدف إلى AllSigned في حال لم يكن عند هذا الإعداد بالفعل. راجع المتطلبات الأساسية ل PowerShell للأوامر للتحقق من نهج التنفيذ الحالي وتعيين نهج التنفيذ إلى AllSigned.

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

   Deploy-Eflow
   

   تلميح

   بشكل افتراضي ، يقوم الأمر بإنشاء جهاز Linux الظاهري الخاص بك مع 1 غيغابايت من ذاكرة الوصول العشوائي Deploy-Eflow ، و 1 vCPU core ، و 10 غيغابايت من تحليل البيانات. ومع ذلك، تعتمد الموارد التي يحتاجها الجهاز الظاهري بشكل كبير على أحمال العمل التي تقوم بنشرها. إذا لم يكن الجهاز الظاهري الخاص بك يحتوي على ذاكرة كافية لدعم أحمال العمل الخاصة بك، فسوف يفشل في بدء التشغيل.

   يمكنك تخصيص الموارد المتوفرة للجهاز الظاهري باستخدام المعلمات الاختيارية Deploy-Eflow للأمر.

   على سبيل المثال، يقوم الأمر أدناه بإنشاء جهاز ظاهري يحتوي على 4 نوى vCPU و 4 غيغابايت من ذاكرة الوصول العشوائي (ممثلة في ميغابايت) و 20 غيغابايت من قسم البيانات:

   Deploy-Eflow -cpuCount 4 -memoryInMB 4096 -vmDataSize 20
   

   ملاحظة:vmDataSize هي معلمة جديدة تم تقديمها في إصدار EFLOW CR.

   للحصول على معلومات حول جميع المعلمات الاختيارية المتوفرة، راجع وظائف PowerShell ل IoT Edge for Linux على Windows.

   تحذير

   بشكل افتراضي، لا يحتوي الجهاز الظاهري EFLOW Linux على تكوين DNS. ستحاول عمليات النشر باستخدام DHCP الحصول على تكوين DNS الذي يتم نشره بواسطة خادم DHCP. يرجى التحقق من تكوين DNS الخاص بك لضمان الاتصال بالإنترنت. لمزيد من المعلومات، راجع AzEFLOW-DNS.

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

   لاستخدام مرور وحدة معالجة الرسومات، أضف معلمات gpuNameوgpuPassthroughType وgpuCount إلى Deploy-Eflow الأمر. للحصول على معلومات حول جميع المعلمات الاختيارية المتوفرة، راجع وظائف PowerShell ل IoT Edge for Linux على Windows.

   تحذير

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

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

6. إدخال 'O' أو 'R' للتبديل بين تشغيل بيانات التشخيص الاختيارية أو إيقاف تشغيلها وفقاً لتفضيلاتك.

7. بمجرد اكتمال النشر، يقوم إطار PowerShell بالإبلاغ عن نجاح النشر.

   

   بعد النشر الناجح، تصبح جاهزا لتوفير جهازك.

تزويد الجهاز بهويته السحابية

أنت مستعد لإعداد جهازك باستخدام هويته السحابية ومعلومات المصادقة.

لتوفير جهازك باستخدام شهادات X.509، ستحتاج إلى اسم مركز إنترنت الأشياءومعرف الجهاز والمسارات المطلقة لشهادة الهويةوالمفتاح الخاص على الجهاز المضيف Windows.

يمكنك استخدام Windows "مركز الإدارة" أو جلسة PowerShell مرتفعة لتوفير أجهزتك.

PowerShell

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

قم بتشغيل الأمر التالي في جلسة عمل PowerShell مرتفعة على جهازك المستهدف. استبدل نص العنصر النائب بقيمك الخاصة.

Provision-EflowVm -provisioningType ManualX509 -iotHubHostname "HUB_HOSTNAME_HERE" -deviceId "DEVICE_ID_HERE" -identityCertPath "ABSOLUTE_PATH_TO_IDENTITY_CERT_HERE" -identityPrivKeyPath "ABSOLUTE_PATH_TO_PRIVATE_KEY_HERE"

لمزيد من المعلومات حول Provision-EflowVM الأمر، راجع وظائف PowerShell ل IoT Edge for Linux على Windows.

Windows Admin Center

1. في جزء توفير الأجهزة Azure IoT Edge ، حدد ManualX509 من القائمة المنسدلة طريقة التوفير.

   

2. توفير المعلمات المطلوبة:

   • IoT Hub Hostname: اسم مركز إنترنت الأشياء الذي تم تسجيل هذا الجهاز فيه.
   • معرف الجهاز: الاسم الذي تم تسجيل هذا الجهاز به.
   • ملف الشهادة: Upload شهادة هوية الجهاز، والتي سيتم نقلها إلى الجهاز الظاهري واستخدامها لتوفير الجهاز.
   • ملف المفتاح الخاص: Upload ملف المفتاح الخاص المطابق ، والذي سيتم نقله إلى الجهاز الظاهري واستخدامه لتوفير الجهاز.

3. حدد إدارة الحسابات باستخدام الطريقة المحددة.

4. بمجرد اكتمال إدارة الحسابات، حدد إنهاء. سيتم نقلك مرة أخرى إلى لوحة القيادة الرئيسية. الآن ، يجب أن ترى جهازا جديدا مدرجا بالنوع IoT Edge Devices. يمكنك تحديد جهاز IoT Edge للاتصال به. بمجرد الدخول إلى صفحة النظرة العامة الخاصة به ، يمكنك عرض قائمة وحدات IoT Edgeوحالة IoT Edge لجهازك.

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

قم بتشغيل الأمر التالي في جلسة عمل PowerShell مرتفعة على جهازك المستهدف. استبدل نص العنصر النائب بقيمك الخاصة.

Provision-EflowVm -provisioningType ManualX509 -iotHubHostname "HUB_HOSTNAME_HERE" -deviceId "DEVICE_ID_HERE" -identityCertPath "ABSOLUTE_PATH_TO_IDENTITY_CERT_HERE" -identityPrivKeyPath "ABSOLUTE_PATH_TO_PRIVATE_KEY_HERE"

لمزيد من المعلومات حول Provision-EflowVM الأمر، راجع وظائف PowerShell ل IoT Edge for Linux على Windows.

تحقق من التكوين الناجح

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

PowerShell

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

   Connect-EflowVm
   

   ملاحظة

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

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

   sudo iotedge list
   

3. إذا كنت بحاجة إلى استكشاف أخطاء خدمة IoT Edge وإصلاحها، فاستخدم أوامر Linux التالية.

   1. استرداد سجلات الخدمة.

      sudo journalctl -u iotedge
      

   2. check استخدم الأداة للتحقق من تكوين الجهاز وحالة اتصاله.

      sudo iotedge check
      

Windows Admin Center

1. حدد جهاز IoT Edge من قائمة الأجهزة المتصلة في Windows مركز الإدارة للاتصال به.

2. تعرض صفحة نظرة عامة على الجهاز بعض المعلومات حول الجهاز:

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

   • يعرض قسم حالة IoT Edge حالة الخدمة، ويجب الإبلاغ عن نشاط (قيد التشغيل).

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

   Connect-EflowVm
   

   ملاحظة

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

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

   sudo iotedge list
   

3. إذا كنت بحاجة إلى استكشاف أخطاء خدمة IoT Edge وإصلاحها، فاستخدم أوامر Linux التالية.

   1. استرداد سجلات الخدمة.

      sudo iotedge system logs
      

   2. check استخدم الأداة للتحقق من تكوين الجهاز وحالة اتصاله.

      sudo iotedge check
      

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

إلغاء تثبيت IoT Edge لنظام التشغيل Linux على Windows

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

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

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

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

• استمر في نشر وحدات IoT Edge النمطية لمعرفة كيفية نشر الوحدات النمطية على جهازك.
• تعرف على كيفية إدارة الشهادات على IoT Edge for Linux على الجهاز الظاهري Windows ونقل الملفات من نظام التشغيل المضيف إلى جهاز Linux الظاهري.
• تعرف على كيفية تكوين أجهزة IoT Edge للاتصال من خلال خادم وكيل.