Zelfstudie: Gegevens transformeren met Azure Stack Edge Pro FPGA voor geavanceerde implementatiestroom

Artikel
03/05/2024

Belangrijk

Azure Stack Edge Pro FPGA-apparaten zullen in februari 2024 het einde van de levensduur bereiken. Als u nieuwe implementaties overweegt, raden we u aan Om Azure Stack Edge Pro 2- of Azure Stack Edge Pro GPU-apparaten voor uw workloads te verkennen.

In deze zelfstudie wordt beschreven hoe u een rekenrol configureert voor een geavanceerde implementatiestroom op uw Azure Stack Edge Pro FPGA-apparaat. Nadat u de rekenrol hebt geconfigureerd, kan Azure Stack Edge Pro FPGA gegevens transformeren voordat deze naar Azure worden verzonden.

Compute kan worden geconfigureerd voor een eenvoudige of geavanceerde implementatiestroom op uw apparaat.

Criteria	Eenvoudige implementatie	Geavanceerde implementatie
Bedoeld voor	IT-beheerders	Ontwikkelaars
Type	Azure Stack Edge-service gebruiken voor implementatie van modules	IoT Hub-service gebruiken voor implementatie van modules
Modules geïmplementeerd	Eén	Gekoppelde of meerdere modules

Deze procedure neemt ongeveer 20 tot 30 minuten in beslag.

In deze zelfstudie leert u het volgende:

Rekenproces configureren
Shares toevoegen
Een trigger toevoegen
Een rekenprocesmodule toevoegen
Gegevenstransformatie controleren en gegevens overdragen

Vereisten

Voordat u een rekenrol instelt op uw Azure Stack Edge Pro FPGA-apparaat, moet u ervoor zorgen dat:

U hebt uw Azure Stack Edge Pro FPGA-apparaat geactiveerd, zoals beschreven in Verbinding maken, instellen en activeren van Azure Stack Edge Pro FPGA.

Rekenproces configureren

Als u rekenkracht wilt configureren op uw Azure Stack Edge Pro FPGA, maakt u een IoT Hub-resource.

Ga in Azure Portal van uw Azure Stack Edge-resource naar Overzicht. Selecteer in het rechterdeelvenster de tegel IoT Edge.
Selecteer op de tegel IoT Edge-service inschakelen de optie Toevoegen. Met deze actie wordt IoT Edge-service ingeschakeld waarmee u IoT Edge-modules lokaal op uw apparaat kunt implementeren.

Voer bij IoT Edge-service maken het volgende in:

Veld	Waarde
Abonnement	Selecteer een abonnement voor uw IoT Hub-resource. U kunt hetzelfde abonnement selecteren dat wordt gebruikt door de Azure Stack Edge-resource.
Resourcegroep	Voer een naam in voor de resourcegroep voor uw IoT Hub-resource. U kunt dezelfde resourcegroep selecteren die wordt gebruikt door de Azure Stack Edge-resource.
IoT Hub	Kies uit Nieuwe of Bestaande. Standaard wordt er een standaard-laag (S1) gebruikt voor het maken van een IoT-resource. Als u een IoT-resource in een gratis laag wilt gebruiken, maakt u er een en selecteert u vervolgens de bestaande resource.
Naam	Accepteer de standaardwaarde of voer een naam in voor uw IoT Hub-resource.

Get started with compute 3

Selecteer Controleren + maken. Het maken van de IoT Hub-resource duurt enkele minuten. Nadat de IoT Hub-resource is gemaakt, wordt in het Overzicht aangegeven dat de IoT Edge-service wordt uitgevoerd.

Wanneer de IoT Edge-service wordt geconfigureerd op het Edge-apparaat, worden er twee apparaten gemaakt: een IoT-apparaat en een IoT Edge-apparaat. Beide apparaten kunnen worden weergegeven in de IoT Hub-resource. Er wordt ook een IoT Edge-runtime op dit IoT Edge-apparaat uitgevoerd. Op dit moment is alleen het Linux-platform beschikbaar voor uw IoT Edge-apparaat.

Als u wilt controleren of de Edge-rekenrol is geconfigureerd, selecteert u De eigenschappen van de IoT Edge-service > en bekijkt u het IoT-apparaat en het IoT Edge-apparaat.

Shares toevoegen

Voor de geavanceerde implementatie in deze zelfstudie hebt u twee shares nodig: een Edge-share en een andere lokale Edge-share.

U kunt met de volgende stappen een Edge-share toevoegen aan het apparaat:
1. Ga in uw Azure Stack Edge-resource naar IoT Edge-shares>.
2. In de opdrachtbalk op de pagina Shares selecteert u +Share toevoegen.
3. Geef op de blade Share toevoegen een naam op voor de share en selecteer het sharetype.
4. Als u de Edge-share wilt koppelen, schakelt u het selectievakje voor De share met Edge-rekenproces gebruiken.
5. Selecteer de Storage-account, Storage-service, een bestaande gebruiker en selecteer Maken.
Nadat de Edge-share is gemaakt, ontvangt u de melding dat het maken is voltooid. De lijst met shares wordt bijgewerkt op basis van de nieuwe share.
Voeg een lokale Edge-share op het Edge-apparaat toe door alle stappen in de voorgaande stap te herhalen en het selectievakje in te schakelen voor Configureren als lokale Edge-share. De gegevens op de lokale share blijven op het apparaat.
In het deelvenster Shares ziet u de bijgewerkte lijst met shares.
Als u de eigenschappen van de zojuist gemaakte lokale share wilt bekijken, selecteert u de share in de lijst. Kopieer de waarde voor de share uit het vak Lokaal koppelpunt voor Edge-rekenprocesmodules.

U gebruik dit lokale koppelpunt bij het implementeren van de module.
Als u de eigenschappen wilt weergeven van de Edge-share die u hebt gemaakt, selecteert u de share in de lijst. Kopieer de waarde voor de share uit het vak Lokaal koppelpunt voor Edge-rekenprocesmodules.

U gebruik dit lokale koppelpunt bij het implementeren van de module.

Een trigger toevoegen

Ga naar uw Azure Stack Edge-resource en ga vervolgens naar IoT Edge-triggers>. Selecteer + Trigger toevoegen.

Voer in het deelvenster Trigger toevoegen de volgende waarden in.

Veld	Waarde
Triggernaam	Een unieke naam voor uw trigger.
Triggertype	Selecteer de trigger Bestand. Er wordt een bestandstrigger geactiveerd wanneer zich een bestandsevenement voordoet zoals een bestand dat in de inputshare wordt geschreven. Een geplande trigger wordt echter geactiveerd op basis van een schema dat u instelt. Voor dit voorbeeld hebben we een bestandstrigger nodig.
Invoershare	Selecteer een invoershare. De lokale Edge-share is in dit geval de invoershare. De module die hier wordt gebruikt, verplaatst bestanden van de lokale Edge-share naar een Edge-share waar ze in de cloud worden geüpload.

Add trigger 2

U wordt gewaarschuwd nadat de trigger is gemaakt. De lijst met triggers wordt bijgewerkt zodat de zojuist gemaakte trigger wordt weergegeven. Selecteer de trigger die u zojuist hebt gemaakt.
Kopieer de voorbeeldroute en sla deze op. U gaat deze voorbeeldroute wijzigen en later in de IoT Hub gebruiken.

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

Een module toevoegen

Er zijn geen aangepaste modules aanwezig op dit Edge-apparaat. U kunt een aangepaste of vooraf gemaakte module toevoegen. Als u wilt weten hoe u een aangepaste module maakt, gaat u naar Een C#-module ontwikkelen voor uw Azure Stack Edge Pro FPGA-apparaat.

In deze sectie voegt u een aangepaste module toe aan het IoT Edge-apparaat dat u hebt gemaakt in Een C#-module ontwikkelen voor uw Azure Stack Edge Pro FPGA. Deze aangepaste module neemt bestanden van een lokale Edge-share op het Edge-apparaat en deze verplaatst naar een Edge-(cloud)share op het apparaat. De cloudshare pusht de bestanden vervolgens naar het Azure-opslagaccount dat is gekoppeld aan de cloudshare.

Ga naar uw Azure Stack Edge-resource en ga vervolgens naar IoT Edge-overzicht>. Selecteer Ga naar Azure IoT Hub op de tegel Modules.

Ga in uw IoT Hub-resource naar IoT Edge-apparaat en selecteer uw IoT Edge-apparaat.
Selecteer onder Apparaatdetails de optie Modules instellen.

Doe het volgende in Modules toevoegen:

Geef in de Containerregisterinstellingen waarden op voor Naam, Adres, Gebruikersnaam en Wachtwoord voor de aangepaste module. De naam, het adres en de vermelde referenties worden gebruikt om modules met een overeenkomende URL op te halen. Als u deze module wilt implementeren, selecteert u IoT Edge-module onder Implementatiemodules. Deze IoT Edge-module is een Docker-container die u kunt implementeren op het IoT Edge-apparaat dat is gekoppeld aan uw Azure Stack Edge Pro FPGA-apparaat.

Geef de instellingen voor de aangepaste IoT Edge-module op. Voer de volgende waarden in.

Veld	Weergegeven als
Naam	Een unieke naam voor de module. Deze module is een Docker-container die u kunt implementeren op het IoT Edge-apparaat dat is gekoppeld aan uw Azure Stack Edge Pro FPGA.
URI installatiekopie	De URI installatiekopie voor de bijbehorende containerinstallatiekopie voor de module.
Referenties vereist	Als u dit selectievakje inschakelt, worden gebruikersnaam en wachtwoord gebruikt om modules op te halen met een overeenkomende URL.

Voer in het vak Opties container maken de lokale koppelpunten in voor de Edge-modules die u in de voorgaande stappen hebt gekopieerd voor de Edge-share en lokale Edge-share.

Belangrijk

De hier gebruikte paden worden gekoppeld in uw container en moeten daarom overeenkomen met wat de functionaliteit in uw container verwacht. Als u Een aangepaste module maken volgt, verwacht de in die module opgegeven code de gekopieerde paden. Wijzig deze paden niet.

In het vak Opties Container maken plakt u het volgende voorbeeld:

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

Geef eventuele omgevingsvariabelen op die u voor uw module hebt gebruikt. Omgevingsvariabelen leveren optionele informatie die helpt bij het definiëren van de omgeving waarin uw module wordt uitgevoerd.

The Container Create Options box

Configureer indien nodig de geavanceerde runtime-instellingen voor Edge en klik dan op Volgende.

Onder Routes opgeven kunt u routes tussen modules instellen.

U kunt de route vervangen door de routetekenreeks die u eerder hebt gekopieerd. In dit voorbeeld geeft u de naam op van de lokale share die gegevens naar de cloudshare pusht. Vervang de modulename door de naam van het bestand. Selecteer Volgende.
```
"route": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/filemove/inputs/input1\")"
```
Controleer alle instellingen onder Implementatie controleren. Klik vervolgens op Verzenden om de module te verzenden voor implementatie.

Met deze actie wordt de implementatie van de module gestart. Nadat de implementatie is voltooid, wordt de runtime-status van module uitgevoerd.

Gegevenstransformatie controleren, gegevens overdragen

De laatste stap is controleren of de module is verbonden en wordt uitgevoerd zoals verwacht. De runtimestatus van de module moet 'Wordt uitgevoerd' zijn voor uw IoT Edge-apparaat in de IoT Hub-resource.

Voer de volgende stappen uit om de gegevenstransformatie te controleren en over te dragen naar Azure.

Maak via Verkenner verbinding met zowel de lokale Edge-share als de Edge-shares die u eerder hebt gemaakt.
Voeg gegevens toe aan de lokale share.

De gegevens worden verplaatst naar de cloudshare.

De gegevens worden vervolgens vanuit de cloudshare naar het opslagaccount gepusht. Als u de gegevens wilt bekijken, gaat u naar uw opslagaccount en selecteert u Storage Explorer. U kunt de geüploade gegevens in uw opslagaccount weergeven.