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

2025-05-27

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 작업 인스턴스를 보고 관리할 수 있습니다.

Azure Portal에서 Azure IoT 작업을 검색하고 선택합니다.
필터를 사용하여 구독, 리소스 그룹 등을 기반으로 Azure IoT 작업 인스턴스를 볼 수 있습니다.

az iot ops list 명령을 사용하여 구독 또는 리소스 그룹의 모든 Azure IoT 작업 인스턴스를 볼 수 있습니다.

기본 명령은 구독의 모든 인스턴스를 반환합니다.

az iot ops list

리소스 그룹별로 결과를 필터링하려면 --resource-group 매개 변수를 추가합니다.

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

인스턴스 보기

Azure Portal
Azure CLI

Azure Portal에서 Azure IoT 작업 인스턴스를 볼 수 있습니다.

Azure Portal에서 Azure IoT Operations 인스턴스가 포함된 리소스 그룹으로 이동하거나 Azure IoT Operations를 검색하여 선택합니다.
Azure IoT 작업 인스턴스의 이름을 선택합니다.
인스턴스의 개요 페이지에서 인스턴스의 속성을 볼 수 있습니다. 예를 들어 미리 보기 커넥터의 상태를 볼 수 있습니다. 이 커넥터는 사용하거나 사용하지 않도록 설정할 수 있습니다. 미리 보기 커넥터의 상태를 변경하려면 편집을 클릭합니다.

이 작업을 수행하면 ONVIF 미리 보기 커넥터를 사용하거나 사용하지 않도록 설정할 수 있는 구성 패널이 열립니다.
리소스 요약 탭에는 클러스터에 배포된 리소스가 표시됩니다.

az iot ops show 명령을 사용하여 인스턴스의 속성을 볼 수 있습니다.

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

이 az iot ops show 명령을 사용하여 Azure CLI에서 Azure IoT 작업 배포의 리소스를 볼 수도 있습니다. --tree 플래그를 추가하여 지정된 Azure IoT 작업 인스턴스를 포함하는 배포의 트리 뷰를 표시할 수 있습니다.

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

클러스터에서 az iot ops check을(를) 실행하여 개별 Azure IoT 작업 구성 요소의 상태 및 구성을 평가할 수 있습니다. 기본적으로 이 명령은 MQ를 확인하지만 매개 변수를 사용하여 --ops-service할 수 있습니다.

(미리 보기) 인스턴스 복제

비고

복제 기능은 미리 보기로 제공되며 개발 중입니다.

Azure Portal
Azure CLI

현재 Azure Portal은 Azure IoT Operations 인스턴스 복제를 지원하지 않습니다. Azure CLI를 사용하여 인스턴스를 복제할 수 있습니다.

이 az iot ops clone 명령을 사용하여 기존 인스턴스를 기반으로 새 Azure IoT Operations 인스턴스를 만듭니다. 복제라고 하는 다른 연결된 클러스터에 복제 출력을 적용할 수 있습니다. 나중에 사용할 수 있도록 로컬 디렉터리에 클론을 저장하고 클러스터에 적용하기 전에 일부 구성 변경을 수행할 수도 있습니다.

자세한 내용은 복제 명령 위키 페이지를 참조하세요.

인스턴스를 다른 클러스터에 복제하려면 다음을 실행합니다.

az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID>

다른 클러스터에 대한 복제를 사용자 지정하려면 형식--param으로 변경하려는 매개 변수를 사용하고 key=value 지정합니다. 예를 들어 복제된 인스턴스의 위치를 변경하려면 다음을 실행합니다.

az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --param ___location=eastus

인스턴스를 로컬 디렉터리에 복제하려면 다음을 실행합니다.

az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-dir <DIRECTORY>

팁 (조언)

인스턴스를 현재 디렉터리에 복제하려면 --to-dir .

인스턴스를 클러스터에 복제하지만 자산 관련 하위 배포를 분할 및 직렬로 적용하려면 다음을 실행합니다.

az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --mode linked

인스턴스 및 구성 업데이트

Azure Portal
Azure CLI

Azure Portal에서 Azure IoT Operations 인스턴스가 포함된 리소스 그룹으로 이동하거나 Azure IoT Operations를 검색하여 선택합니다.
Azure IoT 작업 인스턴스의 이름을 선택합니다.
인스턴스의 개요 페이지에서 태그 추가 또는 편집 을 선택하여 인스턴스에서 태그를 수정합니다.

az iot ops update 명령을 사용하여 Azure IoT Operations 인스턴스의 기능을 편집합니다.

인스턴스의 태그 및 설명 매개 변수를 업데이트하려면 다음을 실행합니다.

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

인스턴스의 모든 태그를 삭제하려면 태그 매개 변수를 null 값으로 설정합니다. 예시:

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 인스턴스에는 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 서비스용 커넥터와 같은 다른 구성 요소는 이 기능을 지원하지 않습니다.
Azure IoT Operations에서 리소스 동기화를 사용하도록 az iot ops rsync enable설정하지 않는 한 Kubernetes 배포 매니페스트를 사용하여 리소스에 대한 변경 내용은 Azure와 동기화되지 않습니다. 리소스 동기화에 대한 자세한 내용은 리소스 동기화를 참조하세요.
리소스 동기화를 사용하도록 설정하더라도 Kubernetes 배포 매니페스트를 사용하여 만든 새 리소스는 Azure와 동기화되지 않습니다. 기존 리소스에 대한 변경 내용만 동기화됩니다.

제거

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

중요합니다

클러스터 및 리소스 그룹을 정리하려면 먼저 다음 섹션의 Azure IoT Operations CLI 명령을 사용하여 클러스터에서 Azure IoT 작업을 제거하는 것이 좋습니다. 그런 다음 리소스 그룹을 삭제할 수 있습니다. 리소스 그룹을 직접 삭제하면 분리된 리소스가 클러스터에 남게 됩니다.

Azure Portal
Azure CLI

Azure Portal에서 Azure IoT Operations 인스턴스가 포함된 리소스 그룹으로 이동하거나 Azure IoT Operations를 검색하여 선택합니다.
Azure IoT 작업 인스턴스의 이름을 선택합니다.
인스턴스의 개요 페이지에서 삭제를 선택합니다.
이 작업의 일부로 삭제되지 않은 리소스 목록을 검토한 다음 인스턴스의 이름을 입력하고 삭제 를 선택하여 확인합니다.

비고

Azure Portal에서 Azure IoT Operations 인스턴스를 삭제해도 Azure IoT Operations를 배포할 때 생성된 종속성은 제거되지 않습니다. 이러한 종속성을 제거하려면 Azure CLI 프로시저에 설명된 명령을 사용합니다 az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps .

az iot ops delete 명령을 사용하여 클러스터에서 전체 Azure IoT Operations 배포를 삭제합니다. delete 명령은 클러스터에서 Azure IoT 작업 관련 리소스를 평가하고 삭제할 리소스의 트리 뷰를 제공합니다. 이 명령을 실행할 때 클러스터는 온라인 상태여야 합니다.

이 delete 명령은 Azure IoT Operations를 동일한 클러스터에 다시 배포하는 작업을 간소화합니다. 명령create을 실행 취소하여 create, delete, create을/를 다시 실행할 수 있게 하고, init을/를 다시 실행할 필요가 없도록 합니다.

delete 명령은 다음을 제거합니다.

Azure IoT 작업 인스턴스
Arc 확장
사용자 지정 위치
리소스 동기화 규칙
자산, MQTT 브로커 및 데이터 흐름과 같은 Azure IoT Operations 솔루션에서 구성할 수 있는 리소스입니다.

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

인스턴스를 삭제하고 Azure IoT 작업 종속성(출력 init)도 제거하려면 플래그 --include-deps를 추가합니다.

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