Kurz: Nastavení prostředí pro rychlá zprovoznění a kurzy IoT Plug and Play

Než budete moct dokončit některý z rychlých startů a kurzů IoT Plug and Play, musíte ve svém předplatném Azure nakonfigurovat centrum IoT a službu Device Provisioning (DPS). Budete také potřebovat místní kopie souborů modelu, které používají ukázkové aplikace a nástroj Azure IoT Explorer.

Požadavky

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet před tím, než začnete.

Příprava prostředí pro rozhraní příkazového řádku Azure

  • Použijte prostředí Bash v Azure Cloud Shell. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shell.

  • Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Spuštění Azure CLI v kontejneru Dockeru.

    • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.

    • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.

    • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

Vytvoření prostředků

Vytvořte skupinu prostředků Azure pro prostředky:

az group create --name my-pnp-resourcegroup --location centralus

Vytvořte centrum IoT. Následující příkaz použije název my-pnp-hub jako příklad pro název centra IoT, které chcete vytvořit. Zvolte jedinečný název centra IoT, který se má použít místo my-pnp-hub:

az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2

Vytvořte instanci DPS. Následující příkaz používá název my-pnp-dps jako příklad pro název instance DPS, která se má vytvořit. Zvolte jedinečný název instance SLUŽBY DPS, který se má použít místo my-pnp-dps:

az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup

K propojení instance DPS se službou IoT Hub použijte následující příkazy. Nahraďte my-pnp-dps a my-pnp-hub jedinečnými názvy, které jste zvolili dříve:

hubConnectionString=$(az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString -o tsv)
az iot dps linked-hub create --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --location centralus --connection-string $hubConnectionString

Načtení nastavení

Některé rychlé starty a kurzy používají připojovací řetězec pro vaše centrum IoT. Připojovací řetězec budete potřebovat také při nastavování nástroje Azure IoT Explorer. Načtěte připojovací řetězec a poznamenejte si ho. Nahraďte my-pnp-hub jedinečným názvem, který jste zvolili pro centrum IoT:

az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString

Většina rychlých startů a kurzů používá obor ID vaší konfigurace DPS. Načtěte obor ID a poznamenejte si ho. Nahraďte my-pnp-dps jedinečným názvem, který jste zvolili pro instanci SLUŽBY DPS:

az iot dps show --name my-pnp-dps --query properties.idScope

Všechny rychlé starty a kurzy používají registraci zařízení DPS. Pomocí následujícího příkazu vytvořte my-pnp-device v instanci SLUŽBY DPS registraci jednotlivých zařízení. Nahraďte my-pnp-dps jedinečným názvem, který jste zvolili pro instanci DPS. Poznamenejte si ID registrace a hodnoty primárního klíče, které se použijí v rychlých startech a kurzech:

az iot dps enrollment create --attestation-type symmetrickey --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --enrollment-id my-pnp-device --device-id my-pnp-device --query '{registrationID:registrationId,primaryKey:attestation.symmetricKey.primaryKey}'

Vytvoření proměnných prostředí

Vytvořte pět proměnných prostředí pro konfiguraci ukázek v rychlých startech a kurzech pro použití služby Device Provisioning (DPS) pro připojení k centru IoT:

  • IOTHUB_DEVICE_SECURITY_TYPE: hodnota DPS.
  • IOTHUB_DEVICE_DPS_ID_SCOPE: Obor ID služby DPS, který jste si předtím poznamenali.
  • IOTHUB_DEVICE_DPS_DEVICE_ID: hodnota my-pnp-device.
  • IOTHUB_DEVICE_DPS_DEVICE_KEY: Primární klíč registrace, který jste si předtím poznamenali.
  • IOTHUB_DEVICE_DPS_ENDPOINT: hodnota global.azure-devices-provisioning.net

Ukázky služeb potřebují k identifikaci centra a zařízení, ke kterému se má připojit, následující proměnné prostředí:

  • IOTHUB_CONNECTION_STRING: Připojovací řetězec ioT Hubu, který jste si předtím poznamenali.
  • IOTHUB_DEVICE_ID: my-pnp-device.

Například v prostředí Linux Bash:

export IOTHUB_DEVICE_SECURITY_TYPE="DPS"
export IOTHUB_DEVICE_DPS_ID_SCOPE="<Your ID scope>"
export IOTHUB_DEVICE_DPS_DEVICE_ID="my-pnp-device"
export IOTHUB_DEVICE_DPS_DEVICE_KEY="<Your enrolment primary key>"
export IOTHUB_DEVICE_DPS_ENDPOINT="global.azure-devices-provisioning.net"
export IOTHUB_CONNECTION_STRING="<Your IoT hub connection string>"
export IOTHUB_DEVICE_ID="my-pnp-device"

Například na příkazovém řádku Windows:

set IOTHUB_DEVICE_SECURITY_TYPE=DPS
set IOTHUB_DEVICE_DPS_ID_SCOPE=<Your ID scope>
set IOTHUB_DEVICE_DPS_DEVICE_ID=my-pnp-device
set IOTHUB_DEVICE_DPS_DEVICE_KEY=<Your enrolment primary key>
set IOTHUB_DEVICE_DPS_ENDPOINT=global.azure-devices-provisioning.net
set IOTHUB_CONNECTION_STRING=<Your IoT hub connection string>
set IOTHUB_DEVICE_ID=my-pnp-device

Stažení souborů modelu

V rychlých startech a kurzech se používají ukázkové soubory modelů pro regulátor teploty a termostatická zařízení. Stažení ukázkových souborů modelu:

  1. Na místním počítači vytvořte složku s názvem models .

  2. Klikněte pravým tlačítkem na TemperatureController.json a uložte soubor JSON do složky models .

  3. Klikněte pravým tlačítkem na Soubor Termostat.json a uložte soubor JSON do složky models .

Instalace Azure IoT Exploreru

V rychlých startech a kurzech se používá nástroj Azure IoT Explorer . Přejděte do vydání Azure IoT Exploreru a rozbalte seznam prostředků pro nejnovější verzi. Stáhněte a nainstalujte nejnovější verzi aplikace pro váš operační systém.

Při prvním spuštění nástroje se zobrazí výzva k zadání připojovacího řetězce služby IoT Hub. Použijte připojovací řetězec, který jste si předtím poznamenali.

Nakonfigurujte nástroj tak, aby používal soubory modelů, které jste stáhli dříve. Na domovské stránce nástroje vyberte IoT Plug and Play Nastavení a pak + Přidat > místní složku. Vyberte složku modelů , kterou jste vytvořili dříve. Pak vyberte Uložit a uložte nastavení.

Další informace najdete v tématu Instalace a používání Azure IoT Exploreru.

Vyčištění prostředků

Centrum IoT a instanci DPS můžete použít pro všechna rychlá zprovoznění a kurzy IoT Plug and Play, takže kroky v tomto článku stačí provést jenom jednou. Až to budete mít, můžete je ze svého předplatného odebrat pomocí následujícího příkazu:

az group delete --name my-pnp-resourcegroup

Další kroky

Teď, když jste nastavili prostředí, můžete vyzkoušet některý z rychlých startů nebo kurzů, jako například: