مشاركة عبر

نشر وحدات Azure IoT Edge النمطية باستخدام Azure CLI

ينطبق على:علامة اختيار IoT Edge 1.5 IoT Edge 1.5

هام

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

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

Azure CLI هو أداة سطر أوامر مفتوحة المصدر عبر النظام الأساسي لإدارة موارد Azure مثل IoT Edge. يتيح لك إدارة موارد Azure IoT Hub، ومثيلات خدمة توفير الجهاز، والمراكز المرتبطة خارج الصندوق. يثري ملحق IoT الجديد Azure CLI بميزات مثل إدارة الجهاز وقدرات IoT Edge الكاملة.

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

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

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

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

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

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

إشعار

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

{
  "content": {
    "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.5",
                "createOptions": "{}"
              }
            },
            "edgeHub": {
              "type": "docker",
              "status": "running",
              "restartPolicy": "always",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-hub:1.5",
                "createOptions": "{\"HostConfig\":{\"PortBindings\":{\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}],\"443/tcp\":[{\"HostPort\":\"443\"}]}}}"
              }
            }
          },
          "modules": {
            "SimulatedTemperatureSensor": {
              "version": "1.0",
              "type": "docker",
              "status": "running",
              "restartPolicy": "always",
              "settings": {
                "image": "mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.5",
                "createOptions": "{}"
              }
            }
          }
        }
      },
      "$edgeHub": {
        "properties.desired": {
          "schemaVersion": "1.1",
          "routes": {
            "upstream": "FROM /messages/* INTO $upstream"
          },
          "storeAndForwardConfiguration": {
            "timeToLiveSecs": 7200
          }
        }
      },
      "SimulatedTemperatureSensor": {
        "properties.desired": {
          "SendData": true,
          "SendInterval": 5
        }
      }
    }
  }
}

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

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

قم بتغيير الدلائل إلى المجلد حيث قمت بحفظ بيان النشر الخاص بك. إذا استخدمت أحد قوالب Visual Studio Code IoT Edge، فاستخدم deployment.json الملف في مجلد التكوين لدليل الحل وليس deployment.template.json الملف.

استخدم الأمر التالي لتطبيق التكوين على جهاز IoT Edge:

az iot edge set-modules --device-id [device id] --hub-name [hub name] --content [file path]

معلمة معرف الجهاز حساسة لحالة الأحرف. تشير معلمة المحتوى إلى ملف بيان النشر الذي قمت بحفظه.

لقطة شاشة تعرض إخراج سطر الأوامر az iot edge set-modules.

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

بمجرد نشر الوحدات النمطية على جهازك، يمكنك عرضها جميعا باستخدام الأمر التالي:

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

az iot hub module-identity list --device-id [device id] --hub-name [hub name]

معلمة معرف الجهاز حساسة لحالة الأحرف.

لقطة شاشة تعرض إخراج الأمر az iot hub module-identity list.

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

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

  • Last updated on