Configurer des points de terminaison de flux de données pour le stockage local

Article
11/21/2024

Important

Cette page contient des instructions pour gérer les composants d’Opérations Azure IoT en utilisant des manifestes de déploiement Kubernetes, qui est en préversion. Cette fonctionnalité est fournie avec plusieurs limitations et ne doit pas être utilisée pour les charges de travail de production.

Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou plus généralement non encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.

Pour envoyer des données à un stockage local dans Opérations Azure IoT – vous pouvez configurer un point de terminaison de flux de données. Cette configuration vous permet de spécifier le point de terminaison, l’authentification, la table et d’autres paramètres.

Prérequis

Une instance d’Opérations Azure IoT
Une revendication de volume persistant (PVC)

Créer un point de terminaison de flux de données de stockage local

Utilisez l’option de stockage local pour envoyer des données à un volume persistant disponible localement, par le biais duquel vous pouvez charger des données via le Stockage de conteneurs Azure activé par des volumes de périphérie Azure Arc.

Dans l’expérience des opérations, sélectionnez l’onglet Points de terminaison de flux de données.
Sous Créer un point de terminaison de flux de données, sélectionnez Stockage local>Nouveau.

Entrez les paramètres suivants pour le point de terminaison :

Setting	Description
Nom	Nom du point de terminaison de flux de données.
Nom de la revendication de volume persistant	Nom de la PersistentVolumeClaim (PVC) à utiliser pour le stockage local.

Sélectionnez Appliquer pour approvisionner le point de terminaison.

Créez un fichier Bicep .bicep avec le contenu suivant.

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
    }
  }
}

Effectuez ensuite le déploiement via Azure CLI.

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

Créez un fichier manifeste Kubernetes .yaml avec le contenu suivant.

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

Appliquez ensuite le fichier manifeste au cluster Kubernetes.

kubectl apply -f <FILE>.yaml

La revendication de volume persistant doit se trouver dans le même espace de noms que le Point de terminaison de flux de données.

Formats de sérialisation pris en charge

Le seul format de sérialisation pris en charge est Parquet.

Utiliser Stockage de conteneurs Azure activé par Azure Arc (ACSA)

Vous pouvez utiliser le point de terminaison de flux de données de stockage local avec Stockage de conteneurs Azure activé par Azure Arc pour stocker des données localement ou pour envoyer des données à une destination cloud.

Volume partagé local

Pour écrire dans un volume partagé local, créez d’abord une PersistentVolumeClaim (PVC) conformément aux instructions données dans Volumes Edge partagés locaux.

Ensuite, lors de la configuration de votre point de terminaison de flux de données de stockage local, entrez le nom de la revendication de volume persistant (PVC) sous persistentVolumeClaimRef.

Cloud Ingest

Pour écrire vos données dans le cloud, suivez les instructions données dans Configuration de Cloud Ingest Edge Volumes pour créer une revendication de volume persistant et attacher un sous-volume pour votre destination cloud souhaitée.

Important

N’oubliez pas de créer le sous-volume après avoir créé la revendication de volume persistant, sans quoi le flux de données échoue à démarrer et les journaux indiquent une erreur « Système de fichiers en lecture seule ».

Ensuite, lors de la configuration de votre point de terminaison de flux de données de stockage local, entrez le nom de la revendication de volume persistant (PVC) sous persistentVolumeClaimRef.

Enfin, quand vous créez le flux de données, le paramètre Destination des données doit correspondre au paramètre spec.path que vous avez créé pour votre sous-volume lors de la configuration.

Étapes suivantes

Si vous souhaitez découvrir plus d’informations sur les flux de données, consultez Créer un flux de données.

Partager via