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

Artikel
03/05/2024

Viktigt!

Azure Stack Edge Pro FPGA-enheter når livets slut i februari 2024. Om du överväger nya distributioner rekommenderar vi att du utforskar Azure Stack Edge Pro 2 - eller Azure Stack Edge Pro GPU-enheter för dina arbetsbelastningar.

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å enheten.

Villkor	Enkel distribution	Avancerad distribution
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
Distribuerade moduler	Enstaka	Länkade eller flera moduler

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

I den här självstudien lär du dig att:

Konfigurera beräkning
Lägga till resurser
Lägg till 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:

Du har aktiverat din Azure Stack Edge Pro FPGA-enhet enligt beskrivningen i Anslut, konfigurera och aktivera Azure Stack Edge Pro FPGA.

Konfigurera beräkning

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

Gå till Översikt i Azure-portalen för din Azure Stack Edge-resurs. I den högra rutan väljer du panelen IoT Edge .
På 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.

I tjänsten Skapa IoT Edge anger du följande:

Fält	Värde
Prenumeration	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 från Ny eller Befintlig. Som standard används nivån Standard (S1) till att skapa en IoT-resurs. Om du vill använda en IoT-resurs på kostnadsfri nivå skapar du en sådan och väljer sedan den befintliga resursen.
Name	Acceptera standardvärdet eller ange ett namn för din IoT Hub-resurs.

Get started with compute 3

Välj Granska + skapa. Det tar några minuter att skapa IoT Hub-resursen. När IoT Hub-resursen har skapats uppdateras översikten 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ägge enheter kan visas i IoT Hub-resursen. En IoT Edge-körning körs också på den här IoT Edge-enheten. För tillfället är det bara Linux-plattformen tillgänglig för din IoT Edge-enhet.

Bekräfta att Edge-beräkningsrollen har konfigurerats genom att välja IoT Edge-tjänstegenskaper > och visa IoT-enheten och IoT Edge-enheten.

Lägga till resurser

För den avancerade distributionen i den här självstudien behöver du två resurser: en Edge-resurs och en annan lokal Edge-resurs.

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-resurser>.
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 montera Edge-resursen markerar du kryssrutan för Använd resursen med Edge-beräkning.
5. Välj Lagringskonto, Lagringstjänst, en befintlig användare och välj sedan Skapa.
När Edge-resursen har skapats får du ett meddelande om att det har skapats. Resurslistan uppdateras för att återspegla den nya resursen.
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 resursen finns kvar på enheten.
På bladet Resurser visas den uppdaterade listan över resurser.
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 kopierar du det värde som motsvarar den här resursen.

Du använder den här lokala monteringspunkten när du distribuerar modulen.
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 kopierar du det värde som motsvarar den här resursen.

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

Lägg till utlösare

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

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 Filutlösare . En filutlösare utlöses när en filhändelse inträffar, till exempel att en fil skrivs till den angivna resursen. 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.
Indataresurs	Välj en indataresurs. Den lokala Edge-resursen är indataresursen 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.

Add trigger 2

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.
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 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 pushar sedan filerna till det Azure-lagringskonto som är associerat med molnresursen.

Gå till din Azure Stack Edge-resurs och gå sedan till IoT Edge-översikt>. På panelen Moduler väljer du Gå till Azure IoT Hub.

I din IoT Hub-resurs går du till IoT Edge-enheten och väljer sedan din IoT Edge-enhet.
I Enhetsinformation väljer du Ange moduler.

Under Lägg till moduler utför du följande:

Ange namn, adress, användarnamn och lösenord för containerregisterinställningarna för den anpassade modulen. Namn, adress och de listade autentiseringsuppgifterna används för att hämta moduler med en matchande URL. Distribuera den här modulen genom att under Distributionsmoduler välja 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.

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

Fält	Värde
Name	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.
URI för avbildning	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 Alternativ för att skapa container anger du de lokala monteringspunkterna för Edge-modulerna som du kopierade i föregående steg för edge-resursen och den lokala Edge-resursen.

Viktigt!

Sökvägarna som används här är monterade i containern, så de måste matcha vad funktionerna i containern förväntar sig. Om du följer Skapa en anpassad modul förväntar sig koden som anges i modulen de kopierade sökvägarna. Ändra inte dessa sökvägar.

I rutan Alternativ för containerskapande så 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.

The Container Create Options box

Konfigurera vid behov avancerade Edge-körningsinställningar och klicka sedan på Nästa.

Under Ange vägar anger du vägar mellan moduler.

Du kan ersätta vägen med följande vägsträng som du kopierade tidigare. I det här exemplet anger du namnet på den lokala resurs som skickar data till molnresursen. modulename Ersätt med namnet på modulen. Välj Nästa.
```
"route": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/filemove/inputs/input1\")"
```
Under Granska distributionen så granskar du alla inställningarna. Om du är nöjd så skickar du modulen för distribution.

Den här åtgärden startar moduldistributionen. När distributionen är klar körs körningsstatusen för modulen.

Verifiera datatransformering, överföring

Det slutliga steget är att se till att modulen är ansluten och körs som förväntat. Körningsstatusen för modulen bör vara aktiv 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.

I Utforskaren ansluter du till både de lokala Edge- och Edge-resurser som du skapade tidigare.
Lägg till data i den lokala resursen.

Data flyttas till molnresursen.

Data pushas 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.