Lernprogramm: Transformieren von Daten mit Azure Stack Edge Pro FPGA für den erweiterten Bereitstellungsfluss

In diesem Lernprogramm wird beschrieben, wie Sie eine Computerrolle für einen fortgeschrittenen Bereitstellungsablauf auf Ihrem Azure Stack Edge Pro FPGA-Gerät konfigurieren. Nachdem Sie die Computerrolle konfiguriert haben, kann Azure Stack Edge Pro FPGA Daten transformieren, bevor diese an Azure gesendet werden.

Compute kann für einfachen oder erweiterten Bereitstellungsfluss auf Ihrem Gerät konfiguriert werden.

Dieses Verfahren kann etwa 20 bis 30 Minuten dauern.

In diesem Lernprogramm erfahren Sie, wie Sie:

Voraussetzungen

Bevor Sie eine Computerolle auf Ihrem Azure Stack Edge Pro FPGA-Gerät einrichten, stellen Sie sicher, dass:

• Sie haben Ihr Azure Stack Edge Pro FPGA-Gerät aktiviert, wie in Connect, einrichten und aktivieren von Azure Stack Edge Pro FPGA beschrieben.

Konfigurieren der Berechnung

Zum Konfigurieren der Rechenleistung auf Ihrem Azure Stack Edge Pro FPGA erstellen Sie eine IoT-Hub-Ressource.

1. Wechseln Sie im Azure-Portal Ihrer Azure Stack Edge-Ressource zu Übersicht. Wählen Sie im rechten Bereich die IoT Edge Kachel aus.

   

2. Wählen Sie auf der Kachel IoT Edge-Dienst die Option Hinzufügenaus. Diese Aktion aktiviert den IoT Edge-Dienst, mit dem Sie IoT Edge-Module lokal auf Ihrem Gerät bereitstellen können.

   

3. Geben Sie im Dienst "IoT Edge erstellen" Folgendes ein:

   Feld	Wert
   Abonnement	Wählen Sie ein Abonnement für Ihre IoT Hub-Ressource aus. Sie können dasselbe Abonnement wie das von der Azure Stack Edge-Ressource verwendete Abonnement auswählen.
   Ressourcengruppe	Geben Sie einen Namen für die Ressourcengruppe für Ihre IoT Hub-Ressource ein. Sie können dieselbe Ressourcengruppe auswählen, die von der Azure Stack Edge-Ressource verwendet wird.
   IoT Hub	Wählen Sie aus Neuen oder Vorhandenenaus. Standardmäßig wird eine Standardebene (S1) verwendet, um eine IoT-Ressource zu erstellen. Um eine freie IoT-Ressource zu verwenden, erstellen Sie eine Ressource, und wählen Sie dann die vorhandene Ressource aus.
   Name	Übernehmen Sie die Standardeinstellung, oder geben Sie einen Namen für Ihre IoT Hub-Ressource ein.

   

4. Wählen Sie Überprüfen und Erstellen aus. Die IoT Hub-Ressourcenerstellung dauert ein paar Minuten. Nachdem die IoT-Hub-Ressource erstellt wurde, wird die Übersicht aktualisiert, um anzuzeigen, dass der IoT-Edge-Dienst läuft.

   Wenn der IoT Edge-Dienst auf dem Edgegerät konfiguriert ist, erstellt er zwei Geräte: ein IoT-Gerät und ein IoT Edge-Gerät. Beide Geräte können in der IoT Hub-Ressource angezeigt werden. Eine IoT Edge-Runtime wird auch auf diesem IoT Edge-Gerät ausgeführt. Zu diesem Zeitpunkt ist nur die Linux-Plattform für Ihr IoT Edge-Gerät verfügbar.

   Um zu bestätigen, dass die Edge-Compute-Rolle konfiguriert wurde, wählen Sie IoT Edge-Dienst > Eigenschaften aus und zeigen Sie das IoT-Gerät und das IoT Edge-Gerät an.

   

Anteile hinzufügen

Für die erweiterte Bereitstellung in diesem Lernprogramm benötigen Sie zwei Freigaben: eine Edge-Freigabe und eine lokale Edge-Freigabe.

1. Fügen Sie eine Edge-Freigabe auf dem Gerät hinzu, indem Sie die folgenden Schritte ausführen:

   1. Wechseln Sie innerhalb Ihrer Azure Stack Edge-Ressource zu den IoT Edge->Freigaben.

   2. Wählen Sie auf der Seite Freigaben auf der Befehlsleiste + Freigabe hinzufügenaus.

   3. Geben Sie im Bereich „Freigabe hinzufügen“ den Freigabenamen ein und wählen Sie den Freigabetyp aus.

   4. Aktivieren Sie zum Einbinden der Edgefreigabe das Kontrollkästchen für Verwenden der Freigabe mit Edge-Compute.

   5. Wählen Sie das Speicherkonto, den Speicherdienst, einen vorhandenen Benutzer und dann "Erstellen" aus.

      

   Nachdem die Edge-Share erstellt wurde, erhalten Sie eine Benachrichtigung über die erfolgreiche Erstellung. Die Freigabeliste wird aktualisiert, um die neue Freigabe anzuzeigen.

2. Fügen Sie eine lokale Edge-Freigabe auf dem Edge-Gerät hinzu, indem Sie alle Schritte des vorherigen Vorgangs wiederholen und das Kontrollkästchen für Als lokale Edge-Freigabe konfigurierenaktivieren. Die Daten in der lokalen Freigabe bleiben auf dem Gerät.

   

3. Auf der Klinge Aktien sehen Sie die aktualisierte Liste der Aktien.

   

4. Um die Eigenschaften der neu erstellten lokalen Freigabe anzuzeigen, wählen Sie die Freigabe aus der Liste aus. Kopieren Sie den Wert, der dieser Freigabe entspricht, im Feld Lokalen Bereitstellungspunkt für Edge-Computemodule.

   Sie verwenden diesen lokalen Bereitstellungspunkt, wenn Sie das Modul bereitstellen.

   

5. Um die Eigenschaften der von Ihnen erstellten Edge-Freigabe anzuzeigen, wählen Sie die Freigabe aus der Liste aus. Kopieren Sie im Feld Lokaler Bereitstellungspunkt für Edge-Computemodule den Wert, der dieser Freigabe entspricht.

   Sie verwenden diesen lokalen Bereitstellungspunkt, wenn Sie das Modul bereitstellen.

   

Hinzufügen eines Triggers

1. Wechseln Sie zu Ihrer Azure Stack Edge-Ressource, und wechseln Sie dann zu IoT Edge > Trigger. Wählen Sie + Trigger hinzufügen.

   

2. Geben Sie im Bereich "Trigger hinzufügen" die folgenden Werte ein.

   Feld	Wert
   Triggername	Ein eindeutiger Name für den Auslöser.
   Triggertyp	Wählen Sie Datei-Trigger aus. Ein Dateiauslöser wird ausgelöst, wenn ein Dateiereignis auftritt, beispielsweise wenn eine Datei in den Eingabeordner geschrieben wird. Ein geplanter Trigger dagegen wird basierend auf einem von Ihnen definierten Zeitplan ausgelöst. In diesem Beispiel benötigen wir einen Dateitrigger.
   Eingabeanteil	Wählen Sie eine Eingabefreigabe aus. Die lokale Edge-Freigabe ist die Eingabefreigabe in diesem Fall. Das hier verwendete Modul verschiebt Dateien von der lokalen Edge-Freigabe zu einer Edge-Freigabe, in die sie in die Cloud hochgeladen werden.

   

3. Sie werden benachrichtigt, nachdem der Trigger erstellt wurde. Die Liste der Trigger wird aktualisiert, um den neu erstellten Trigger anzuzeigen. Wählen Sie den soeben erstellten Auslöser aus.

   

4. Kopieren Sie die Beispielroute, und speichern Sie sie. Sie ändern diese Beispielroute und verwenden sie später im IoT-Hub.

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

   

Hinzufügen eines Moduls

Auf diesem Edgegerät sind keine benutzerdefinierten Module vorhanden. Sie können ein benutzerdefiniertes oder vordefiniertes Modul hinzufügen. Informationen zum Erstellen eines benutzerdefinierten Moduls finden Sie unter "Entwickeln eines C#-Moduls für Ihr Azure Stack Edge Pro FPGA-Gerät".

In diesem Abschnitt fügen Sie dem IoT Edge-Gerät ein benutzerdefiniertes Modul hinzu, das Sie im Entwickeln eines C#-Moduls für Ihr Azure Stack Edge Pro FPGA erstellt haben. Dieses benutzerdefinierte Modul nimmt Dateien aus einer lokalen Edge-Freigabe auf dem Edgegerät und verschiebt sie auf eine Edge-Freigabe (Cloud) auf dem Gerät. Die Cloudfreigabe verschiebt dann die Dateien an das Azure-Speicherkonto, das der Cloudfreigabe zugeordnet ist.

1. Gehen Sie zu Ihrer Azure Stack Edge-Ressource und wechseln Sie dann zu IoT Edge > Übersicht. Wählen Sie auf der Kachel Module die Option Zu Azure IoT Hub gehen.

   

2. Wechseln Sie in Ihrer IoT Hub-Ressource zu IoT Edge-Gerät , und wählen Sie dann Ihr IoT Edge-Gerät aus.

   

3. Wählen Sie auf Gerätedetailsdie Option Module festlegenaus.

   

4. Führen Sie unter Module hinzufügendie folgenden Schritte durch:

   1. Geben Sie den Namen, die Adresse, den Benutzernamen und das Kennwort für die Containerregistrierungseinstellungen für das benutzerdefinierte Modul ein. Der Name, die Adresse und die aufgelisteten Anmeldeinformationen werden verwendet, um Module mit einer übereinstimmenden URL abzurufen. Um dieses Modul bereitzustellen, wählen Sie unter Bereitstellungsmodulendas IoT Edge-Modul aus. Dieses IoT Edge-Modul ist ein Docker-Container, den Sie auf dem IoT Edge-Gerät bereitstellen können, das Ihrem Azure Stack Edge Pro FPGA-Gerät zugeordnet ist.

      

   2. Geben Sie die Einstellungen für das benutzerdefinierte IoT Edge-Modul an. Geben Sie die folgenden Werte ein.

      Feld	Wert
      Name	Ein eindeutiger Name für das Modul. Dieses Modul ist ein Docker-Container, den Sie auf dem IoT Edge-Gerät bereitstellen können, das Ihrem Azure Stack Edge Pro FPGA zugeordnet ist.
      Bild-URL	Der Image-URI für das entsprechende Containerimage für das Modul.
      Anmeldung erforderlich	Wenn aktiviert, werden Benutzername und Kennwort verwendet, um Module mit einer übereinstimmenden URL abzurufen.

      Geben Sie im Feld Containererstellungsoptionen die lokalen Bereitstellungspunkte für die Edge-Module ein, die Sie in den vorherigen Schritten für die Edge-Freigabe und die lokale Edge-Freigabe kopiert haben.

      Wichtig

      Die hier verwendeten Pfade werden in Ihren Container eingebunden, sodass sie mit der erwarteten Funktionalität in Ihrem Container übereinstimmen müssen. Wenn Sie Erstellen Sie ein benutzerdefiniertes Modul folgen, erwartet der in diesem Modul angegebene Code die kopierten Pfade. Ändern Sie diese Pfade nicht.

      Im Feld "Containererstellungsoptionen " können Sie das folgende Beispiel einfügen:

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

      Stellen Sie alle Umgebungsvariablen bereit, die für Ihr Modul verwendet werden. Umgebungsvariablen stellen optionale Informationen zur Definition der Umgebung bereit, in der Ihr Modul ausgeführt wird.

      

   3. Konfigurieren Sie bei Bedarf die erweiterten Edge-Laufzeiteinstellungen, und klicken Sie dann auf "Weiter".

      

5. Legen Sie unter RoutesRouten zwischen Modulen fest.

   

   Sie können die Route durch die folgende Routenzeichenfolge ersetzen, die Sie zuvor kopiert haben. Geben Sie in diesem Beispiel den Namen der lokalen Freigabe ein, die Daten an die Cloudfreigabe überträgt. Ersetzen Sie die modulename durch den Namen des Moduls. Wählen Sie Weiteraus.

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

   

6. Überprüfen Sie unter Bereitstellungalle Einstellungen, und wählen Sie dann Absenden aus, um das Modul für die Bereitstellung zu übermitteln.

   

   Diese Aktion startet die Modulbereitstellung. Nach Abschluss der Bereitstellung ist der Laufzeitstatus des Moduls läuft.

   

Überprüfen der Datentransformation, Übertragung

Der letzte Schritt besteht darin, sicherzustellen, dass das Modul wie erwartet verbunden und ausgeführt wird. Der Laufzeitstatus des Moduls sollte in der IoT Hub-Ressource für Ihr IoT Edge-Gerät laufen.

Führen Sie die folgenden Schritte aus, um die Datentransformation zu überprüfen und an Azure zu übertragen.

1. Stellen Sie im Datei-Explorer eine Verbindung mit den lokalen Edge- und Edge-Freigaben her, die Sie zuvor erstellt haben.

   

2. Fügen Sie der lokalen Freigabe Daten hinzu.

   

   Die Daten werden in den Cloud-Speicher verschoben.

   

   Die Daten werden dann von der Cloud-Speicherfreigabe an das Speicherkonto gesendet. Um die Daten anzuzeigen, wechseln Sie zu Ihrem Speicherkonto, und wählen Sie dann "Speicher-Explorer" aus. Sie können die hochgeladenen Daten in Ihrem Speicherkonto anzeigen.

   

Sie haben den Überprüfungsprozess abgeschlossen.

Nächste Schritte

In diesem Lernprogramm haben Sie folgendes gelernt:

Informationen zum Verwalten Ihres Azure Stack Edge Pro FPGA-Geräts finden Sie unter: