نشر وحدات Azure IoT Edge النمطية من التعليمات البرمجية Visual Studio

ينطبق على:yes icon IoT Edge 1.1 IoT Edge 1.2 yes icon

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

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

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

تكوين بيان التوزيع

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

لنشر الوحدات النمطية باستخدام التعليمات البرمجية Visual Studio، احفظ بيان النشر محليا ك . ملف JSON. سوف تستخدم مسار الملف في المقطع التالي عند تشغيل الأمر لتطبيق التكوين على جهازك.

فيما يلي بيان نشر أساسي مع وحدة نمطية واحدة كمثال:

ملاحظة

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

{
  "modulesContent": {
    "$edgeAgent": {
      "properties.desired": {
        "schemaVersion": "1.1",
        "runtime": {
          "type": "docker",
          "settings": {
            "minDockerVersion": "v1.25",
            "loggingOptions": "",
            "registryCredentials": {}
          }
        },
        "systemModules": {
          "edgeAgent": {
            "type": "docker",
            "settings": {
              "image": "mcr.microsoft.com/azureiotedge-agent:1.1",
              "createOptions": "{}"
            }
          },
          "edgeHub": {
            "type": "docker",
            "status": "running",
            "restartPolicy": "always",
            "settings": {
              "image": "mcr.microsoft.com/azureiotedge-hub:1.1",
              "createOptions": "{\"HostConfig\":{\"PortBindings\":{\"443/tcp\":[{\"HostPort\":\"443\"}],\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}]}}}"
            }
          }
        },
        "modules": {
          "SimulatedTemperatureSensor": {
            "version": "1.0",
            "type": "docker",
            "status": "running",
            "restartPolicy": "always",
            "settings": {
              "image": "mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.0",
              "createOptions": "{}"
            }
          }
        }
      }
    },
    "$edgeHub": {
      "properties.desired": {
        "schemaVersion": "1.1",
        "routes": {
            "route": "FROM /messages/* INTO $upstream"
        },
        "storeAndForwardConfiguration": {
          "timeToLiveSecs": 7200
        }
      }
    },
    "SimulatedTemperatureSensor": {
      "properties.desired": {}
    }
  }
}

تسجيل الدخول للوصول إلى مركز إنترنت الأشياء

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

  1. في التعليمات البرمجية Visual Studio، افتح طريقة العرض "مستكشف".

  2. في أسفل المستكشف، قم بتوسيع قسم Azure IoT Hub .

    Expand Azure IoT Hub section

  3. انقر فوق ... في رأس قسم Azure IoT Hub . إذا كنت لا ترى علامة الحذف، فمرر مؤشر الماوس فوق الرأس.

  4. اختر تحديد مركز إنترنت الأشياء.

  5. إذا لم تقم بتسجيل الدخول إلى حساب Azure الخاص بك، فاتبع المطالبات للقيام بذلك.

  6. حدد اشتراكك في Azure.

  7. حدد مركز IoT.

التوزيع بجهازك

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

  1. في طريقة العرض مستكشف التعليمات البرمجية Visual Studio، قم بتوسيع المقطع Azure IoT Hub، ثم قم بتوسيع عقدة الأجهزة.

  2. انقر بزر الماوس الأيمن فوق جهاز IoT Edge الذي تريد تكوينه باستخدام بيان النشر.

    تلميح

    للتأكد من أن الجهاز الذي اخترته هو جهاز IoT Edge، حدده لتوسيع قائمة الوحدات النمطية والتحقق من وجود $edgeHub$edgeAgent. يتضمن كل جهاز IoT Edge هاتين الوحدتين.

  3. حدد إنشاء نشر لجهاز واحد.

  4. انتقل إلى ملف JSON بيان النشر الذي تريد استخدامه، ثم انقر فوق تحديد بيان نشر Edge.

    Select Edge Deployment Manifest

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

عرض الوحدات النمطية على جهازك

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

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

انقر بزر الماوس الأيمن فوق اسم الوحدة النمطية لعرض توأم الوحدة النمطية وتحريره.

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

تعرف على كيفية نشر وحدات IoT Edge النمطية ومراقبتها على نطاق واسع باستخدام التعليمات البرمجية Visual Studio