Configurare gli endpoint del flusso di dati per l'archiviazione locale

Articolo
11/20/2024

Importante

Questa pagina include istruzioni per la gestione dei componenti di Operazioni IoT di Azure usando i manifesti di distribuzione kubernetes, disponibile in anteprima. Questa funzionalità viene fornita con diverse limitazioni e non deve essere usata per i carichi di lavoro di produzione.

Vedere le condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure per termini legali aggiuntivi che si applicano a funzionalità di Azure in versione beta, in anteprima o in altro modo non ancora disponibili a livello generale.

Per inviare dati all'archiviazione locale in Operazioni IoT di Azure, è possibile configurare un endpoint del flusso di dati. Questa configurazione consente di specificare l'endpoint, l'autenticazione, la tabella e altre impostazioni.

Prerequisiti

Istanza delle operazioni di Azure IoT
A PersistentVolumeClaim (PVC)

Creare un endpoint del flusso di dati di archiviazione locale

Usare l'opzione di archiviazione locale per inviare dati a un volume permanente disponibile in locale, tramite cui è possibile caricare i dati tramite Archiviazione contenitori di Azure abilitata dai volumi perimetrali di Azure Arc.

Nell'esperienza operativa selezionare la scheda Endpoint flusso di dati .
In Crea nuovo endpoint del flusso di dati selezionare Archiviazione> locale Nuovo.

Immettere le impostazioni seguenti per l'endpoint:

Impostazione	Description
Name	Nome dell'endpoint del flusso di dati.
Nome attestazione volume persistente	Nome dell'oggetto PersistentVolumeClaim (PVC) da utilizzare per l'archiviazione locale.

Selezionare Applica per effettuare il provisioning dell'endpoint.

Creare un file Bicep .bicep con il contenuto seguente.

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

Distribuire quindi tramite l'interfaccia della riga di comando di Azure.

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

Creare un file manifesto .yaml Kubernetes con il contenuto seguente.

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

Applicare quindi il file manifesto al cluster Kubernetes.

kubectl apply -f <FILE>.yaml

PersistentVolumeClaim (PVC) deve trovarsi nello stesso spazio dei nomi di DataflowEndpoint.

Formati di serializzazione supportati

L'unico formato di serializzazione supportato è Parquet.

Usare Archiviazione azure Container abilitata da Azure Arc (ACSA)

È possibile usare l'endpoint del flusso di dati di archiviazione locale insieme all'archiviazione di Azure Container abilitata da Azure Arc per archiviare i dati in locale o inviare dati a una destinazione cloud.

Volume condiviso locale

Per scrivere in un volume condiviso locale, creare prima di tutto un oggetto PersistentVolumeClaim (PVC) in base alle istruzioni fornite dai volumi locali di Edge condiviso.

Quindi, quando si configura l'endpoint del flusso di dati di archiviazione locale, immettere il nome del PVC in persistentVolumeClaimRef.

Inserimento nel cloud

Per scrivere i dati nel cloud, seguire le istruzioni riportate in Configurazione Cloud Ingest Edge Volumes (Volumi perimetrali di inserimento cloud) per creare un PVC e allegare una sottovolume per la destinazione cloud desiderata.

Importante

Non dimenticare di creare la sottovolume dopo la creazione del PVC oppure l'avvio del flusso di dati non riesce e i log mostrano un errore "file system di sola lettura".

Quindi, quando si configura l'endpoint del flusso di dati di archiviazione locale, immettere il nome del PVC in persistentVolumeClaimRef.

Infine, quando si crea il flusso di dati, il parametro di destinazione dati deve corrispondere al spec.path parametro creato per la sottovolume durante la configurazione.

Passaggi successivi

Per altre informazioni sui flussi di dati, vedere Creare un flusso di dati.

Condividi tramite