Samouczek: konfigurowanie środowiska na potrzeby przewodników Szybki start i samouczków usługi IoT Plug and Play
Przed ukończeniem dowolnego z przewodników Szybki start i samouczków usługi IoT Plug and Play należy skonfigurować centrum IoT i usługę Device Provisioning Service (DPS) w ramach subskrypcji platformy Azure. Będziesz również potrzebować lokalnych kopii plików modelu używanych przez przykładowe aplikacje i narzędzie Azure IoT Explorer.
Ważne
Ten artykuł zawiera kroki nawiązywania połączenia z usługą przy użyciu sygnatury dostępu współdzielonego. Ta metoda uwierzytelniania jest wygodna do testowania i oceny, ale uwierzytelnianie w usłudze przy użyciu identyfikatora Entra firmy Microsoft lub tożsamości zarządzanych jest bardziej bezpieczne. Aby dowiedzieć się więcej, zobacz Security best practices Cloud security (Najlepsze rozwiązania > dotyczące zabezpieczeń w chmurze).
Wymagania wstępne
Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
Przygotowywanie środowiska dla interfejsu wiersza polecenia platformy Azure
Użyj środowiska powłoki Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Szybki start dotyczący powłoki Bash w usłudze Azure Cloud Shell.
Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.
Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.
Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure podczas pierwszego użycia. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.
Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.
Tworzenie zasobów
Utwórz grupę zasobów platformy Azure dla zasobów:
az group create --name my-pnp-resourcegroup --location centralus
Utwórz centrum IoT. Następujące polecenie używa nazwy my-pnp-hub jako przykładu nazwy centrum IoT Do utworzenia. Wybierz unikatową nazwę centrum IoT, która ma być używana zamiast my-pnp-hub:
az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2
Utwórz wystąpienie usługi DPS. Następujące polecenie używa nazwy my-pnp-dps jako przykładu nazwy wystąpienia usługi DPS do utworzenia. Wybierz unikatową nazwę wystąpienia usługi DPS, która ma być używana zamiast elementu my-pnp-dps:
az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup
Aby połączyć wystąpienie usługi DPS z centrum IoT Hub, użyj następujących poleceń. Zamień my-pnp-dps wartości i my-pnp-hub na unikatowe nazwy wybrane wcześniej:
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
Pobieranie ustawień
Niektóre przewodniki Szybki start i samouczki używają parametry połączenia dla centrum IoT. Podczas konfigurowania narzędzia Azure IoT Explorer potrzebne są również parametry połączenia. Pobierz parametry połączenia i zanotuj ją teraz. Zastąp my-pnp-hub element unikatową nazwą wybraną dla centrum IoT:
az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString
Większość przewodników Szybki start i samouczków używa zakresu identyfikatorów konfiguracji usługi DPS. Pobierz zakres identyfikatora i zanotuj go teraz. Zastąp my-pnp-dps element unikatową nazwą wybraną dla wystąpienia usługi DPS:
az iot dps show --name my-pnp-dps --query properties.idScope
Wszystkie przewodniki Szybki start i samouczki korzystają z rejestracji urządzeń z usługą DPS. Użyj następującego polecenia, aby utworzyć rejestrację my-pnp-device poszczególnych urządzeń w wystąpieniu usługi DPS. Zastąp my-pnp-dps element unikatową nazwą wybraną dla wystąpienia usługi DPS. Zanotuj identyfikator rejestracji i wartości klucza podstawowego, które mają być używane w przewodnikach Szybki start i samouczkach:
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}'
Tworzenie zmiennych środowiskowych
Utwórz pięć zmiennych środowiskowych, aby skonfigurować przykłady w przewodnikach Szybki start i samouczkach, aby używać usługi Device Provisioning Service (DPS) do nawiązywania połączenia z centrum IoT:
- IOTHUB_DEVICE_SECURITY_TYPE: wartość
DPS. - IOTHUB_DEVICE_DPS_ID_SCOPE: zakres identyfikatora usługi DPS zanotował wcześniej.
- IOTHUB_DEVICE_DPS_DEVICE_ID: wartość
my-pnp-device. - IOTHUB_DEVICE_DPS_DEVICE_KEY: klucz podstawowy rejestracji zanotował wcześniej.
- IOTHUB_DEVICE_DPS_ENDPOINT: wartość
global.azure-devices-provisioning.net
Przykłady usługi wymagają następujących zmiennych środowiskowych, aby zidentyfikować centrum i urządzenie w celu nawiązania połączenia z:
- IOTHUB_CONNECTION_STRING: centrum IoT hub parametry połączenia zanotował wcześniej.
- IOTHUB_DEVICE_ID:
my-pnp-device.
Na przykład w powłoce powłoki bash systemu Linux:
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"
Na przykład w wierszu polecenia systemu 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
Pobieranie plików modelu
Przewodniki Szybki start i samouczki używają przykładowych plików modelu dla kontrolera temperatury i urządzeń termostatu. Aby pobrać przykładowe pliki modelu:
Utwórz folder o nazwie models na komputerze lokalnym.
Kliknij prawym przyciskiem myszy TemperatureController.json i zapisz plik JSON w folderze models .
Kliknij prawym przyciskiem myszy Thermostat.json i zapisz plik JSON w folderze models .
Instalowanie eksploratora usługi Azure IoT
Przewodniki Szybki start i samouczki korzystają z narzędzia Azure IoT Explorer . Przejdź do pozycji Wydania eksploratora usługi Azure IoT i rozwiń listę zasobów dla najnowszej wersji. Pobierz i zainstaluj najnowszą wersję aplikacji dla systemu operacyjnego.
Przy pierwszym uruchomieniu narzędzia zostanie wyświetlony monit o parametry połączenia centrum IoT Hub. Użyj parametry połączenia zanotuj wcześniej.
Skonfiguruj narzędzie do używania pobranych wcześniej plików modelu. Na stronie głównej w narzędziu wybierz pozycję Ustawienia wtyczek i odtwarzania IoT, a następnie pozycję + Dodaj > folder lokalny. Wybierz utworzony wcześniej folder models. Następnie wybierz pozycję Zapisz , aby zapisać ustawienia.
Aby dowiedzieć się więcej, zobacz Instalowanie i używanie eksploratora usługi Azure IoT.
Czyszczenie zasobów
Możesz użyć wystąpienia centrum IoT i usługi DPS dla wszystkich przewodników Szybki start i samouczków usługi IoT Plug and Play, więc tylko raz musisz wykonać kroki opisane w tym artykule. Po zakończeniu możesz usunąć je z subskrypcji za pomocą następującego polecenia:
az group delete --name my-pnp-resourcegroup
Następne kroki
Po skonfigurowaniu środowiska możesz wypróbować jeden z przewodników Szybki start lub samouczków, takich jak: