Nasazení modulů Azure IoT Edge pomocí Azure CLI

Použitelné pro:IoT Edge 1.5 zaškrtnuto IoT Edge 1.5

Důležité

IoT Edge 1.5 LTS je podporovaná verze. IoT Edge 1,4 LTS dosáhl konce životnosti 12. listopadu 2024. Pokud používáte starší verzi, přečtěte si téma Update IoT Edge.

Po vytvoření modulů Azure IoT Edge s vaší obchodní logikou je nasaďte na zařízení, kde budou operovat jako edge zařízení. Pokud více modulů spolupracuje na shromažďování a zpracování dat, nasaďte je všechny najednou. Deklarujte také pravidla směrování, která je propojují.

Azure CLI je opensourcový multiplatformní nástroj příkazového řádku pro správu Azure prostředků, jako je IoT Edge. Umožňuje okamžitě spravovat prostředky Azure IoT Hub, instance služby zřizování zařízení a propojené huby. Nové rozšíření IoT rozšiřuje Azure CLI funkcemi, jako je správa zařízení a úplné možnosti IoT Edge.

Tento článek vysvětluje, jak vytvořit manifest nasazení JSON a pomocí tohoto souboru odeslat nasazení do IoT Edge zařízení. Pro informace o vytvoření nasazení, které cílí na více zařízení na základě jejich sdílených značek, si přečtěte téma Nasazení a monitorování modulů IoT Edge ve velkém měřítku.

Požadavky

Konfigurace manifestu nasazení

Manifest nasazení je dokument JSON, který popisuje, které moduly se mají nasadit, jak data proudí mezi moduly a požadované vlastnosti dvojčat modulů. Další informace o tom, jak fungují manifesty nasazení a jak je vytvořit, najdete v tématu podstatěné informace o tom, jak se dají moduly IoT Edge používat, konfigurovat a opakovaně používat.

Pokud chcete nasadit moduly pomocí Azure CLI, uložte manifest nasazení místně jako soubor .json. Pomocí cesty k souboru v další části spusťte příkaz a použijte konfiguraci na zařízení.

Tady je základní manifest nasazení s jedním modulem jako příkladem:

Poznámka:

Tento ukázkový manifest nasazení používá schéma verze 1.1 pro agenta IoT Edge a centrum. Schéma verze 1.1 je součástí IoT Edge verze 1.0.10 a umožňuje funkce, jako je pořadí spuštění modulu a stanovení priorit tras.

{
  "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
        }
      }
    }
  }
}

Nasazení na vaše zařízení

Moduly nasadíte do zařízení použitím manifestu nasazení, který jste nakonfigurovali s informacemi o modulu.

Změňte adresáře do složky, do které jste uložili manifest nasazení. Pokud jste použili některou ze šablon Visual Studio Code IoT Edge, použijte soubor deployment.json ve složce config adresáře řešení a ne soubor deployment.template.json.

Pomocí následujícího příkazu použijte konfiguraci na IoT Edge zařízení:

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

U parametru ID zařízení se rozlišují malá a velká písmena. Parametr obsahu odkazuje na soubor manifestu nasazení, který jste uložili.

Snímek obrazovky znázorňující výstup příkazového řádku az iot edge set-modules

Zobrazení modulů na zařízení

Jakmile do zařízení nasadíte moduly, můžete je zobrazit pomocí následujícího příkazu:

Prohlédněte si moduly na zařízení IoT Edge:

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

U parametru ID zařízení se rozlišují malá a velká písmena.

Snímek obrazovky s výstupem příkazu az iot hub module-identity list

Další kroky

Zjistěte, jak nasadit a monitorovat moduly IoT Edge v rozsáhlém měřítku

  • Last updated on