Cvičení – konfigurace IoT Edge v IoT Hubu

Dokončeno

Použití Azure Cloud Shellu

Pokud chcete spustit Azure Cloud Shell, spusťte Cloud Shell z horní navigační lišty webu Azure Portal.

An illustration is showing how to open Azure Cloud Shell.

Pomocí následujícího příkazu musíte nainstalovat rozšíření Azure IoT pro Azure CLI. Toto rozšíření spravuje prostředky Azure, jako je například IoT Hub.

az extension add --name azure-iot

Poznámka:

Tento článek používá nejnovější verzi rozšíření Azure IoT, která se nazývá azure-iot. Starší verze se nazývá azure-cli-iot-ext. Najednou byste měli mít nainstalovanou jenom jednu verzi. Pokud chcete zjistit, jaká rozšíření jste nainstalovali, použijte az extension list.

Slouží az extension remove --name azure-cli-iot-ext k odebrání starší verze rozšíření.

Slouží az extension add --name azure-iot k přidání nové verze rozšíření.

Vytvoření skupiny prostředků

V umístění eastus2 vytvořte skupinu prostředků. Použijte k tomu následující příkaz. Určete název skupiny prostředků.

az group create --name <resource-group> --location eastus2

Vytvoření centra IoT

Následující kód vytvoří ve skupině prostředků bezplatné centrum F1. Položku {hub_name} nahraďte jedinečným názvem vašeho centra IoT a nahraďte <skupinu> prostředků názvem vaší skupiny prostředků.

az iot hub create --resource-group <resource-group> --name {hub_name} --sku F1 --partition-count 2

Registrace zařízení IoT Edge do Iot Hubu

Vytvořte pro své zařízení IoT Edge identitu zařízení.

Vzhledem k tomu, že se zařízení IoT Edge chovají a dají se spravovat jinak než typická zařízení IoT, deklarujte tuto identitu jako zařízení IoT Edge s příznakem --edge-enabled .

Poznámka:

Pokud dojde k chybě kvůli tomu, že vaše předplatné již jedno bezplatné centrum obsahuje, změňte skladovou položku na S1. V každém předplatném může být jenom jeden bezplatný IoT Hub. Pokud se zobrazí chyba, že název centra IoT není dostupný, znamená to, že s tímto názvem už má centrum někdo jiný.

V Azure Cloud Shellu zadejte následující příkaz, kterým v centru vytvoříte zařízení myEdgeDevice.

az iot hub device-identity create --hub-name {hub_name} --device-id myEdgeDevice --edge-enabled

Načtení připojovacího řetězce pro vaše zařízení

K načtení připojovacího řetězce vašeho zařízení, který propojí fyzické zařízení s jeho identitou v IoT Hubu, použijte tento příkaz:

az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name {hub_name} --output table

Výsledný výstup by měl vypadat přibližně takto:

HostName={YourIoTHubName}.azure-devices.net;DeviceId=MyNodeDevice;SharedAccessKey={YourSharedAccessKey}

Zkopírujte hodnotu klíče connectionString z výstupu JSON a uložte ji. Tato hodnota je připojovací řetězec zařízení. Použijete ho ke konfiguraci modulu runtime IoT Edge v další části.

Nasazení zařízení IoT Edge

Pomocí následujícího příkazu rozhraní příkazového řádku vytvořte zařízení IoT Edge na základě předem připravené šablony iotedge-vm-deploy . Zkopírujte následující příkaz do textového editoru, nahraďte zástupný text informacemi a zkopírujte ho do okna prostředí Bash nebo Cloud Shell:

az deployment group create \
--resource-group IoTEdgeResources \
--template-uri "https://aka.ms/iotedge-vm-deploy" \
--parameters dnsLabelPrefix='<REPLACE_WITH_VM_NAME>' \
--parameters adminUsername='azureuser' \
--parameters deviceConnectionString=$(az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name
<REPLACE_WITH_HUB_NAME> -o tsv) \
--parameters authenticationType='password' \
--parameters adminPasswordOrKey="<REPLACE_WITH_PASSWORD>"

Ujistěte se, že heslo (adminPasswordOrKey) musí mít délku nejméně 12 znaků a musí mít tři z následujících čtyř znaků: malá písmena, velká písmena, číslice a speciální znaky.

Vytvoření a spuštění nového virtuálního počítače může trvat několik minut. Po dokončení nasazení byste měli obdržet výstup ve formátu JSON v rozhraní příkazového řádku, který obsahuje informace SSH pro připojení k virtuálnímu počítači. Zkopírujte hodnotu veřejné položky SSH oddílu s výstupy .

Důležité

Modul pro rozpoznávání jazyka IoT Edge vyžaduje, aby váš virtuální počítač měl alespoň 8 GB paměti a 16 GB diskového úložiště. Pokud použijete výchozí velikost virtuálního počítače definovanou v šabloně nasazení, modul selže. Změňte velikost virtuálního počítače na aspoň na D2s_v3. Informace o změně velikosti virtuálních počítačů najdete v tématu Změna velikosti virtuálního počítače. Další informace o rozšíření diskového úložiště naleznete v tématu Postup rozšíření virtuálních pevných disků připojených k virtuálnímu počítači s Windows.

Zobrazení stavu modulu runtime IoT Edge

Pokud se chcete připojit k virtuálnímu počítači, použijte následující příkaz. Nahraďte azureuser , pokud jste použili jiné uživatelské jméno, než je uživatelské jméno navrhované během nasazení virtuálního počítače. Nahraďte {DNS name} názvem DNS vašeho počítače.

ssh {admin username}@{DNS name}

Jak najít název DNS:

  1. Přejděte k vytvořené skupině prostředků.
  2. Výběr prostředku virtuálního počítače
  3. Na stránce Přehled najdete název DNS.

Kontrola konfigurace zařízení IoT Edge

Příkazy iotedge zkontrolujete, jestli proces démon zabezpečení IoT Edge běží jako systémová služba. Ke spouštění příkazů iotedge potřebujete zvýšená oprávnění.

Důležité

Ke spouštění příkazů iotedge potřebujete zvýšená oprávnění.

Spuštěním následujících příkazů otestujte stav zařízení IoT Edge:

sudo systemctl status iotedge

Výsledný výstup by měl vypadat přibližně takto:

An illustration is showing status of Azure IoT Edge Deamon.

Teď je zařízení IoT Edge nakonfigurované. Je připravené na spouštění modulů nasazených v cloudu.

Pokud potřebujete řešit potíže se službou, načtěte protokoly služby.

journalctl -u iotedge

Zobrazte všechny moduly spuštěné na vašem zařízení IoT Edge. Vzhledem k tomu, že jde o první spuštění služby, měl by se zobrazit pouze spuštěný modul edgeAgent. Modul edgeAgent běží ve výchozím nastavení a pomáhá nainstalovat a spustit všechny další moduly, které nasadíte do zařízení.

sudo iotedge list