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

Artykuł
02/29/2024

Ważne

Urządzenia FPGA usługi Azure Stack Edge Pro osiągnęły koniec użytkowania w lutym 2024 r.

W tym samouczku opisano sposób konfigurowania roli obliczeniowej dla zaawansowanego przepływu wdrażania na urządzeniu FPGA usługi Azure Stack Edge Pro. 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.

Kryterium	Proste wdrażanie	Wdrażanie zaawansowane
Przeznaczony dla	Administratorzy IT	Deweloperzy
Typ	Wdrażanie modułów przy użyciu usługi Azure Stack Edge	Wdrażanie modułów przy użyciu usługi IoT Hub
Wdrożone moduły	Pojedynczy	Łańcuchowe lub wiele modułów

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

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

Konfigurowanie obliczeń
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:

Urządzenie FPGA usługi Azure Stack Edge Pro zostało aktywowane zgodnie z opisem w temacie Connect, set and activate Azure Stack Edge Pro FPGA (Łączenie, konfigurowanie i aktywowanie fpGA usługi Azure Stack Edge Pro).

Konfigurowanie obliczeń

Aby skonfigurować zasoby obliczeniowe w fpGA usługi Azure Stack Edge Pro, utworzysz zasób usługi IoT Hub.

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

W usłudze Create IoT Edge wprowadź następujące dane:

Pole	Wartość
Subskrypcja	Wybierz subskrypcję zasobu usługi 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 usługi 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.
Nazwisko	Zaakceptuj wartość domyślną lub wprowadź nazwę zasobu usługi IoT Hub.

Wprowadzenie do obliczeń 3

Wybierz pozycję Przejrzyj i utwórz. Tworzenie zasobów usługi IoT Hub trwa kilka minut. Po utworzeniu zasobu usługi IoT Hub aktualizacje przeglądu wskazują, że usługa IoT Edge jest uruchomiona.

Po skonfigurowaniu usługi IoT Edge na urządzeniu Brzegowym tworzone są dwa urządzenia: urządzenie IoT i urządzenie usługi IoT Edge. Oba urządzenia można wyświetlić w zasobie usługi IoT Hub. Środowisko uruchomieniowe usługi IoT Edge jest również uruchomione na tym urządzeniu usługi IoT Edge. W chwili obecnej dla urządzenia IoT Edge jest dostępna tylko platforma Linux.

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

Dodawanie udziałów

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

Dodaj udział edge na urządzeniu, wykonując następujące czynności:
1. W zasobie usługi Azure Stack Edge przejdź do pozycji Udziały usługi IoT Edge>.
2. Na stronie Udziały na pasku poleceń wybierz pozycję + Dodaj udział.
3. W bloku Dodawanie udziału podaj nazwę udziału i wybierz typ udziału.
4. Aby zainstalować udział edge, zaznacz pole wyboru Użyj udziału z usługą Obliczeniową Edge.
5. Wybierz konto magazynu, usługę Magazynu, istniejącego użytkownika, a następnie wybierz pozycję Utwórz.
Po utworzeniu udziału usługi 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 usługi 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 usługi 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 Użytkownika. W tym przykładzie potrzebujemy wyzwalacza pliku.
Udział wejściowy	Wybierz udział wejściowy. Udział lokalny usługi Edge jest udziałem wejściowym w tym przypadku. Moduł używany tutaj przenosi pliki z udziału lokalnego usługi Edge do udziału usługi Edge, w którym są przekazywane do chmury.

Dodaj wyzwalacz 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 usłudze IoT Hub.

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

Dodaj moduł

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

W tej sekcji dodasz moduł niestandardowy do urządzenia usługi IoT Edge utworzonego w module Develop a C# for your Azure Stack Edge Pro FPGA (Tworzenie modułu języka C# dla urządzenia FPGA usługi Azure Stack Edge Pro). Ten moduł niestandardowy pobiera pliki z udziału lokalnego usługi Edge na urządzeniu Edge i przenosi je do udziału usługi Edge (w chmurze) 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 pozycji Omówienie usługi IoT Edge>. Na kafelku Moduły wybierz pozycję Przejdź do usługi Azure IoT Hub.

W zasobie usługi IoT Hub przejdź do pozycji Urządzenie usługi IoT Edge, a następnie wybierz urządzenie usługi 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ł usługi IoT Edge to kontener platformy Docker, który można wdrożyć na urządzeniu usługi IoT Edge skojarzonym z urządzeniem FPGA usługi Azure Stack Edge Pro.

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

Pole	Wartość
Nazwisko	Unikatowa nazwa modułu. Ten moduł to kontener platformy Docker, który można wdrożyć na urządzeniu usługi IoT Edge skojarzonym z układem FPGA usługi Azure Stack Edge Pro.
Identyfikator URI obrazu	Identyfikator URI obrazu dla odpowiedniego obrazu kontenera dla modułu.
Wymagane poświadczenia	Jeśli to pole wyboru, 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 usługi 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 należy modyfikować 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 definiowanie środowiska, w którym działa moduł.

Pole Opcje tworzenia kontenera

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

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

Możesz zastąpić trasę następującym ciągiem trasy skopiowanymi wcześniej. 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 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 powoduje uruchomienie wdrożenia modułu. Po zakończeniu wdrażania stan środowiska uruchomieniowego modułu jest uruchomiony.

Weryfikowanie przekształcania danych, transferu

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.