Ćwiczenie — tworzenie aplikacji usługi Azure IoT Central
Utwórz aplikację usługi Azure IoT Central dla urządzeń usługi IoT Edge w celu nawiązania połączenia z usługą i zarządzania nimi.
Pamiętaj, że planujesz wdrożyć urządzenie usługi IoT Edge w każdym magazynie w celu zarządzania czujnikami lokalnymi i filtrowania danych wysyłanych do usługi Azure IoT Central.
W tym miejscu użyjesz interfejsu wiersza polecenia platformy Azure do utworzenia aplikacji usługi Azure IoT Central na podstawie szablonu aplikacji niestandardowej. Uruchom polecenia interfejsu wiersza polecenia w piaskownicy platformy Azure, a następnie przejdź do internetowego interfejsu użytkownika aplikacji. W internetowym interfejsie użytkownika należy ukończyć konfigurację, dodając szablon urządzenia dla urządzenia usługi IoT Edge.
Uwaga
To ćwiczenie jest opcjonalne. Jeśli chcesz wykonać to ćwiczenie, przed rozpoczęciem musisz utworzyć subskrypcję platformy Azure. Jeśli nie masz konta platformy Azure lub nie chcesz go tworzyć w tej chwili, możesz zapoznać się z instrukcjami, aby zrozumieć prezentowane informacje.
Pobieranie manifestu wdrożenia
Podczas tworzenia szablonu urządzenia dla urządzenia usługi IoT Edge potrzebny jest manifest wdrożenia i definicja interfejsu na komputerze lokalnym. Aby pobrać te pliki, kliknij prawym przyciskiem myszy następujące linki i wybierz polecenie Zapisz jako:
Pamiętaj, gdzie zapisujesz te pliki, potrzebne do późniejszego użycia.
Tworzenie i konfigurowanie aplikacji usługi Azure IoT Central
Poniższe kroki umożliwiają utworzenie aplikacji usługi Azure IoT Central i wygenerowanie tokenu interfejsu API do użycia w dalszej części tego modułu.
Uruchom następujące polecenia w usłudze Azure Cloud Shell, aby wygenerować unikatową nazwę aplikacji usługi Azure IoT Central i zapisać ją w zmiennej środowiskowej do późniejszego użycia:
APP_NAME="store-manager-$RANDOM" echo "Your application name is: $APP_NAME"Zanotuj nazwę aplikacji na wypadek utraty zmiennej środowiskowej z powodu przekroczenia limitu czasu powłoki.
Aby utworzyć aplikację usługi Azure IoT Central w piaskownicy, uruchom następujące polecenie w usłudze Cloud Shell:
az iot central app create \ --resource-group <rgn>[sandbox resource group name]</rgn> \ --name $APP_NAME --sku ST2 --location centralus \ --subdomain $APP_NAME --template iotc-pnp-preview \ --display-name 'Store Management' echo "You can now navigate to: https://$APP_NAME.azureiotcentral.com/edge-manifests"Wykonanie tego polecenia może potrwać minutę lub dwie.
Na innej karcie lub oknie przeglądarki przejdź do adresu URL wyświetlanego w danych wyjściowych poprzedniego polecenia. Ta strona internetowego interfejsu użytkownika służy do przekazywania manifestu wdrożenia usługi IoT Edge:
Wybierz pozycję Utwórz manifest krawędzi, wprowadź nazwę Czujnik środowiska, wybierz pozycję Przekaż plik, a następnie przejdź, aby wybrać pobrany wcześniej plik EnvironmentalSensorManifest-1-4.json.
Wybierz pozycję Dalej , a następnie pozycję Utwórz , aby przekazać manifest. Manifest konfiguruje trzy moduły usługi IoT Edge: edgeAgent, edgeHub i SimulatedTemperatureSensor.
Następnie wybierz pozycję Szablony urządzeń. Ta strona internetowego interfejsu użytkownika służy do tworzenia szablonu urządzenia:
Wybierz pozycję Utwórz szablon urządzenia, wybierz kafelek usługi Azure IoT Edge , a następnie wybierz pozycję Dalej: Dostosuj.
Jako nazwę szablonu urządzenia wprowadź wartość Environmental Sensor Edge Device . Następnie wybierz pozycję Dalej: Przejrzyj.
Wybierz pozycję Utwórz , aby utworzyć szablon urządzenia. Następnie wybierz pozycję Model niestandardowy, aby rozpocząć od pustego modelu.
Przekazany manifest wdrożenia zawiera moduł o nazwie SimulatedTemperatureSensor z interfejsem nazywanym zarządzaniem. Interfejs zarządzania zawiera zapisywalne właściwości SendData i SendInterval. Aby dodać te informacje do nowego szablonu urządzenia, wykonaj następujące kroki:
Na stronie szablonu urządzenia wybierz pozycję Moduły w sekcji Model .
Wybierz pozycję Importuj moduły z manifestu:
Wybierz manifest wdrożenia czujnika środowiska, aby zaimportować moduły.
Szablon urządzenia zawiera teraz moduł SimulatedTemperatureSensor z interfejsem zarządzania . Interfejs definiuje właściwości z możliwością zapisu SendData i SendInterval .
Manifest wdrożenia nie zawiera informacji o telemetrii wysyłanej przez moduły urządzenia. Aby umożliwić usłudze Azure IoT Central tworzenie wizualizacji dla telemetrii, dodaj interfejs z wymaganymi definicjami:
Wybierz moduł SimulatedTemperatureSensor, a następnie wybierz pozycję + Dodaj dziedziczony interfejs. Aby wyświetlić tę opcję, może być konieczne wybranie przycisku wielokropka (...).
Wybierz kafelek Importuj interfejs i wybierz pobrany wcześniej plik TelemetryInterface.json .
Interfejs telemetrii definiuje typy telemetrii komputera i otoczenia jako obiekty. Obiekt maszyny zawiera dane telemetryczne temperatury i ciśnienia. Obiekt otoczenia zawiera dane telemetryczne temperatury i wilgotności. Interfejs zawiera również funkcję timeCreated jako typ telemetrii DateTime .
Aby umożliwić operatorowi rejestrowanie informacji o każdym urządzeniu usługi IoT Edge, dodaj następujące właściwości chmury do modelu urządzenia Environmental Sensor Edge:
| Display name | Nazwisko | Typ możliwości | Schemat |
|---|---|---|---|
| Nazwa sklepu | StoreName | Właściwości | String |
| Data usługi | ServiceDate | Właściwości | Data |
Napiwek
Aby wyświetlić ustawienie schematu, należy rozwinąć właściwość chmury.
Wybierz Zapisz, aby zapisać zmiany.
Aby umożliwić operatorowi wyświetlanie danych środowiskowych z magazynów, dodaj następujący widok do szablonu urządzenia:
Aby dodać nowy widok, wybierz pozycję Widoki w szablonie urządzenia. Następnie wybierz kafelek Wizualizacja urządzenia .
Zmień nazwę widoku na Wyświetlanie telemetrii urządzenia usługi IoT Edge.
Wybierz pozycję Rozpocznij od urządzeń.
Dodaj typy telemetrii otoczenia/temperatury, wilgotności, maszyny/temperatury i ciśnienia, a następnie wybierz pozycję Dodaj kafelek.
Wybierz pozycję Zapisz.
Aby umożliwić operatorowi rejestrowanie informacji o każdym magazynie i zarządzaniu urządzeniem, dodaj następujący widok do szablonu urządzenia:
Aby dodać nowy widok, wybierz pozycję Widoki w szablonie urządzenia. Następnie wybierz kafelek Edytowanie danych urządzenia i chmury.
Zmień nazwę formularza na Przechowuj informacje.
Wybierz właściwości Nazwa sklepu i Data usługi w chmurze. Następnie wybierz pozycję Dodaj sekcję.
Wybierz pozycję Zapisz.
Teraz możesz opublikować szablon i dodać urządzenie:
W górnej części strony wybierz pozycję Publikuj, a następnie w oknie dialogowym Publikowanie tego szablonu urządzenia w aplikacji wybierz pozycję Publikuj.
Przejdź do strony Urządzenia w aplikacji usługi Azure IoT Central.
Wybierz szablon urządzenia Environmental Sensor Edge, a następnie wybierz pozycję + Nowy.
W oknie dialogowym Tworzenie nowego urządzenia wprowadź wartość store-001 jako identyfikator urządzenia. Upewnij się, że szablon urządzenia ma wartość Environmental Sensor Edge Device i że urządzenie usługi Azure IoT Edge jest już ustawione na Wartość Tak. Następnie wybierz pozycję Czujnik środowiska jako manifest krawędzi. Wybierz pozycję Utwórz.
Urządzenie store-001 zostanie wyświetlone na liście urządzeń ze stanem Zarejestrowane.
Sprawdź swoją pracę
Na liście urządzeń wybierz nazwę urządzenia Environmental Sensor Edge Device — store-001. Dostępne widoki urządzenia, w tym Informacje o magazynie i Wyświetlanie telemetrii urządzenia usługi IoT Edge.
W górnej części strony wybierz pozycję Połącz. Zanotuj zakres identyfikatorów i klucz podstawowy. Te wartości będą później używane do skonfigurowania urządzenia usługi IoT Edge w celu nawiązania połączenia z aplikacją.
Pozostaw tę stronę otwartą w przeglądarce internetowej. Wróć do tej aplikacji usługi Azure IoT Central później.
Utworzono aplikację do zarządzania sklepami. Utworzono szablon urządzenia zawierający manifest wdrożenia usługi IoT Edge dla urządzeń, które mają zostać zainstalowane w sklepach. Szablon zawiera widoki, które umożliwiają operatorowi zdalne monitorowanie warunków środowiskowych w magazynie i zdalne zarządzanie urządzeniami.