Samouczek: przekształcanie danych za pomocą Azure Stack Edge Pro FPGA w celu zaawansowanego przepływu wdrażania

W tym samouczku opisano sposób konfigurowania roli obliczeniowej dla zaawansowanego przepływu wdrażania na Azure Stack Edge Pro FPGA. Po skonfigurowaniu roli obliczeniowej układ FPGA może Azure Stack Edge Pro dane przed wysłaniem ich na platformę Azure.

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

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

Ta procedura 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 układu FPGA Azure Stack Edge Pro zgodnie z opisem w tece Łączenie, konfigurowanie i aktywowanie Azure Stack Edge Pro FPGA.

Konfigurowanie zasobów obliczeniowych

Aby skonfigurować obliczenia na Azure Stack Edge Pro FPGA, utworzysz zasób IoT Hub zasobów.

  1. W Azure Portal zasobu Azure Stack Edge przejdź do tematu Przegląd. W okienku po prawej stronie wybierz kafelek IoT Edge aplikacji.

    Wprowadzenie do obliczeń

  2. Na kafelku Włącz IoT Edge usługi wybierz pozycję Dodaj. Ta akcja umożliwia IoT Edge, która umożliwia wdrażanie IoT Edge modułów lokalnie na urządzeniu.

    Wprowadzenie do obliczeń 2

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

    Pole Wartość
    Subskrypcja Wybierz subskrypcję dla zasobu IoT Hub zasobów. Możesz wybrać tę samą subskrypcję, która jest używana przez Azure Stack Edge zasobów.
    Grupa zasobów Wprowadź nazwę grupy zasobów dla zasobu IoT Hub zasobów. Możesz wybrać tę samą grupę zasobów, która jest używana przez Azure Stack Edge zasobów.
    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 zasobów.

    Wprowadzenie do obliczeń 3

  4. Wybierz pozycję Przejrzyj i utwórz. Tworzenie IoT Hub zasobów trwa kilka minut. Po utworzeniu IoT Hub zasobów usługi zostanie ona aktualizowana, aby wskazać, że IoT Edge jest uruchomiona.

    Po IoT Edge usługi Edge tworzy ona dwa urządzenia: urządzenie IoT i IoT Edge urządzenia. Oba urządzenia można wyświetlić w zasobie usługi IoT Hub. Na IoT Edge uruchomieniowym jest również uruchomione IoT Edge uruchomieniowe. 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ę IoT Edge service > Properties (Właściwości usługi >), a następnie wyświetl urządzenie IoT i IoT Edge urządzenie.

    Wprowadzenie do obliczeń 4

Dodawanie udziałów

Do wdrożenia zaawansowanego w tym samouczku potrzebne będą dwa udziały: jeden udział usługi Edge i drugi lokalny udział edge.

  1. Dodaj udział usługi Edge na urządzeniu, wykonując następujące czynności:

    1. W zasobie Azure Stack Edge przejdź do IoT Edge > Udziały.

    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ł usługi Edge, zaznacz pole wyboru Użyj udziału z obliczeniami usługi Edge.

    5. Wybierz konto magazynu, usługę magazynu, istniejącego użytkownika, a następnie wybierz pozycję Utwórz.

      Dodawanie udziału usługi Edge

    Po utworzeniu udziału usługi Edge otrzymasz powiadomienie o pomyślnym utworzeniu. Lista udziałów zostanie zaktualizowana w celu odzwierciedlenia nowego udziału.

  2. Dodaj udział lokalny usługi Edge na urządzeniu Edge, powtarzając wszystkie kroki w poprzednim kroku i zaznaczając pole wyboru Skonfiguruj jako lokalny udział edge. Dane w lokalnym udziału pozostają na urządzeniu.

    Dodawanie udziału lokalnego usługi Edge

  3. W bloku Udziały zostanie wyświetlona zaktualizowana lista udziałów.

    Zaktualizowana lista udziałów

  4. 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.

    Pole „Lokalny punkt instalacji dla modułów funkcji obliczeniowej Edge”

  5. Aby wyświetlić właściwości utworzonego udziału usługi 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 modułu niestandardowego

Dodawanie wyzwalacza

  1. Przejdź do zasobu Azure Stack Edge a następnie przejdź do IoT Edge > Wyzwalacze. Wybierz pozycję + Dodaj wyzwalacz.

    Dodawanie wyzwalacza

  2. W bloku Dodawanie wyzwalacza 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 kolei zaplanowany wyzwalacz jest wyzwalany zgodnie z harmonogramem zdefiniowanym przez Ciebie. W tym przykładzie potrzebny jest wyzwalacz pliku.
    Udział wejściowy Wybierz udział wejściowy. W tym przypadku udział lokalny usługi Edge jest udziałem wejściowym. Użyty tutaj moduł przenosi pliki z lokalnego udziału usługi Edge do udziału usługi Edge, do którego są one przekazywane do chmury.

    Dodawanie wyzwalacza 2

  3. Po utworzeniu wyzwalacza zostaniesz powiadomiony. Lista wyzwalaczy zostanie zaktualizowana w celu wyświetlenia nowo utworzonego wyzwalacza. Wybierz właśnie utworzony wyzwalacz.

    Dodawanie wyzwalacza 3

  4. Skopiuj i zapisz przykładową trasę. Zmodyfikujesz tę przykładową trasę i użyjesz jej w dalszej części IoT Hub.

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

    Dodawanie wyzwalacza 4

Dodawanie modułu

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

W tej sekcji dodasz moduł niestandardowy do urządzenia IoT Edge utworzonego w sekcji Tworzenie modułu C# dla układu Azure Stack Edge Pro FPGA. 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.

  1. Przejdź do zasobu Azure Stack Edge a następnie przejdź do IoT Edge > Omówienie. Na kafelku Moduły wybierz pozycję Przejdź do Azure IoT Hub.

    Wybieranie wdrożenia zaawansowanego

  1. W zasobie IoT Hub przejdź do IoT Edge, a następnie wybierz IoT Edge urządzenie.

    Przejdź do IoT Edge urządzenia w IoT Hub

  2. Na stronie Szczegóły urządzenia wybierz pozycję Ustaw moduły.

    Link Ustawianie modułów

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

    1. 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 IoT Edge to kontener platformy Docker, który można wdrożyć na urządzeniu IoT Edge skojarzonym z urządzeniem Azure Stack Edge Pro FPGA.

      Strona Ustawianie modułów

    2. 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 układem AZURE STACK EDGE PRO FPGA.
      Image URI Obraz URI odpowiedniego obrazu kontenera dla modułu.
      Wymagane poświadczenia Jeśli to pole jest zaznaczone, nazwa użytkownika i hasło są używane do pobierania modułów z pasującymi adresami URL.

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

      Ważne

      Używane w tym miejscu ścieżki są instalowane w kontenerze, więc muszą być zgodne z oczekiwaniami funkcji w kontenerze. Jeśli tworzysz modułniestandardowy, 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 wszystkie zmienne środowiskowe używane w module. Zmienne środowiskowe zawierają opcjonalne informacje, które pomagają zdefiniować środowisko, w którym jest uruchamiany moduł.

      Pole Opcje tworzenia kontenera

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

      Dodawanie modułu niestandardowego 2

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

    Określanie tras

    Trasę można zastąpić skopiowanym wcześniej ciągiem trasy. W tym przykładzie podaj nazwę udziału lokalnego, który wypchnie dane do udziału chmurowego. Zastąp modulename część nazwą modułu. Wybierz opcję Dalej.

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

    Sekcja Określanie tras

  5. W obszarze Przejrzyj wdrożenie sprawdź wszystkie ustawienia, a następnie wybierz pozycję Prześlij, aby przesłać moduł do wdrożenia.

    Strona 2 zestawu modułów

    Ta akcja rozpoczyna wdrażanie modułu. Po zakończeniu wdrażania stan środowiska uruchomieniowego modułu będzie działać.

    Dodawanie modułu niestandardowego 3

Weryfikowanie transformacji i transferu danych

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.

Aby zweryfikować przekształcanie i przesyłanie danych na platformę Azure, należy wykonać poniższe czynności.

  1. W Eksplorator plików nawiązać połączenie z utworzonymi wcześniej udziałami lokalnymi i edge.

    Weryfikowanie przekształcania danych

  2. Dodaj dane do udziału lokalnego.

    Weryfikowanie przekształcenia danych 2

    Dane zostaną przeniesione do udziału chmurowego.

    Weryfikowanie przekształcenia danych 3

    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.

    Weryfikowanie przekształcenia danych 4

Ukończono proces walidacji.

Następne kroki

W niniejszym samouczku zawarto 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

Aby dowiedzieć się, jak administrować urządzeniem Azure Stack Edge Pro FPGA, zobacz: