Nasazení modulů Azure IoT Edge pomocí Azure CLI

Platí pro: IoT Edge 1.5

Důležité

Podporovanou verzí je IoT Edge 1.5 LTS. IoT Edge 1.4 LTS je konec životnosti od 12. listopadu 2024. Pokud používáte starší verzi, podívejte se na článek Aktualizace IoT Edge.

Po vytvoření modulů Azure IoT Edge s obchodní logikou je nasaďte do svých zařízení, aby fungovaly na hraně. 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 prostředků Azure, jako je IoT Edge. Umožňuje spravovat prostředky Azure IoT Hubu, instance služeb zřizování zařízení a propojené centra. Nové rozšíření IoT rozšiřuje Azure CLI o funkce, 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 zařízení IoT Edge. Informace o vytvoření nasazení, které cílí na více zařízení na základě jejich sdílených značek, najdete v tématu Nasazení a monitorování modulů IoT Edge ve velkém měřítku.

Požadavky

• IoT Hub ve vašem předplatném Azure.

• Zařízení IoT Edge

  Pokud nemáte nastavené zařízení IoT Edge, vytvořte ho ve virtuálním počítači Azure. Postupujte podle kroků v jednom z článků rychlého startu a vytvořte virtuální zařízení s Linuxem nebo vytvořte virtuální zařízení s Windows.

• Azure CLI ve vašem prostředí. Vaše verze Azure CLI musí být 2.0.70 nebo vyšší. Použijte az --version ke kontrole. Tato verze podporuje příkazy az extension a používá architekturu příkazů Knack.

• Rozšíření IoT pro Azure CLI

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 vysvětlení toho, 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 a centrum IoT Edge. 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.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
        }
      }
    }
  }
}

Nasazení 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 IoT Edge editoru Visual Studio Code, použijte soubor ve deployment.json adresáře řešení a ne soubor.deployment.template.json

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

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.

Zobrazení modulů na zařízení

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

Zobrazení modulů v 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.

Další kroky

Informace o nasazení a monitorování modulů IoT Edge ve velkém měřítku