Megosztás a következőn keresztül:


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

A következőkre vonatkozik:IoT Edge 1.5 pipa IoT Edge 1.5

Fontos

Az IoT Edge 1.5 LTS a támogatott kiadás. Az IoT Edge 1.4 LTS 2024. november 12-én megszűnik. Ha egy korábbi kiadáson dolgozik, olvassa el az IoT Edge frissítése 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.

Az Azure CLI egy nyílt forráskódú, platformfüggetlen parancssori eszköz az Azure-erőforrások, például az IoT Edge kezeléséhez. 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. Az új IoT-bővítmény olyan funkciókkal bővíti az Azure CLI-t, mint az eszközfelügyelet és a teljes IoT Edge-funkciók.

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. Az IoT Edge-modulok nagy léptékű üzembe helyezéséről és monitorozásáról további információt az IoT Edge-modulok üzembe helyezése és monitorozása című témakörben talál, amely több eszközt céloz meg a megosztott címkék alapján.

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 üzembe helyezé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 az IoT Edge-modulok használatát, konfigurálását és újrafelhasználását.

Ha modulokat szeretne üzembe helyezni az Azure CLI használatával, mentse az üzembehelyezé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:

Feljegyzés

Ez a minta üzembehelyezési jegyzék az IoT Edge-ügynökhöz és -központhoz az 1.1-es sémaverziót használja. A séma 1.1-es verziója az IoT Edge 1.0.10-es verziójá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.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
        }
      }
    }
  }
}

Ü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 a Visual Studio Code IoT Edge-sablonok egyikét használta, használja a deployment.json fájlt a megoldáskönyvtár konfigurációs mappájában, é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 megkülönbözteti a kis- és nagybetűk értékét. 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:

A modulok megtekintése az 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 megkülönbözteti a kis- és nagybetűk értékét.

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

Következő lépések

Ismerje meg, hogyan helyezhet üzembe és monitorozhat IoT Edge-modulokat nagy méretekben