Självstudie: Konfigurera din miljö för snabbstarter och självstudier för IoT Plug and Play
Innan du kan slutföra någon av snabbstarterna och självstudierna för IoT Plug and Play måste du konfigurera en IoT-hubb och Device Provisioning Service (DPS) i din Azure-prenumeration. Du behöver också lokala kopior av modellfilerna som används av exempelprogrammen och Azure IoT Explorer-verktyget.
Viktigt!
Den här artikeln innehåller steg för att ansluta till en tjänst med hjälp av en signatur för delad åtkomst. Den här autentiseringsmetoden är praktisk för testning och utvärdering, men autentisering till en tjänst med Microsoft Entra-ID eller hanterade identiteter är en säkrare metod. Mer information finns i Metodtips för > säkerhet Molnsäkerhet.
Förutsättningar
Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.
Förbereda din miljö för Azure CLI
Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.
Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.
Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.
När du uppmanas att installera Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda tillägg med Azure CLI.
Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.
Skapa resurserna
Skapa en Azure-resursgrupp för resurserna:
az group create --name my-pnp-resourcegroup --location centralus
Skapa en IoT-hubb. Följande kommando använder namnet my-pnp-hub som ett exempel för namnet på IoT-hubben för att skapa. Välj ett unikt namn för din IoT-hubb som ska användas i stället my-pnp-hubför :
az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2
Skapa en DPS-instans. Följande kommando använder namnet my-pnp-dps som ett exempel på namnet på DPS-instansen som ska skapas. Välj ett unikt namn för dps-instansen som ska användas i stället my-pnp-dpsför :
az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup
Om du vill länka DPS-instansen till din IoT-hubb använder du följande kommandon. Ersätt my-pnp-dps och my-pnp-hub med de unika namn som du valde tidigare:
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
Hämta inställningarna
Vissa snabbstarter och självstudier använder anslutningssträng för din IoT-hubb. Du behöver också anslutningssträng när du konfigurerar Azure IoT Explorer-verktyget. Hämta anslutningssträng och anteckna det nu. Ersätt my-pnp-hub med det unika namn som du valde för din IoT-hubb:
az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString
De flesta av snabbstarterna och självstudierna använder ID-omfånget för DPS-konfigurationen. Hämta ID-omfånget och anteckna det nu. Ersätt my-pnp-dps med det unika namn som du valde för din DPS-instans:
az iot dps show --name my-pnp-dps --query properties.idScope
Alla snabbstarter och självstudier använder en DPS-enhetsregistrering. Använd följande kommando för att skapa en my-pnp-device enskild enhetsregistrering i din DPS-instans. Ersätt my-pnp-dps med det unika namn som du valde för din DPS-instans. Anteckna registrerings-ID:t och primärnyckelvärdena som ska användas i snabbstarterna och självstudierna:
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}'
Skapa miljövariabler
Skapa fem miljövariabler för att konfigurera exemplen i snabbstarterna och självstudierna för att använda Device Provisioning Service (DPS) för att ansluta till din IoT-hubb:
- IOTHUB_DEVICE_SECURITY_TYPE: värdet
DPS. - IOTHUB_DEVICE_DPS_ID_SCOPE: DPS-ID-omfånget som du antecknade tidigare.
- IOTHUB_DEVICE_DPS_DEVICE_ID: värdet
my-pnp-device. - IOTHUB_DEVICE_DPS_DEVICE_KEY: den primära registreringsnyckel som du antecknade tidigare.
- IOTHUB_DEVICE_DPS_ENDPOINT: värdet
global.azure-devices-provisioning.net
Tjänstexemplen behöver följande miljövariabler för att identifiera hubben och enheten som ska anslutas till:
- IOTHUB_CONNECTION_STRING: IoT-hubben anslutningssträng du antecknade tidigare.
- IOTHUB_DEVICE_ID:
my-pnp-device.
Till exempel i ett Linux bash-gränssnitt:
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"
Till exempel på Windows-kommandoraden:
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
Ladda ned modellfilerna
Snabbstarterna och självstudierna använder exempelmodellfiler för temperaturstyrenheten och termostatenheterna. Så här laddar du ned exempelmodellfilerna:
Skapa en mapp med namnet modeller på den lokala datorn.
Högerklicka på TemperatureController.json och spara JSON-filen i mappen models .
Högerklicka på Thermostat.json och spara JSON-filen i mappen models .
Installera Azure IoT Explorer
Snabbstarterna och självstudierna använder verktyget Azure IoT Explorer . Gå till Versioner av Azure IoT Explorer och expandera listan över tillgångar för den senaste versionen. Ladda ned och installera den senaste versionen av programmet för operativsystemet.
Första gången du kör verktyget uppmanas du att ange IoT Hub-anslutningssträng. Använd anslutningssträng som du antecknade tidigare.
Konfigurera verktyget så att det använder de modellfiler som du laddade ned tidigare. På startsidan i verktyget väljer du IoT Plug and Play-inställningar och sedan + Lägg till > lokal mapp. Välj den modellmapp som du skapade tidigare. Välj sedan Spara för att spara inställningarna.
Mer information finns i Installera och använda Azure IoT Explorer.
Rensa resurser
Du kan använda IoT Hub- och DPS-instansen för alla snabbstarter och självstudier för IoT Plug and Play, så du behöver bara slutföra stegen i den här artikeln en gång. När du är klar kan du ta bort dem från din prenumeration med följande kommando:
az group delete --name my-pnp-resourcegroup
Nästa steg
Nu när du har konfigurerat din miljö kan du prova någon av snabbstarterna eller självstudierna, till exempel: