중요합니다
이 페이지에는 미리 보기 상태인 Kubernetes 배포 매니페스트를 사용하여 Azure IoT Operations 구성 요소를 관리하기 위한 지침이 포함되어 있습니다. 이 기능은 몇 가지 제한 사항을 제공하며 프로덕션 워크로드에 사용하면 안 됩니다.
베타, 미리 보기 또는 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 법적 용어는 Microsoft Azure 미리 보기에 대한 추가 사용 약관 을 참조하세요.
Azure IoT Operations에서 로컬 스토리지로 데이터를 보내려면 데이터 흐름 엔드포인트를 구성할 수 있습니다. 이 구성을 사용하면 엔드포인트, 인증, 테이블 및 기타 설정을 지정할 수 있습니다.
필수 조건
로컬 스토리지 데이터 흐름 엔드포인트 만들기
로컬 스토리지 옵션을 사용하여 로컬로 사용 가능한 영구 볼륨으로 데이터를 보내면 Azure Arc 에지 볼륨에서 사용하도록 설정된 Azure Container Storage를 통해 데이터를 업로드할 수 있습니다.
작업 환경에서 데이터 흐름 엔드포인트 탭을 선택합니다.
새 데이터 흐름 엔드포인트 만들기에서 로컬 스토리지 새로 만들기>를 선택합니다.
엔드포인트에 대해 다음 설정을 입력합니다.
설정 |
설명 |
이름 |
데이터 흐름 엔드포인트의 이름입니다. |
영구 볼륨 클레임 이름 |
로컬 스토리지에 사용할 PVC(PersistentVolumeClaim)의 이름입니다. |
적용을 선택하여 엔드포인트를 프로비전합니다.
만들기 또는 바꾸기
az iot ops 데이터 흐름 엔드포인트 create fabric-onelake 명령을 사용하여 로컬 스토리지 데이터 흐름 엔드포인트를 만들거나 바꿉니다.
az iot ops dataflow endpoint create local-storage --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --pvc-ref <PersistentVolumeClaimName>
--pvc-ref
매개 변수는 로컬 스토리지에 사용할 PVC(PersistentVolumeClaim)의 이름입니다. PVC는 데이터 흐름 엔드포인트와 동일한 네임스페이스에 있어야 합니다.
다음은 이름이 지정된 로컬 스토리지 데이터 흐름 엔드포인트를 만들거나 바꾸는 예제 명령입니다 local-storage-endpoint
.
az iot ops dataflow endpoint create local-storage --resource-group myResourceGroup --instance myAioInstance --name local-storage-endpoint --pvc-ref mypvc
만들기 또는 변경
az iot ops 데이터 흐름 엔드포인트 적용 명령을 사용하여 로컬 스토리지 데이터 흐름 엔드포인트를 만들거나 변경합니다.
az iot ops dataflow endpoint apply --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <EndpointName> --config-file <ConfigFilePathAndName>
--config-file
매개 변수는 리소스 속성을 포함하는 JSON 구성 파일의 경로 및 파일 이름입니다.
이 예제에서는 사용자의 홈 디렉터리에 저장된 다음 콘텐츠로 명명 local-storage-endpoint.json
된 구성 파일을 가정합니다.
{
"endpointType": "LocalStorage",
"localStorageSettings": {
"persistentVolumeClaimRef": "<PersistentVolumeClaimName>"
}
}
다음은 다음과 같은 이름의 새 로컬 스토리지 데이터 흐름 엔드포인트를 만드는 예제 명령입니다 local-storage-endpoint
.
az iot ops dataflow endpoint apply --resource-group myResourceGroupName --instance myAioInstanceName --name local-storage-endpoint --config-file ~/local-storage-endpoint.json
다음 콘텐츠를 사용하여 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와 동일한 네임스페이스에 있어야 합니다.
지원되는 직렬화 형식은 Parquet뿐입니다.
ACSA(Azure Arc)에서 사용하도록 설정된 Azure Container Storage 사용
로컬 스토리지 데이터 흐름 엔드포인트를 Azure Arc에서 사용하도록 설정된 Azure Container Storage 와 함께 사용하여 데이터를 로컬로 저장하거나 클라우드 대상으로 데이터를 보낼 수 있습니다.
로컬 공유 볼륨
로컬 공유 볼륨에 쓰려면 먼저 로컬 공유 에지 볼륨의 지침에 따라 PVC(PersistentVolumeClaim)를 만듭니다.
그런 다음 로컬 스토리지 데이터 흐름 엔드포인트를 구성할 때 아래에 persistentVolumeClaimRef
PVC 이름을 입력합니다.
클라우드 수집
클라우드로 데이터를 전송하려면 Cloud Ingest Edge 볼륨 구성 의 지침에 따라 PVC를 만들고 클라우드 목적지에 대한 하위 볼륨을 연결합니다.
중요합니다
PVC를 만든 후 하위 항목을 만드는 것을 잊지 마세요. 그렇지 않으면 데이터 흐름이 시작되지 않고 로그에 "읽기 전용 파일 시스템" 오류가 표시됩니다.
그런 다음 로컬 스토리지 데이터 흐름 엔드포인트를 구성할 때 아래에 persistentVolumeClaimRef
PVC 이름을 입력합니다.
마지막으로 데이터 흐름을 만들 때 데이터 대상 매개 변수는 구성 중에 하위 요소에 대해 만든 매개 변수와 일치 spec.path
해야 합니다.
다음 단계
데이터 흐름에 대한 자세한 내용은 데이터 흐름 만들기를 참조하세요.