Självstudie: Transformera data med Azure Stack Edge Pro FPGA för avancerat distributionsflöde

Viktig

Azure Stack Edge Pro FPGA-enheter nådde slutet av livet i februari 2024.

I den här självstudien beskrivs hur du konfigurerar en beräkningsroll för ett avancerat distributionsflöde på din Azure Stack Edge Pro FPGA-enhet. När du har konfigurerat beräkningsrollen kan Azure Stack Edge Pro FPGA transformera data innan de skickas till Azure.

Beräkning kan konfigureras för enkelt eller avancerat distributionsflöde på din enhet.

Kriterier Enkel distribution Avancerad utplacering
Avsedd för IT-administratörer Utvecklare
Typ Använda Azure Stack Edge-tjänsten för att distribuera moduler Använda IoT Hub-tjänsten för att distribuera moduler
Utrullade moduler Singel Kedjade eller flera moduler

Den här proceduren kan ta cirka 20 till 30 minuter att slutföra.

I den här guiden får du lära dig hur man:

  • Konfigurera datorresurser
  • Lägga till aktier
  • Lägga till en utlösare
  • Lägga till en beräkningsmodul
  • Verifiera datatransformering och överföring

Förutsättningar

Innan du konfigurerar en beräkningsroll på din Azure Stack Edge Pro FPGA-enhet kontrollerar du att:

Konfigurera datorresurser

Om du vill konfigurera beräkning på din Azure Stack Edge Pro FPGA skapar du en IoT Hub-resurs.

  1. I Azure-portalen för din Azure Stack Edge-resurs går du till Översikt. I den högra rutan väljer du plattan IoT Edge.

    Kom igång med beräkning

  2. I panelen Aktivera IoT Edge-tjänst väljer du Lägg till. Den här åtgärden aktiverar IoT Edge-tjänsten som gör att du kan distribuera IoT Edge-moduler lokalt på enheten.

    Kom igång med beräkning 2

  3. I Skapa IoT Edge-tjänstanger du följande:

    Fält Värde
    Abonnemang Välj en prenumeration för din IoT Hub-resurs. Du kan välja samma prenumeration som den som används av Azure Stack Edge-resursen.
    Resursgrupp Ange ett namn för resursgruppen för din IoT Hub-resurs. Du kan välja samma resursgrupp som den som används av Azure Stack Edge-resursen.
    IoT Hub Välj mellan Ny eller befintlig.
    Som standard används en standardnivå (S1) för att skapa en IoT-resurs. Om du vill använda en IoT-resurs på den kostnadsfria nivån skapar du en och väljer sedan den befintliga resursen.
    Namn Acceptera standardvärdet eller ange ett namn för din IoT Hub-resurs.

    Kom igång med beräkning 3

  4. Välj Granska + Skapa. Det tar några minuter att skapa IoT Hub-resursen. När IoT Hub-resursen har skapats uppdateras Översikt för att indikera att IoT Edge-tjänsten körs.

    När IoT Edge-tjänsten har konfigurerats på Edge-enheten skapar den två enheter: en IoT-enhet och en IoT Edge-enhet. Båda enheterna kan visas i IoT Hub-resursen. En IoT Edge-körningsmiljö körs också på den här IoT Edge-enheten. I det här läget är endast Linux-plattformen tillgänglig för din IoT Edge-enhet.

    Bekräfta att Edge Compute-rollen har konfigurerats genom att välja IoT Edge-tjänst Egenskaper > och kontrollera IoT-enheten och IoT Edge-enheten.

    Kom igång med beräkning 4

Lägga till aktier

För den avancerade distributionen i den här handledningen behöver du två andelar: en Edge-andel och en lokal Edge-andel.

  1. Lägg till en Edge-resurs på enheten genom att göra följande:

    1. I din Azure Stack Edge-resurs går du till IoT Edge >-delningar.

    2. På sidan Resurser går du till kommandofältet och väljer + Lägg till resurs.

    3. På bladet Lägg till resurs anger du resursnamnet och väljer resurstyp.

    4. Om du vill ansluta Edge-delningsressursen, markerar du kryssrutan för Använd delningsresursen med Edge-beräkning.

    5. Välj Storage-kontot, Storage-tjänsten, en befintlig användare och välj sedan Skapa.

      Lägg till en Edge-resurs

    När Edge-delningen har skapats får du ett meddelande om att den har skapats framgångsrikt. Aktielistan uppdateras för att återspegla den nya aktien.

  2. Lägg till en lokal Edge-resurs på Edge-enheten genom att upprepa alla steg i föregående steg och markera kryssrutan för Konfigurera som lokal Edge-resurs. Data i den lokala delningen stannar kvar på enheten.

    Lägg till en lokal Edge-resurs

  3. På bladet Aktier visas den uppdaterade listan över aktier.

    Uppdaterad lista över resurser

  4. Om du vill visa egenskaperna för den nyligen skapade lokala resursen väljer du resursen i listan. I rutan Lokal monteringspunkt för Edge-beräkningsmoduler, kopiera värdet som motsvarar denna delning.

    Du använder den här lokala monteringspunkten när du distribuerar modulen.

    rutan

  5. Om du vill visa egenskaperna för den Edge-resurs som du skapade väljer du resursen i listan. I rutan Lokal monteringspunkt för Edge-beräkningsmoduler, kopiera värdet som motsvarar denna delning.

    Du använder den här lokala monteringspunkten när du distribuerar modulen.

    Lägg till anpassad modul

Lägga till en utlösare

  1. Gå till din Azure Stack Edge-resurs och gå sedan till IoT Edge > Triggers. Välj + Lägg till utlösare.

    Lägg till utlösare

  2. På bladet Lägg till utlösare anger du följande värden.

    Fält Värde
    Utlösarnamn Ett unikt namn för utlösaren.
    Utlösartyp Välj Fil utlösare. En filutlösare utlöses när en filhändelse inträffar, till exempel när en fil skrivs till indatalagringen. En schemalagd utlösare å andra sidan startar baserat på ett schema som definierats av dig. I det här exemplet behöver vi en filutlösare.
    Indataandel Välj en inmatningsandel. Den lokala Edge-andelen är indataandelen i det här fallet. Modulen som används här flyttar filer från den lokala Edge-resursen till en Edge-resurs där de laddas upp till molnet.

    Lägg till utlösare 2

  3. Du meddelas när utlösaren har skapats. Listan över utlösare uppdateras för att visa den nyligen skapade utlösaren. Välj den utlösare som du nyss skapade.

    Lägg till utlösare 3

  4. Kopiera och spara exempelvägen. Du kommer att ändra den här exempelvägen och använda den senare i IoT Hub.

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

    Lägg till utlösare 4

Lägga till en modul

Det finns inga anpassade moduler på den här Edge-enheten. Du kan lägga till en anpassad eller en fördefinierad modul. Om du vill lära dig hur du skapar en anpassad modul går du till Utveckla en C#-modul för din Azure Stack Edge Pro FPGA-enhet.

I det här avsnittet lägger du till en anpassad modul till den IoT Edge-enhet som du skapade i Utveckla en C#-modul för din Azure Stack Edge Pro FPGA-. Den här anpassade modulen tar filer från en lokal Edge-resurs på Edge-enheten och flyttar dem till en Edge-resurs (moln) på enheten. Molnresursen skickar sedan filerna till azure-lagringskontot som är associerat med molnresursen.

  1. Gå till din Azure Stack Edge-resurs och sedan till IoT Edge > Översiktsbild. På panelen Moduler väljer du Gå till Azure IoT Hub.

    Välj avancerad distribution

  1. I din IoT Hub-resurs går du till IoT Edge-enhet och väljer sedan din IoT Edge-enhet.

    Gå till IoT Edge-enhet i IoT Hub

  2. Enhetsinformationväljer du Ange moduler.

    länken för att ange moduler

  3. Gör följande under Lägg till moduler:

    1. Ange namn, adress, användarnamn och lösenord för containerregisterinställningarna för den anpassade modulen. Namn, adress och angivna autentiseringsuppgifter används för att hämta moduler med en matchande URL. Om du vill distribuera den här modulen under Distributionsmodulerväljer du IoT Edge-modul. Den här IoT Edge-modulen är en dockercontainer som du kan distribuera till den IoT Edge-enhet som är associerad med din Azure Stack Edge Pro FPGA-enhet.

      Inställningssidan för moduler

    2. Ange inställningarna för den anpassade IoT Edge-modulen. Ange följande värden.

      Fält Värde
      Namn Ett unikt namn för modulen. Den här modulen är en dockercontainer som du kan distribuera till den IoT Edge-enhet som är associerad med din Azure Stack Edge Pro FPGA.
      Bild-URI Avbildnings-URI:n för motsvarande containeravbildning för modulen.
      Autentiseringsuppgifter krävs Om det är markerat används användarnamn och lösenord för att hämta moduler med en matchande URL.

      I rutan Container Create Options anger du de lokala monteringspunkterna för de Edge-moduler som du kopierade i föregående steg för Edge-resursen och den lokala Edge-resursen.

      Viktig

      Sökvägarna som används här är monterade i din container, så de måste matcha vad funktionaliteten i din container förväntar sig. Om du följer Skapa en anpassad modul, förväntar sig den kod som specificeras i modulen att du har kopierat sökvägarna. Ändra inte dessa sökvägar.

      I rutan Alternativ för att skapa container kan du klistra in följande exempel:

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

      Ange eventuella miljövariabler som används för din modul. Miljövariabler ger valfri information som hjälper dig att definiera miljön där modulen körs.

      Alternativrutan för att skapa container

    3. Om det behövs konfigurerar du avancerade Edge-körningsinställningar och klickar sedan på Nästa.

      Lägg till anpassad modul 2

  4. Under Ange vägaranger du vägar mellan moduler.

    Ange vägar

    Du kan ersätta väg med följande vägsträng som du kopierade tidigare. I det här exemplet anger du namnet på den lokala resurs som ska skicka data till molnresursen. Ersätt modulename med namnet på modulen. Välj Nästa.

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

    avsnittet Ange vägar

  5. Under Granska distributiongranskar du alla inställningar och väljer sedan Skicka för att skicka modulen för distribution.

    Sidan för moduler 2

    Den här åtgärden startar moduldistributionen. När distributionen är klar är körningsstatus för modulen i gång.

    Lägg till anpassad modul 3

Verifiera datakonvertering och överföring

Det sista steget är att se till att modulen är ansluten och körs som förväntat. Körningsstatusen för modulen bör vara "Running" för din IoT Edge-enhet i IoT Hub-resursen.

Utför följande steg för att verifiera datatransformering och överföring till Azure.

  1. I Utforskaren ansluter du till de Edge-lokala nätverksresurser och Edge-delningar som du skapade tidigare.

    Verifiera datatransformation

  2. Lägg till data i den lokala delningen.

    Verifiera datatransformation 2

    Data flyttas till molndelningen.

    Verifiera dataomvandling 3

    Data skickas sedan från molnresursen till lagringskontot. Om du vill visa data går du till ditt lagringskonto och väljer sedan Storage Explorer. Du kan visa uppladdade data i ditt lagringskonto.

    Verifiera datatransformation 4

Du har slutfört valideringsprocessen.

Nästa steg

I den här handledningen lärde du dig hur man:

  • Konfigurera datorresurser
  • Lägga till aktier
  • Lägga till en utlösare
  • Lägga till en beräkningsmodul
  • Verifiera datatransformering och överföring

Information om hur du administrerar din Azure Stack Edge Pro FPGA-enhet finns i: