Konfigurieren von Datenflussendpunkten für lokalen Speicher

Artikel
11/21/2024

Wichtig

Diese Seite enthält Anweisungen zum Verwalten der Komponenten von „Azure IoT Einsatz“ mithilfe von Kubernetes-Bereitstellungsmanifesten. Diese Option befindet sich in der Vorschau. Dieses Feature wird mit einigen Einschränkungen bereitgestellt und sollte nicht für Produktionsworkloads verwendet werden.

Die zusätzlichen Nutzungsbestimmungen für Microsoft Azure-Vorschauen enthalten rechtliche Bedingungen. Sie gelten für diejenigen Azure-Features, die sich in der Beta- oder Vorschauversion befinden oder aber anderweitig noch nicht zur allgemeinen Verfügbarkeit freigegeben sind.

Um Daten an einen lokalen Speicher in Azure IoT Einsatz zu senden, können Sie einen Datenflussendpunkt konfigurieren. Mit dieser Konfiguration können Sie den Endpunkt, die Authentifizierung, die Tabelle und andere Einstellungen angeben.

Voraussetzungen

Eine Instanz von Azure IoT Einsatz
Ein PersistentVolumeClaim (PVC)

Erstellen eines Datenflussendpunkts für lokalen Speicher

Verwenden Sie die Option für den lokalen Speicher, um Daten an ein lokal verfügbares persistentes Volume zu senden, über das Sie Daten per Azure Container Storage hochladen können (ermöglicht durch Edgevolumes mit Azure Arc-Unterstützung).

Wählen Sie auf der Einsatz-Benutzeroberfläche die Registerkarte Dataflowendpunkte aus.
Wählen Sie unter Neuen Dataflowendpunkt erstellen die Option Lokaler Speicher>Neu aus.

Geben Sie die folgenden Einstellungen für den Endpunkt ein:

Einstellung	BESCHREIBUNG
Name	Der Name des Dataflowendpunkts.
Name des persistenten Volumeanspruchs	Der Name des PersistentVolumeClaim (PVC), das als lokaler Speicher verwendet werden soll.

Wählen Sie Übernehmen aus, um den Endpunkt bereitzustellen.

Erstellen Sie eine Bicep-Datei (.bicep) mit folgendem Inhalt:

param aioInstanceName string = '<AIO_INSTANCE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'
param endpointName string = '<ENDPOINT_NAME>'
param persistentVCName string = '<PERSISTENT_VC_NAME>'

resource aioInstance 'Microsoft.IoTOperations/instances@2024-11-01' existing = {
  name: aioInstanceName
}
resource customLocation 'Microsoft.ExtendedLocation/customLocations@2021-08-31-preview' existing = {
  name: customLocationName
}
resource localStorageDataflowEndpoint 'Microsoft.IoTOperations/instances/dataflowEndpoints@2024-11-01' = {
  parent: aioInstance
  name: endpointName
  extendedLocation: {
    name: customLocation.id
    type: 'CustomLocation'
  }
  properties: {
    endpointType: 'LocalStorage'
    localStorageSettings: {
      persistentVolumeClaimRef: persistentVCName
    }
  }
}

Stellen Sie sie dann über die Azure CLI bereit:

az deployment group create --resource-group <RESOURCE_GROUP> --template-file <FILE>.bicep

Erstellen Sie eine Kubernetes-Manifestdatei (.yaml) mit folgendem Inhalt:

apiVersion: connectivity.iotoperations.azure.com/v1
kind: DataflowEndpoint
metadata:
  name: <ENDPOINT_NAME>
  namespace: azure-iot-operations
spec:
  endpointType: LocalStorage
  localStorageSettings:
    persistentVolumeClaimRef: <PVC_NAME>

Wenden Sie dann die Manifestdatei auf den Kubernetes-Cluster an:

kubectl apply -f <FILE>.yaml

Der PersistentVolumeClaim (PVC) muss sich im selben Namespace wie der Datenflussendpunkt (DataflowEndpoint) befinden.

Unterstützte Serialisierungsformate

Das einzige unterstützte Serialisierungsformat ist Parquet.

Verwenden von Azure Container Storage, aktiviert durch Azure Arc (ACSA)

Sie können den lokalen Speicherdatenflussendpunkt zusammen mit Azure Container Storage, aktiviert durch Azure Arc verwenden, um Daten lokal zu speichern oder Daten an ein Cloudziel zu senden.

Lokales freigegebenes Volume

Um in ein lokales freigegebenes Volume zu schreiben, erstellen Sie zuerst ein PersistentVolumeClaim (PVC) gemäß den Anweisungen unter Lokale freigegebene Edgevolumes.

Geben Sie dann beim Konfigurieren Ihres lokalen Speicherdatenflussendpunkts unter persistentVolumeClaimRef den PVC-Namen ein.

Clouderfassung

Um Ihre Daten in die Cloud zu schreiben, befolgen Sie die Anweisungen unter Konfiguration von Edgevolumes für die Clouderfassung, um ein PVC zu erstellen und ein Subvolume für Ihr gewünschtes Cloudziel anzufügen.

Wichtig

Vergessen Sie nicht, das Subvolume nach dem Erstellen des PVC zu erstellen, sonst kann der Dataflow nicht gestartet werden, und die Protokolle zeigen den Fehler „schreibgeschütztes Dateisystem" an.

Geben Sie dann beim Konfigurieren Ihres lokalen Speicherdatenflussendpunkts unter persistentVolumeClaimRef den PVC-Namen ein.

Wenn Sie den Datenfluss erstellen, muss der Parameter Datenziel mit dem Parameter spec.path übereinstimmen, den Sie während der Konfiguration für das Subvolume erstellt haben.

Nächste Schritte

Weitere Informationen zu Datenflüssen finden Sie unter Erstellen eines Datenflusses.

Freigeben über