로컬 스토리지에 대한 데이터 흐름 엔드포인트 구성

아티클
11/20/2024

Important

이 페이지에는 미리 보기 상태인 Kubernetes 배포 매니페스트를 사용하여 Azure IoT Operations 구성 요소를 관리하기 위한 지침이 포함되어 있습니다. 이 기능은 몇 가지 제한 사항을 제공하며 프로덕션 워크로드에 사용하면 안 됩니다.

베타, 미리 보기로 제공되거나 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 약관은 Microsoft Azure 미리 보기에 대한 추가 사용 약관을 참조하세요.

Azure IoT Operations에서 로컬 스토리지로 데이터를 보내려면 데이터 흐름 엔드포인트를 구성할 수 있습니다. 이 구성을 사용하면 엔드포인트, 인증, 테이블 및 기타 설정을 지정할 수 있습니다.

필수 조건

Azure IoT Operations의 인스턴스
PersistentVolumeClaim (PVC)

로컬 스토리지 데이터 흐름 엔드포인트 만들기

로컬 스토리지 옵션을 사용하여 로컬로 사용 가능한 영구 볼륨으로 데이터를 보내면 Azure Arc 에지 볼륨에서 사용하도록 설정된 Azure Container Storage를 통해 데이터를 업로드할 수 있습니다.

작업 환경에서 데이터 흐름 엔드포인트 탭을 선택합니다.
새 데이터 흐름 엔드포인트 만들기에서 로컬 스토리지 새로 만들기>를 선택합니다.

엔드포인트에 대해 다음 설정을 입력합니다.

설정	Description
이름	데이터 흐름 엔드포인트의 이름입니다.
영구 볼륨 클레임 이름	로컬 스토리지에 사용할 PVC(PersistentVolumeClaim)의 이름입니다.

적용을 선택하여 엔드포인트를 프로비전합니다.

다음 콘텐츠를 사용하여 Bicep .bicep 파일을 만듭니다.

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

그런 다음, Azure CLI를 통해 배포합니다.

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

다음 콘텐츠를 사용하여 Kubernetes 매니페스트 .yaml 파일을 만듭니다.

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

그런 다음, 매니페스트 파일을 Kubernetes 클러스터에 적용합니다.

kubectl apply -f <FILE>.yaml

PVC(PersistentVolumeClaim)는 DataflowEndpoint와 동일한 네임스페이스에 있어야 합니다.

지원되는 serialization 형식

지원되는 직렬화 형식은 Parquet뿐입니다.

ACSA(Azure Arc)에서 사용하도록 설정된 Azure Container Storage 사용

로컬 스토리지 데이터 흐름 엔드포인트를 Azure Arc에서 사용하도록 설정된 Azure Container Storage와 함께 사용하여 데이터를 로컬로 저장하거나 클라우드 대상으로 데이터를 보낼 수 있습니다.

로컬 공유 볼륨

로컬 공유 볼륨에 쓰려면 먼저 로컬 공유 에지 볼륨의 지침 에 따라 PVC(PersistentVolumeClaim)를 만듭니다.

그런 다음 로컬 스토리지 데이터 흐름 엔드포인트를 구성할 때 PVC 이름을 입력합니다 persistentVolumeClaimRef.

클라우드 수집

클라우드에 데이터를 쓰려면 Cloud Ingest Edge 볼륨 구성의 지침에 따라 PVC를 만들고 원하는 클라우드 대상에 대한 하위 단계를 연결합니다.

Important

PVC를 만든 후 하위 파일을 만드는 것을 잊지 마세요. 그렇지 않으면 데이터 흐름이 시작되지 않고 로그에 "읽기 전용 파일 시스템" 오류가 표시됩니다.

그런 다음 로컬 스토리지 데이터 흐름 엔드포인트를 구성할 때 PVC 이름을 입력합니다 persistentVolumeClaimRef.

마지막으로 데이터 흐름을 만들 때 데이터 대상 매개 변수는 구성 중에 하위 파일에 대해 만든 매개 변수와 일치 spec.path 해야 합니다.

다음 단계

데이터 흐름에 대한 자세한 내용은 데이터 흐름 만들기를 참조 하세요.

다음을 통해 공유