Szybki start: konfigurowanie usługi IoT Hub Device Provisioning przy użyciu interfejsu wiersza polecenia platformy Azure
Interfejs wiersza polecenia platformy Azure umożliwia tworzenie zasobów Azure i zarządzanie nimi z poziomu wiersza polecenia lub skryptów. Ten przewodnik Szybki start zawiera szczegółowe informacje dotyczące tworzenia centrum IoT i wystąpienia usługi IoT Hub Device Provisioning przy użyciu interfejsu wiersza polecenia platformy Azure oraz łączenia obu usług.
Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto platformy Azure.
Ważne
Zarówno centrum IoT, jak i usługa aprowizacji utworzona w tym przewodniku Szybki start będą publicznie odnajdywalne jako punkty końcowe DNS. Pamiętaj, że należy unikać wszelkich poufnych informacji, jeśli zdecydujesz się zmienić nazwy używane dla tych zasobów.
Wymagania wstępne
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 grupy zasobów
Utwórz grupę zasobów za pomocą polecenia az group create. Grupa zasobów platformy Azure to logiczny kontener przeznaczony do wdrażania zasobów platformy Azure i zarządzania nimi.
Poniższy przykład obejmuje tworzenie grupy zasobów o nazwie my-sample-resource-group w lokalizacji westus.
az group create --name my-sample-resource-group --location westus
Napiwek
Ten przykład tworzy grupę zasobów w lokalizacji Zachodnie stany USA. Listę dostępnych lokalizacji można wyświetlić, uruchamiając polecenie az account list-locations -o table.
Tworzenie centrum IoT
Utwórz centrum IoT za pomocą polecenia az iot hub create.
Poniższy przykład tworzy centrum IoT o nazwie my-sample-hub w lokalizacji westus. Nazwa centrum IoT musi być globalnie unikatowa na platformie Azure, dlatego dodaj unikatowy prefiks lub sufiks do przykładowej nazwy lub całkowicie wybierz nową nazwę. Upewnij się, że nazwa jest zgodna z odpowiednimi konwencjami nazewnictwa centrum IoT: powinna mieć długość od 3 do 50 znaków i może zawierać tylko wielkie lub małe litery alfanumeryczne lub łączniki ('-').
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus
Tworzenie wystąpienia usługi Device Provisioning Service
Utwórz wystąpienie usługi Device Provisioning Service za pomocą polecenia az iot dps create .
Poniższy przykład tworzy wystąpienie usługi Device Provisioning Service o nazwie my-sample-dps w lokalizacji westus . Musisz również wybrać globalnie unikatową nazwę dla własnego wystąpienia. Upewnij się, że są zgodne z odpowiednimi konwencjami nazewnictwa dla usługi IoT Hub Device Provisioning Service: powinna mieć długość od 3 do 64 znaków i może zawierać tylko wielkie lub małe litery alfanumeryczne lub łączniki ('-').
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus
Napiwek
Ten przykład tworzy usługę aprowizowania w lokalizacji Zachodnie stany USA. Można wyświetlić listę dostępnych lokalizacji, uruchamiając polecenie az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table lub przechodząc do strony Stan platformy Azure i wyszukując usługę „Device Provisioning”. W poleceniach lokalizacje można określić w jednym formacie wyrazu lub w wielu wyrazach; na przykład: westus, Zachodnie stany USA, Zachodnie stany USA itp. Wartość nie uwzględnia wielkości liter. Jeśli do określenia lokalizacji używasz formatu wielu słów, ujmij wartość w cudzysłowy, na przykład --location "West US".
W celu zapewnienia odporności i niezawodności zalecamy wdrożenie w jednym z regionów obsługujących Strefy dostępności.
Pobieranie parametrów połączenia dla centrum IoT
Parametry połączenia centrum IoT są potrzebne do połączenia go z usługą aprowizacji urządzenia. Użyj polecenia az iot hub connection-string show, aby uzyskać parametry połączenia i użyć jego danych wyjściowych, aby ustawić zmienną używaną później podczas łączenia dwóch zasobów.
Poniższy przykład ustawia zmienną hub Połączenie ionString na wartość parametry połączenia klucza podstawowego zasad iothubowner centrum (--policy-nameparametr może służyć do określania innych zasad). Wyprzedaj nazwę centrum my-sample-hub dla unikatowej wybranej wcześniej nazwy centrum IoT. Polecenie używa opcji query i output interfejsu wiersza polecenia platformy Azure, aby wyodrębnić parametry połączenia z danych wyjściowych polecenia.
hubConnectionString=$(az iot hub connection-string show --name my-sample-hub --key primary --query connectionString -o tsv)
Aby wyświetlić parametry połączenia, możesz użyć polecenia echo.
echo $hubConnectionString
Uwaga
Te dwa polecenia są prawidłowe dla hosta z powłoką Bash.
Jeśli używasz lokalnej powłoki systemu Windows/CMD lub hosta programu PowerShell, zmodyfikuj polecenia, aby użyć poprawnej składni dla tego środowiska.
Jeśli używasz usługi Azure Cloud Shell, sprawdź, czy lista rozwijana środowiska po lewej stronie okna powłoki to Bash.
Łączenie centrum IoT z usługą aprowizowania
Połącz centrum IoT i usługę aprowizowania za pomocą polecenia az iot dps linked-hub create.
Poniższy przykład zawiera linki do centrum IoT o nazwie my-sample-hub w lokalizacji westus i usługi Device Provisioning o nazwie my-sample-dps. Wymienić te nazwy dla unikatowych nazw centrum IoT i usługi Device Provisioning, które zostały wybrane wcześniej. Polecenie używa parametry połączenia dla centrum IoT Hub przechowywanego w zmiennej hub Połączenie ionString w poprzednim kroku.
az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus
Wykonanie polecenia może potrwać kilka minut.
Sprawdzanie usługi aprowizowania
Pobierz szczegóły dotyczące usługi aprowizowania za pomocą polecenia az iot dps show.
Poniższy przykład pobiera szczegółowe dane usługi aprowizowania o nazwie my-sample-dps. Wyprzedaj tę nazwę dla własnej nazwy usługi Device Provisioning Service.
az iot dps show --name my-sample-dps
Połączone centrum IoT jest wyświetlane w kolekcji properties.iotHubs.
Czyszczenie zasobów
Inne przewodniki Szybki start w tej kolekcji bazują na tym przewodniku. Jeśli planujesz kontynuować pracę z kolejnymi przewodnikami Szybki start lub samouczkami, nie usuwaj zasobów utworzonych w tym przewodniku Szybki start. Jeśli nie planujesz kontynuować, możesz użyć następujących poleceń, aby usunąć usługę aprowizacji, centrum IoT lub grupę zasobów i wszystkie jej zasoby. Zastąp nazwy zasobów zawartych w poniższych poleceniach nazwami własnych zasobów.
Aby usunąć usługę aprowizowania, uruchom polecenie az iot dps delete:
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
Aby usunąć centrum IoT, uruchom polecenie az iot hub delete:
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
Aby usunąć grupę zasobów i wszystkie jej zasoby, uruchom polecenie az group delete:
az group delete --name my-sample-resource-group
Następne kroki
W tym przewodniku Szybki start wdrożono centrum IoT i wystąpienie usługi Device Provisioning Service oraz połączono te dwa zasoby. Aby dowiedzieć się, jak za pomocą tej konfiguracji aprowizować urządzenie, przejdź do przewodnika Szybki start dotyczącego tworzenia urządzenia.