Azure IoT Edge-modulok üzembe helyezése Azure CLI használatával

A következőre vonatkozik:IoT Edge 1.5 jelölés IoT Edge 1.5

Fontos

IoT Edge 1.5 LTS a támogatott kiadás. IoT Edge 1,4 LTS 2024. november 12-én véget ért. Ha korábbi kiadást használ, tekintse meg a Update IoT Edge című témakört.

Miután Azure IoT Edge modulokat hozott létre az üzleti logikával, helyezze üzembe őket az eszközein, hogy a peremhálózaton működjenek. Ha több modul is együttműködik az adatok gyűjtéséhez és feldolgozásához, egyszerre helyezze üzembe őket. Deklarálja az őket összekötő útválasztási szabályokat is.

A Azure CLI egy nyílt forráskódú, platformfüggetlen parancssori eszköz Azure erőforrások, például a IoT Edge kezelésére. Lehetővé teszi az Azure IoT Hub erőforrások, az eszközkiépítési szolgáltatáspéldányok és a csatolt központok felügyeletét a dobozon kívül. Az új IoT-bővítmény olyan funkciókkal bővíti Azure CLI, mint az eszközfelügyelet és a teljes IoT Edge képességek.

Ez a cikk bemutatja, hogyan hozhat létre JSON üzembehelyezési jegyzékfájlt, és hogyan küldheti le az üzembe helyezést egy IoT Edge eszközre. A megosztott címkék alapján több eszközt célba állító üzembe helyezésről további információt a A IoT Edge modulok üzembe helyezésének és monitorozásának részletes ismertetése.

Előfeltételek

Üzembehelyezési jegyzék konfigurálása

Az üzembehelyezési jegyzék egy JSON-dokumentum, amely leírja, hogy mely modulokat kell üzembe helyezni, hogyan áramlik az adatforgalom a modulok között, valamint a modul ikerpéldányainak kívánt tulajdonságait. Az üzembehelyezési jegyzékek működésével és létrehozásának módjával kapcsolatos további információkért tekintse meg a modulok IoT Edge használatát, konfigurálását és újrafelhasználását.

A modulok Azure CLI használatával történő üzembe helyezéséhez mentse a központi telepítési jegyzékfájlt helyileg .json fájlként. A következő szakaszban található fájl elérési útján futtassa a parancsot, és alkalmazza a konfigurációt az eszközre.

Íme egy alapszintű üzembehelyezési jegyzék egy modullal példaként:

Megjegyzés

Ez a minta üzembehelyezési jegyzék az 1.1-es sémaverziót használja az IoT Edge ügynökhöz és a központhoz. A séma 1.1-es verziója IoT Edge 1.0.10-es verzióban érhető el, és olyan funkciókat tesz lehetővé, mint a modul indítási sorrendje és az útvonalak rangsorolása.

{
  "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.5",
              "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
        }
      }
    }
  }
}

Üzembe helyezés az eszközön

A modulokat a modulinformációkkal konfigurált üzembehelyezési jegyzék alkalmazásával helyezheti üzembe az eszközén.

Módosítsa a címtárakat abba a mappába, ahová az üzembehelyezési jegyzékfájlt mentette. Ha az egyik Visual Studio Code IoT Edge sablont használta, a megoldáskönyvtár deployment.json mappájában használja a fájlt, és ne a deployment.template.json fájlt.

A következő paranccsal alkalmazza a konfigurációt egy IoT Edge eszközre:

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

Az eszközazonosító paraméter kis- és nagybetű különbséget tesz. A tartalomparaméter a mentett üzembehelyezési jegyzékfájlra mutat.

Képernyőkép az az iot edge set-modules parancssori kimenetről.

Modulok megtekintése az eszközön

Miután üzembe helyezte a modulokat az eszközén, az alábbi paranccsal tekintheti meg az összes modult:

Tekintse meg a modulokat a IoT Edge eszközén:

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

Az eszközazonosító paraméter kis- és nagybetű különbséget tesz.

Képernyőkép az az iot hub module-identity list parancskimenetről.

Következő lépések

Ismerje meg, hogyan helyezze üzembe és monitorozza az IoT Edge modulokat nagy léptékben

  • Last updated on