Azure IoT Operations 인스턴스의 수명 주기 관리

Azure CLI 및 Azure Portal을 사용하여 Azure IoT Operations 인스턴스를 관리, 제거 또는 업데이트합니다.

필수 조건

• 클러스터에 배포된 Azure IoT Operations 인스턴스입니다. 자세한 내용은 Azure IoT 작업 배포를 참조하세요.

• 개발 컴퓨터에 설치된 Azure CLI입니다. 이 시나리오에는 Azure CLI 버전 2.53.0 이상이 필요합니다. az --version을 사용하여 버전을 확인하고 필요한 경우 az upgrade를 사용하여 업데이트합니다. 자세한 내용은 Azure CLI를 설치하는 방법을 참조하세요.

• Azure CLI용 Azure IoT 작업 확장입니다. 다음 명령을 사용하여 확장 프로그램을 추가하거나 최신 버전으로 업데이트합니다.

  az extension add --upgrade --name azure-iot-ops
  

관리

배포 후 Azure CLI 및 Azure Portal을 사용하여 Azure IoT 작업 인스턴스를 보고 관리할 수 있습니다.

인스턴스 나열

az iot ops list

az iot ops list --resource-group <RESOURCE_GROUP>

인스턴스 보기

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --tree

MyCluster
├── extensions
│   ├── akvsecretsprovider
│   ├── azure-iot-operations-ltwgs
│   └── azure-iot-operations-platform-ltwgs
└── customLocations
    └── MyCluster-cl
        ├── resourceSyncRules
        └── resources
            ├── MyCluster-ops-init-instance
            └── MyCluster-observability

Azure 장치 레지스트리 보기

Azure Portal에서 Azure IoT 작업 인스턴스에 연결된 모든 디바이스 및 자산의 컬렉션인 Azure 장치 레지스트리를 볼 수 있습니다.

Azure Device Registry는 네임스페이스를 사용하여 자산 및 디바이스를 구성합니다. 각 Azure IoT Operations 인스턴스는 자산 및 디바이스에 단일 네임스페이스를 사용합니다. 여러 인스턴스가 단일 네임스페이스를 공유할 수 있습니다.

Azure Portal의 Azure 장치 레지스트리에서 항목을 보려면 다음을 수행합니다.

1. Azure Portal에서 Azure 장치 레지스트리를 검색하고 선택합니다. 개요 페이지에는 구독의 자산, 스키마 레지스트리 및 네임스페이스 수가 요약되어 있습니다.

   

2. 자산 페이지를 사용하여 Azure 장치 레지스트리의 자산을 볼 수 있습니다. 기본적으로 자산 페이지에는 구독의 모든 네임스페이스에 있는 자산이 표시됩니다. 필터를 사용하여 특정 네임스페이스 또는 리소스 그룹의 자산과 같은 자산의 하위 집합을 볼 수 있습니다.

   

3. 스키마 레지스트리 페이지를 사용하여 Azure 장치 레지스트리의 스키마 레지스트리를 볼 수 있습니다. 기본적으로 스키마 레지스트리 페이지에는 구독의 모든 네임스페이스에 있는 스키마 레지스트리가 표시됩니다. 필터를 사용하여 특정 네임스페이스 또는 리소스 그룹의 스키마 레지스트리와 같은 스키마 레지스트리의 하위 집합을 볼 수 있습니다.

   

4. 네임스페이스 페이지를 사용하여 Azure 장치 레지스트리의 네임스페이스를 볼 수 있습니다. 기본적으로 네임스페이스 페이지에는 구독의 네임스페이스가 표시됩니다. 필터를 사용하여 특정 리소스 그룹의 네임스페이스와 같은 네임스페이스의 하위 집합을 볼 수 있습니다. 이 페이지에서 새 네임스페이스를 만들거나 기존 네임스페이스의 세부 정보를 볼 수 있습니다.

   

Azure IoT 작업 인스턴스를 포함하는 리소스 그룹에서 기존 네임스페이스의 세부 정보를 볼 수도 있습니다. 예를 들어 다음 스크린샷은 aio-131235032 Azure IoT 작업 인스턴스와 연결된 adr-namespace 리소스를 보여줍니다.

이전 스크린샷은 Azure IoT 작업 인스턴스를 포함하는 리소스 그룹의 컨텍스트에서 IoT 스키마 레지스트리, IoT 네임스페이스 자산 및 디바이스와 같은 Azure 장치 레지스트리의 다른 리소스도 보여 줍니다.

자산(클래식)을 자산으로 마이그레이션

네임스페이스로 이동하려는 Azure IoT Operations 인스턴스에 기존 자산이 있는 경우 이 명령을 사용할 az iot ops migrate-assets 수 있습니다. 이 명령은 루트 수준 자산(클래식)을 Azure Device Registry의 자산으로 마이그레이션합니다.

대상 자산 집합(클래식)은 해당 자산 표현으로 변환되고 원래 루트 수준 자산(클래식)을 대체합니다. 마이그레이션하는 동안 디바이스는 루트 자산에서 참조하는 엔드포인트 프로필 대신 만들어집니다. 여러 자산이 동일한 엔드포인트 프로필을 참조하는 경우 마이그레이션된 자산에서 하나의 디바이스만 참조됩니다.

인스턴스와 연결된 모든 루트 자산을 마이그레이션하려면 다음 명령을 실행합니다.

az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> 

인스턴스와 연결된 특정 루트 자산을 마이그레이션하려면 다음 명령을 실행합니다.

az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --pattern <ASSET_ID_1> <ASSET_ID_2> <ASSET_ID_3>

glob 스타일 패턴과 일치하는 인스턴스와 연결된 모든 루트 자산을 마이그레이션하려면 다음 명령을 실행합니다.

az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --pattern asset-pl-* asset-eng?-01

마이그레이션이 완료되면 명령을 사용하여 az iot ops ns assetaz iot ops ns device Azure IoT Operations 인스턴스의 자산 및 디바이스를 관리할 수 있습니다.

커넥터 템플릿 구성

Azure Portal에서 Azure IoT 작업 인스턴스에 대한 커넥터 템플릿을 구성할 수 있습니다. 커넥터 템플릿은 클러스터에 배포되는 OPC UA용 커넥터와 같은 커넥터의 구성을 정의합니다. 커넥터 템플릿을 만들면 OT 사용자가 작업 환경 웹 UI에서 커넥터 유형을 사용하는 디바이스를 만들 수 있습니다.

커넥터 템플릿에 대한 자세한 내용은 ONVIF용 커넥터 배포를 참조하세요.

인스턴스 구성 요소 관리

각 Azure IoT Operations 인스턴스에는 MQTT broker, OPC UA용 커넥터 및 데이터 흐름과 같은 여러 구성 요소가 포함됩니다. 이러한 구성 요소를 관리하는 방법에 대한 자세한 내용은 해당 문서를 참조하세요. 예를 들어 MQTT broker를 관리하려면 Broker 개요부터 시작합니다.

Kubernetes 배포 매니페스트를 사용하여 구성 요소 관리(미리 보기)

일반적으로 Azure IoT Operations는 Azure Arc 플랫폼을 사용하여 ARM(Azure Resource Manager) 및 Azure Portal, Bicep 및 Azure CLI와 같은 프런트 엔드 도구를 통해 구성을 관리할 수 있는 하이브리드 클라우드 환경을 제공합니다.

그러나 YAML Kubernetes 배포 매니페스트를 사용하여 Azure IoT Operations의 구성 요소를 관리할 수도 있습니다. 즉, Azure IoT Operations의 일부 구성 요소를 관리하는 등의 kubectl 도구를 사용할 수 있습니다. 이 기능은 미리 보기로 제공되며 몇 가지 제한 사항이 있습니다.

• 일부 구성 요소만 Kubernetes 배포 매니페스트 사용을 지원합니다. 이러한 구성 요소는 MQTT 브로커 및 데이터 흐름입니다. OPC UA 및 Akri 서비스용 커넥터와 같은 다른 구성 요소는 이 기능을 지원하지 않습니다.
• 명령을 사용하여 az iot ops enable-rsync Azure IoT Operations에서 리소스 동기화를 사용하도록 설정하지 않는 한 Kubernetes 배포 매니페스트를 사용하여 리소스에 대한 변경 내용은 Azure와 동기화되지 않습니다. 리소스 동기화에 대한 자세한 내용은 리소스 동기화를 참조하세요.
• 리소스 동기화를 사용하도록 설정하더라도 Kubernetes 배포 매니페스트를 사용하여 만든 새 리소스는 Azure와 동기화되지 않습니다. 기존 리소스에 대한 변경 내용만 동기화됩니다.

인스턴스 및 구성 업데이트

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --desc "<INSTANCE_DESCRIPTION>" --tags <TAG_NAME>=<TAG-VALUE> <TAG_NAME>=<TAG-VALUE>

az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --feature connectors.settings.preview=Enabled 

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --feature connectors.settings.preview=Disabled  

제거

Azure IoT Operations CLI 및 Azure Portal은 Azure IoT 작업을 제거하는 다양한 옵션을 제공합니다.

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps