Samouczek: przekształcanie danych za pomocą usługi Azure Stack Edge Pro FPGA na potrzeby zaawansowanego przepływu wdrażania

Artykuł
12/05/2022
Czas czytania: 7 min

W tym samouczku opisano sposób konfigurowania roli obliczeniowej dla zaawansowanego przepływu wdrażania na urządzeniu Azure Stack Edge Pro FPGA. Po skonfigurowaniu roli obliczeniowej usługa Azure Stack Edge Pro FPGA może przekształcać dane przed wysłaniem ich na platformę Azure.

Obliczenia można skonfigurować pod kątem prostego lub zaawansowanego przepływu wdrażania na urządzeniu.

Kryteria	Proste wdrożenie	Wdrożenie zaawansowane
Przeznaczony dla	Administratorzy IT	Deweloperzy
Typ	Wdrażanie modułów za pomocą usługi Azure Stack Edge	Wdrażanie modułów za pomocą usługi IoT Hub
Wdrożone moduły	Pojedynczy	Łańcuchowe lub wiele modułów

Wykonanie tej procedury może potrwać od 20 do 30 minut.

Ten samouczek zawiera informacje na temat wykonywania następujących czynności:

Konfigurowanie zasobów obliczeniowych
Dodawanie udziałów
Dodawanie wyzwalacza
Dodawanie modułu obliczeniowego
Weryfikowanie przekształcania danych i transferu

Wymagania wstępne

Przed skonfigurowaniem roli obliczeniowej na urządzeniu Azure Stack Edge Pro FPGA upewnij się, że:

Aktywowano urządzenie azure Stack Edge Pro FPGA zgodnie z opisem w temacie Połączenie, konfigurowanie i aktywowanie Pro FPGA usługi Azure Stack Edge.

Konfigurowanie zasobów obliczeniowych

Aby skonfigurować obliczenia w usłudze Azure Stack Edge Pro FPGA, utworzysz zasób IoT Hub.

W Azure Portal zasobu usługi Azure Stack Edge przejdź do obszaru Przegląd. W okienku po prawej stronie wybierz kafelek IoT Edge.
Na kafelku Włącz usługę IoT Edge wybierz pozycję Dodaj. Ta akcja umożliwia IoT Edge usługę, która umożliwia lokalne wdrażanie modułów IoT Edge na urządzeniu.

W obszarze Tworzenie usługi IoT Edge wprowadź następujące dane:

Pole	Wartość
Subskrypcja	Wybierz subskrypcję zasobu IoT Hub. Możesz wybrać tę samą subskrypcję, która jest używana przez zasób usługi Azure Stack Edge.
Grupa zasobów	Wprowadź nazwę grupy zasobów dla zasobu IoT Hub. Możesz wybrać tę samą grupę zasobów, która jest używana przez zasób usługi Azure Stack Edge.
Usługa IoT Hub	Wybierz pozycję Nowy lub Istniejący. Domyślnie warstwa standardowa (S1) jest używana do tworzenia zasobu IoT. Aby użyć zasobu IoT warstwy Bezpłatna, utwórz go, a następnie wybierz istniejący zasób.
Nazwa	Zaakceptuj wartość domyślną lub wprowadź nazwę zasobu IoT Hub.

Get started with compute 3

Wybierz pozycję Przejrzyj i utwórz. Tworzenie zasobu IoT Hub trwa kilka minut. Po utworzeniu zasobu IoT Hub zostanie zaktualizowany przegląd wskazujący, że usługa IoT Edge jest uruchomiona.

Gdy usługa IoT Edge jest skonfigurowana na urządzeniu Brzegowym, tworzy dwa urządzenia: urządzenie IoT i urządzenie IoT Edge. Oba urządzenia można wyświetlić w zasobie usługi IoT Hub. Na tym urządzeniu IoT Edge jest również uruchomione środowisko uruchomieniowe IoT Edge Runtime. W chwili obecnej dla urządzenia IoT Edge jest dostępna tylko platforma Linux.

Aby potwierdzić, że rola obliczeniowa edge została skonfigurowana, wybierz pozycję właściwości usługi > IoT Edge i wyświetl urządzenie IoT i urządzenie IoT Edge.

Dodawanie udziałów

W przypadku wdrożenia zaawansowanego w tym samouczku potrzebne są dwa udziały: jeden udział edge i inny udział lokalny usługi Edge.

Dodaj udział usługi Edge na urządzeniu, wykonując następujące czynności:
1. W zasobie usługi Azure Stack Edge przejdź do pozycji udziały > IoT Edge.
2. Na stronie Udziały na pasku poleceń wybierz pozycję + Dodaj udział.
3. W bloku Dodaj udział podaj nazwę udziału i wybierz typ udziału.
4. Aby zainstalować udział edge, zaznacz pole wyboru Użyj udziału w usłudze Edge compute.
5. Wybierz konto Storage, usługę Storage, istniejącego użytkownika, a następnie wybierz pozycję Utwórz.
Po utworzeniu udziału edge otrzymasz powiadomienie o pomyślnym utworzeniu. Lista udziałów jest aktualizowana w celu odzwierciedlenia nowego udziału.
Dodaj udział lokalny usługi Edge na urządzeniu Edge, powtarzając wszystkie kroki opisane w poprzednim kroku i zaznaczając pole wyboru Skonfiguruj jako udział lokalny przeglądarki Edge. Dane w udziale lokalnym pozostają na urządzeniu.
W bloku Udziały zostanie wyświetlona zaktualizowana lista udziałów.
Aby wyświetlić właściwości nowo utworzonego udziału lokalnego, wybierz udział z listy. W polu Lokalny punkt instalacji dla modułów funkcji obliczeniowej Edge skopiuj wartość odpowiadającą temu udziałowi.

Użyjesz tego lokalnego punktu instalacji podczas wdrażania modułu.
Aby wyświetlić właściwości utworzonego udziału edge, wybierz udział z listy. W polu Lokalny punkt instalacji dla modułów funkcji obliczeniowej Edge skopiuj wartość odpowiadającą temu udziałowi.

Użyjesz tego lokalnego punktu instalacji podczas wdrażania modułu.

Dodawanie wyzwalacza

Przejdź do zasobu usługi Azure Stack Edge, a następnie przejdź do pozycji Wyzwalacze IoT Edge>. Wybierz pozycję + Dodaj wyzwalacz.

W bloku Dodaj wyzwalacz wprowadź następujące wartości.

Pole	Wartość
Nazwa wyzwalacza	Unikatowa nazwa wyzwalacza.
Typ wyzwalacza	Wybierz pozycję Wyzwalacz pliku . Wyzwalacz pliku jest uruchamiany za każdym razem, gdy występuje zdarzenie pliku, takie jak zapisanie pliku w udziale wejściowym. Z drugiej strony zaplanowany wyzwalacz jest uruchamiany na podstawie harmonogramu zdefiniowanego przez Ciebie. W tym przykładzie potrzebujemy wyzwalacza pliku.
Udział wejściowy	Wybierz udział wejściowy. Udział lokalny edge jest udziałem wejściowym w tym przypadku. Moduł używany tutaj przenosi pliki z lokalnego udziału usługi Edge do udziału usługi Edge, w którym są przekazywane do chmury.

Add trigger 2

Otrzymasz powiadomienie po utworzeniu wyzwalacza. Lista wyzwalaczy jest aktualizowana w celu wyświetlenia nowo utworzonego wyzwalacza. Wybierz właśnie utworzony wyzwalacz.
Skopiuj i zapisz przykładową trasę. Zmodyfikujesz tę przykładową trasę i użyjesz jej później w IoT Hub.

"sampleroute": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/modulename/inputs/input1\")"

Dodawanie modułu

Na tym urządzeniu edge nie ma modułów niestandardowych. Możesz dodać niestandardowy lub wstępnie utworzony moduł. Aby dowiedzieć się, jak utworzyć moduł niestandardowy, przejdź do artykułu Tworzenie modułu języka C# dla urządzenia usługi Azure Stack Edge Pro FPGA.

W tej sekcji dodasz moduł niestandardowy do urządzenia IoT Edge utworzonego w module Tworzenie języka C# dla usługi Azure Stack Edge Pro FPGA. Ten moduł niestandardowy pobiera pliki z lokalnego udziału usługi Edge na urządzeniu Brzegowym i przenosi je do udziału usługi Edge (chmura) na urządzeniu. Następnie udział chmurowy wypycha pliki na konto magazynu platformy Azure skojarzone z tym udziałem chmurowym.

Przejdź do zasobu usługi Azure Stack Edge, a następnie przejdź do IoT Edge > Przegląd. Na kafelku Moduły wybierz pozycję Przejdź do Azure IoT Hub.

W zasobie IoT Hub przejdź do IoT Edge urządzenia, a następnie wybierz urządzenie IoT Edge.
Na stronie Szczegóły urządzenia wybierz pozycję Ustaw moduły.

W obszarze Dodawanie modułów wykonaj następujące czynności:

Wprowadź nazwę, adres, nazwę użytkownika i hasło dla ustawień rejestru kontenerów dla modułu niestandardowego. Nazwa, adres i wymienione poświadczenia są używane do pobierania modułów za pomocą zgodnego adresu URL. Aby wdrożyć ten moduł, w obszarze Deployment modules (Moduły wdrażania) wybierz opcję IoT Edge module (Moduł usługi IoT Edge). Ten moduł IoT Edge to kontener platformy Docker, który można wdrożyć na urządzeniu IoT Edge skojarzonym z urządzeniem usługi Azure Stack Edge Pro FPGA.

Określ ustawienia dla niestandardowego modułu usługi IoT Edge. Wprowadź następujące wartości.

Pole	Wartość
Nazwa	Unikatowa nazwa modułu. Ten moduł to kontener platformy Docker, który można wdrożyć na urządzeniu IoT Edge skojarzonym z usługą Azure Stack Edge Pro FPGA.
Identyfikator URI obrazu	Identyfikator URI obrazu dla odpowiedniego obrazu kontenera dla modułu.
Wymagane poświadczenia	Jeśli jest zaznaczone, nazwa użytkownika i hasło są używane do pobierania modułów z pasującym adresem URL.

W polu Opcje tworzenia kontenera wprowadź lokalne punkty instalacji dla modułów usługi Edge skopiowanych w poprzednich krokach dla udziału edge i udziału lokalnego przeglądarki Edge.

Ważne

Ścieżki używane w tym miejscu są instalowane w kontenerze, więc muszą być zgodne z oczekiwaniami funkcji w kontenerze. Jeśli obserwujesz tworzenie modułu niestandardowego, kod określony w tym module oczekuje skopiowanych ścieżek. Nie modyfikuj tych ścieżek.

W polu Opcje tworzenia kontenera możesz wkleić poniższy przykład:

{
  "HostConfig": 
  {
   "Binds": 
    [
     "/home/hcsshares/mydbesmbedgelocalshare1:/home/input",
     "/home/hcsshares/mydbesmbedgeshare1:/home/output"
    ]
   }
}

Podaj wszelkie zmienne środowiskowe używane dla modułu. Zmienne środowiskowe zawierają opcjonalne informacje ułatwiające zdefiniowanie środowiska, w którym działa moduł.

The Container Create Options box

Jeśli to konieczne, skonfiguruj zaawansowane ustawienia środowiska uruchomieniowego Edge, a następnie kliknij pozycję Dalej.

W obszarze Określ trasy ustaw trasy między modułami.

Trasę można zamienić na skopiowany wcześniej ciąg trasy. W tym przykładzie podaj nazwę udziału lokalnego, który wypchnie dane do udziału chmurowego. Zastąp element modulename nazwą modułu. Wybierz opcję Dalej.
```
"route": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/filemove/inputs/input1\")"
```
W obszarze Przejrzyj wdrożenie sprawdź wszystkie ustawienia, a następnie wybierz pozycję Prześlij, aby przesłać moduł do wdrożenia.

Ta akcja uruchamia wdrożenie modułu. Po zakończeniu wdrażania stan środowiska uruchomieniowego modułu jest uruchomiony.

Weryfikowanie przekształcania danych, transfer

Ostatnim krokiem jest upewnienie się, że moduł jest połączony i działa zgodnie z oczekiwaniami. Stan środowiska uruchomieniowego modułu powinien pokazywać uruchomienie dla urządzenia usługi IoT Edge w zasobie usługi IoT Hub.

Wykonaj następujące kroki, aby zweryfikować przekształcanie i przesyłanie danych na platformę Azure.

W Eksplorator plików połącz się zarówno z utworzonymi wcześniej udziałami lokalnymi, jak i microsoft Edge.
Dodaj dane do udziału lokalnego.

Dane zostaną przeniesione do udziału chmurowego.

Następnie dane zostaną wypchnięte z udziału chmurowego na konto magazynu. Aby wyświetlić dane, przejdź do konta magazynu, a następnie wybierz pozycję Eksplorator usługi Storage. Przekazane dane można wyświetlić na koncie magazynu.