Wdrażanie modułów usługi Azure IoT Edge z witryny Azure Portal

Dotyczy: IoT Edge 1.5 IoT Edge 1.4

Ważne

Obsługiwane są wersje usługi IoT Edge 1.5 LTS i IoT Edge 1.4 LTS. Usługa IoT Edge 1.4 LTS kończy się 12 listopada 2024 r. Jeśli korzystasz z wcześniejszej wersji, zobacz aktualizację Azure IoT Edge.

Ważne

Od 28 sierpnia 2024 r. witryna Azure Marketplace aktualizuje model dystrybucji dla modułów usługi IoT Edge. Partnerzy (wydawcy modułów) zaczną hostować moduły usługi IoT Edge w rejestrach kontenerów należących do wydawcy. Obrazy modułów usługi IoT Edge nie będą dostępne do pobrania z rejestru kontenerów witryny Azure Marketplace.

Skontaktuj się z wydawcą modułu usługi IoT Edge, aby uzyskać zaktualizowany identyfikator URI obrazu kontenera i zaktualizować konfiguracje urządzeń usługi IoT Edge przy użyciu nowego identyfikatora URI obrazu dostarczonego przez wydawcę.

Nie ma to wpływu na urządzenia usługi IoT Edge, które nie korzystają z modułów partnerskich uzyskanych z witryny Azure Marketplace i nie są wymagane żadne działania.

Po utworzeniu modułów usługi IoT Edge przy użyciu logiki biznesowej chcesz wdrożyć je na urządzeniach, aby działały na brzegu sieci. Jeśli masz wiele modułów, które współpracują ze sobą w celu zbierania i przetwarzania danych, możesz wdrożyć je wszystkie jednocześnie i zadeklarować reguły routingu, które je łączą.

W tym artykule pokazano, jak witryna Azure Portal przeprowadzi Cię przez proces tworzenia manifestu wdrożenia i wypychania wdrożenia do urządzenia usługi IoT Edge. Aby uzyskać informacje na temat tworzenia wdrożenia przeznaczonego dla wielu urządzeń na podstawie ich udostępnionych tagów, zobacz Wdrażanie i monitorowanie modułów usługi IoT Edge na dużą skalę.

Wymagania wstępne

• Usługa IoT Hub w ramach subskrypcji platformy Azure.

• Urządzenie usługi IoT Edge.

  Jeśli nie masz skonfigurowanego urządzenia usługi IoT Edge, możesz go utworzyć na maszynie wirtualnej platformy Azure. Wykonaj kroki opisane w jednym z artykułów szybki start, aby utworzyć wirtualne urządzenie z systemem Linux lub utworzyć wirtualne urządzenie z systemem Windows.

Konfigurowanie manifestu wdrożenia

Manifest wdrożenia to dokument JSON opisujący moduły do wdrożenia, sposób przepływu danych między modułami i żądane właściwości bliźniaczych reprezentacji modułu. Aby uzyskać więcej informacji na temat sposobu działania manifestów wdrażania i sposobu ich tworzenia, zobacz Opis sposobu używania, konfigurowania i ponownego używania modułów usługi IoT Edge.

Witryna Azure Portal zawiera kreatora, który przeprowadzi Cię przez proces tworzenia manifestu wdrożenia zamiast ręcznego kompilowania dokumentu JSON. Ma trzy kroki: Dodawanie modułów, Określanie tras i Przeglądanie wdrożenia.

Uwaga

Kroki opisane w tym artykule odzwierciedlają najnowszą wersję schematu agenta i centrum usługi IoT Edge. Wersja schematu 1.1 została wydana wraz z usługą IoT Edge w wersji 1.0.10 i włącza funkcje kolejności uruchamiania modułu i priorytetyzacji tras.

Jeśli wdrażasz na urządzeniu w wersji 1.0.9 lub starszej, edytuj ustawienia środowiska uruchomieniowego w kroku Moduły kreatora, aby użyć schematu w wersji 1.0.

Wybieranie urządzenia i dodawanie modułów

1. Zaloguj się do witryny Azure Portal i przejdź do usługi IoT Hub.

2. W okienku po lewej stronie wybierz pozycję Urządzenia w menu Zarządzanie urządzeniami .

3. Wybierz docelowe urządzenie usługi IoT Edge z listy.

4. Na górnym pasku wybierz pozycję Ustaw moduły.

5. W sekcji Poświadczenia rejestru kontenerów na stronie podaj poświadczenia umożliwiające dostęp do rejestrów kontenerów zawierających obrazy modułów. Na przykład moduły znajdują się w prywatnym rejestrze kontenerów lub korzystasz z rejestru kontenerów partnera, który wymaga uwierzytelniania.

6. W sekcji Moduły usługi IoT Edge na stronie wybierz pozycję Dodaj.

   

7. Wybierz typ modułów, które chcesz dodać z menu rozwijanego. Możesz dodać moduły usługi IoT Edge lub moduły usługi Azure Stream Analytics.

Moduł usługi IoT Edge

Użyj tej opcji, aby dodać moduły firmy Microsoft, moduły partnerskie lub moduły niestandardowe. Podaj nazwę modułu i identyfikator URI obrazu kontenera. Identyfikator URI obrazu kontenera to lokalizacja obrazu modułu w rejestrze kontenerów. Aby uzyskać listę obrazów modułów usługi Microsoft IoT Edge, zobacz Rejestr Artefaktów Microsoft. W przypadku modułów partnerskich skontaktuj się z wydawcą modułu usługi IoT Edge, aby uzyskać identyfikator URI obrazu kontenera.

Aby na przykład dodać moduł czujnika temperatury symulowanej przez firmę Microsoft:

1. Wprowadź następujące ustawienia:

   Ustawienie	Wartość
   Identyfikator URI obrazu	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor
   Zasady ponownego uruchamiania	zawsze
   Żądany stan	uruchomiono

   

2. Wybierz Dodaj.

3. Po dodaniu modułu wybierz nazwę modułu z listy, aby otworzyć ustawienia modułu. W razie potrzeby wypełnij pola opcjonalne.

   

Aby uzyskać więcej informacji na temat dostępnych ustawień modułu, zobacz Konfiguracja modułu i zarządzanie nim.

Aby uzyskać więcej informacji na temat bliźniaczej reprezentacji modułu, zobacz Definiowanie lub aktualizowanie żądanych właściwości.

Moduł usługi Azure Stream Analytics

Użyj tej opcji dla modułów wygenerowanych na podstawie obciążenia usługi Azure Stream Analytics.

1. Wybierz subskrypcję i utworzone wcześniej zadanie usługi Azure Stream Analytics dla usługi IoT Edge.
2. Wybierz pozycję Zapisz.

Aby uzyskać więcej informacji na temat wdrażania usługi Azure Stream Analytics w module usługi IoT Edge, zobacz Samouczek: wdrażanie usługi Azure Stream Analytics jako modułu usługi IoT Edge.

Określanie tras

Na karcie Trasy zdefiniujesz sposób przekazywania komunikatów między modułami a usługą IoT Hub. Komunikaty są tworzone przy użyciu par nazwa/wartość. Domyślnie pierwsze wdrożenie nowego urządzenia obejmuje trasę o nazwie route i zdefiniowaną jako FROM /messages/* INTO $upstream, co oznacza, że wszystkie komunikaty wyjściowe przez wszystkie moduły są wysyłane do usługi IoT Hub.

Parametry Priorytet i Czas wygaśnięcia to parametry opcjonalne, które można uwzględnić w definicji trasy. Parametr priorytetu umożliwia wybranie tras, które powinny mieć przetworzone komunikaty jako pierwsze lub które trasy powinny być przetwarzane ostatnio. Priorytet jest określany przez ustawienie liczby 0–9, gdzie 0 jest priorytetem. Czas wygaśnięcia parametru umożliwia zadeklarowanie, jak długo komunikaty w tej trasie powinny być przechowywane, dopóki nie zostaną przetworzone lub usunięte z kolejki.

Aby uzyskać więcej informacji na temat tworzenia tras, zobacz Deklarowanie tras.

Po ustawieniu tras wybierz pozycję Dalej: Przejrzyj i utwórz , aby przejść do następnego kroku kreatora.

Przegląd wdrożenia

W sekcji przeglądu przedstawiono manifest wdrożenia JSON, który został utworzony na podstawie wybranych opcji w poprzednich dwóch sekcjach. Należy pamiętać, że nie dodano dwóch modułów: $edgeAgent i $edgeHub. Te dwa moduły tworzą środowisko uruchomieniowe usługi IoT Edge i są wymagane domyślnie w każdym wdrożeniu.

Przejrzyj informacje o wdrożeniu, a następnie wybierz pozycję Utwórz.

Wyświetlanie modułów na urządzeniu

Po wdrożeniu modułów na urządzeniu możesz wyświetlić wszystkie te moduły na stronie szczegółów urządzenia w usłudze IoT Hub. Ta strona zawiera nazwę każdego wdrożonego modułu, a także przydatne informacje, takie jak stan wdrożenia i kod zakończenia.

Wybierz pozycję Dalej: Trasy i kontynuuj wdrażanie zgodnie z opisem w artykule Określanie tras i Przeglądanie wdrożenia we wcześniejszej części tego artykułu.

Następne kroki

Dowiedz się, jak wdrażać i monitorować moduły usługi IoT Edge na dużą skalę.