Nasazení modulů Azure IoT Edge pomocí Azure CLI

Platí pro: IoT Edge 1.5 IoT Edge 1.4

Důležité

Podporované verze ioT Edge 1.5 LTS a IoT Edge 1.4 LTS. IoT Edge 1.4 LTS je konec životnosti 12. listopadu 2024. Pokud používáte starší verzi, podívejte se na článek Aktualizace IoT Edge.

Jakmile vytvoříte moduly Azure IoT Edge s obchodní logikou, chcete je nasadit do zařízení, aby fungovaly na hraničních zařízeních. Pokud máte více modulů, které spolupracují na shromažďování a zpracování dat, můžete je nasadit najednou. Můžete také deklarovat 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žby zřizování zařízení a propojené rozbočovače. Nové rozšíření IoT rozšiřuje Azure CLI o funkce, jako je správa zařízení a úplná funkce IoT Edge.

Tento článek ukazuje, jak vytvořit manifest nasazení JSON a pak 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

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

• Zařízení IoT Edge

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

• Azure CLI ve vašem prostředí. Minimálně vaše verze Azure CLI musí být 2.0.70 nebo vyšší. Ke kontrole použijte příkaz az --version. Tato verze podporuje příkazy rozšíření az a zavádí příkazové rozhraní 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í způsobu použití, konfigurace a opětovného použití modulů IoT Edge.

Pokud chcete nasadit moduly pomocí Azure CLI, uložte manifest nasazení místně jako soubor .json. Cestu k souboru v další části použijete při spuštění příkazu pro použití konfigurace 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. Verze schématu 1.1 byla vydána společně se službou 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 složce konfigurace adresáře řešení a ne soubordeployment.template.json.deployment.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