Azure IoT Operations インスタンスのライフサイクルを管理する

Azure CLI と Azure portal を使用して、Azure IoT Operations インスタンスを管理、アンインストール、または更新します。

前提条件

• クラスターにデプロイされた Azure IoT Operations インスタンス。 詳細については、「Deploy Azure IoT Operations」をご覧ください。

• 開発マシンにインストールされた Azure CLI。 このシナリオには、Azure CLI バージョン 2.53.0 以降が必要です。 az --version を使用してバージョンを確認し、必要に応じて az upgrade を使用して更新します。 詳細については、Azure CLIのインストール方法に関するページを参照してください。

• Azure CLI 用の Azure IoT Operations 拡張機能。 次のコマンドを使用して、拡張機能を追加するか、それを最新バージョンに更新します。

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

管理する

デプロイ後、Azure CLI と Azure portal を使用して、Azure IoT Operations インスタンスを表示および管理できます。

インスタンスの一覧表示

Azure Portal

1. Azure portal で、Azure IoT Operations を検索して選択します。
2. フィルターを使用して、サブスクリプション、リソース グループなどに基づいて Azure IoT Operations インスタンスを表示します。

Azure CLI

サブスクリプションまたはリソース グループ内のすべての Azure IoT Operations インスタンスを表示するには、az iot ops list コマンドを使用します。

基本コマンドは該当するサブスクリプションのすべてのインスタンスを返します。

az iot ops list

リソース グループで結果をフィルター処理するには、--resource-group パラメーターを追加します。

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

インスタンスを表示する

Azure Portal

Azure portal で Azure IoT Operations インスタンスを表示できます。

1. Azure portal で、Azure IoT Operations インスタンスを含むリソース グループに移動するか、Azure IoT Operations を検索して選択します。

2. Azure IoT Operations インスタンスの名前を選択します。

3. インスタンスの [概要 ] ページで、インスタンスのプロパティを確認できます。 たとえば、有効または無効にできる コネクタの状態を確認できます。 コネクタの状態を変更するには、[ 編集] をクリックします。

   

   この操作により、 ONVIF のコネクタを有効または無効にできる構成パネルが開きます。

4. [ リソースの概要 ] タブには、クラスターにデプロイされたリソースが表示されます。

Azure CLI

インスタンスのプロパティを表示するには az iot ops show コマンドを使用します。

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

また、az iot ops show コマンドを使用して、Azure IoT Operations デプロイのリソースを Azure CLI で表示することもできます。 --tree フラグを追加して、指定した Azure IoT Operations インスタンスを含むデプロイのツリー ビューを表示します。

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 Operations コンポーネントの正常性と構成を評価できます。 既定では、コマンドで MQ をチェックしますが、 パラメーターを使用して--ops-serviceできます。

Azure Device Registry の表示

Azure portal では、Azure Device Registry を表示できます。これは、Azure IoT Operations インスタンスに接続されているすべてのデバイスと資産のコレクションです。

Azure Device Registry では、 名前空間を 使用して資産とデバイスを整理します。 各 Azure IoT Operations インスタンスは、その資産とデバイスに 1 つの名前空間を使用します。 複数のインスタンスで 1 つの名前空間を共有できます。

Azure Portal で Azure Device Registry の項目を表示するには:

1. Azure portal で、Azure Device Registry を検索して選択します。 [ 概要] ページには、サブスクリプション内の資産、スキーマ レジストリ、名前空間の数がまとめられます。

   

2. [資産] ページを使用して、Azure Device Registry の資産を表示します。 既定では、[ 資産] ページには、サブスクリプション内のすべての名前空間の資産が表示されます。 フィルターを使用して、特定の名前空間やリソース グループ内の資産など、資産のサブセットを表示します。

   

3. [ スキーマ レジストリ ] ページを使用して、Azure Device Registry のスキーマ レジストリを表示します。 既定では、[ スキーマ レジストリ ] ページには、サブスクリプション内のすべての名前空間のスキーマ レジストリが表示されます。 フィルターを使用して、特定の名前空間またはリソース グループ内のスキーマ レジストリなどのスキーマ レジストリのサブセットを表示します。

   

4. [名前空間] ページを使用して、Azure Device Registry の名前空間を表示します。 既定では、[ 名前空間] ページにはサブスクリプション内の名前空間が表示されます。 フィルターを使用して、特定のリソース グループ内の名前空間などの名前空間のサブセットを表示します。 このページでは、新しい名前空間を作成したり、既存の名前空間の詳細を表示したりできます。

   

Azure IoT Operations インスタンスを含むリソース グループ内の既存の名前空間の詳細を表示することもできます。 たとえば、次のスクリーンショットは、aio-131235032 Azure IoT Operations インスタンスに関連付けられている adr-namespace リソースを示しています。

前のスクリーンショットでは、Azure Device Registry の他のリソース ( IoT スキーマ レジストリ、 IoT 名前空間資産、 デバイス など) も、Azure IoT Operations インスタンスを含むリソース グループのコンテキストで示されています。

資産 (クラシック) を資産に移行する

名前空間に移動する既存の資産が Azure IoT Operations インスタンスにある場合は、 az iot ops migrate-assets コマンドを使用できます。 このコマンドは、ルート レベルの資産 (クラシック) を Azure Device Registry の資産に移行します。

注

資産を移行するには、Azure IoT Operations インスタンス バージョン 1.2.36 以降が必要です。

資産のターゲット セット (クラシック) は同等の資産表現に変換され、元のルート レベルの資産 (クラシック) が置き換えられます。 移行中は、ルート資産によって参照されるエンドポイント プロファイルの代わりにデバイスが作成されます。 複数の資産が同じエンドポイント プロファイルを参照する場合、移行された資産によって参照されるデバイスは 1 つだけです。

インスタンスに関連付けられているすべてのルート資産を移行するには、次のコマンドを実行します。

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 clone コマンドを使用してインスタンスのスナップショットを作成してください。 これにより、必要に応じてインスタンスを以前の状態に復元できます。 詳細については、「 IoT Operations インスタンスの複製」を参照してください。

移行が完了したら、 az iot ops ns asset コマンドと az iot ops ns device コマンドを使用して、Azure IoT Operations インスタンス内の資産とデバイスを管理できます。

コネクタ テンプレートを構成する

Azure portal では、Azure IoT Operations インスタンス のコネクタ テンプレート を構成できます。 コネクタ テンプレートは、クラスターにデプロイされる OPC UA 用コネクタなどのコネクタの構成を定義します。 コネクタ テンプレートを作成すると、OT ユーザーは操作エクスペリエンス Web UI でコネクタの種類を使用するデバイスを作成できます。

コネクタ テンプレートの詳細については、「 ONVIF 用のコネクタをデプロイする」を参照してください。

インスタンス コンポーネントの管理

各 Azure IoT Operations インスタンスには、MQTT ブローカー、OPC UA 用コネクタ、データ フローなど、いくつかのコンポーネントが含まれています。 これらのコンポーネントの管理について詳しくは、それぞれの記事を参照してください。 たとえば、MQTT ブローカーの管理については、最初に Broker の概要に関する記事をご覧ください。

Kubernetes 配置マニフェストを使用してコンポーネントを管理する (プレビュー)

一般に、Azure IoT Operations により Azure Arc プラットフォームを使って提供されるハイブリッド クラウド エクスペリエンスでは、Azure Resource Manager (ARM) と、Azure portal、Bicep、Azure CLI などのフロントエンド ツールを使って、構成を管理できます。

ただし、YAML Kubernetes の配置マニフェストを使って、Azure IoT Operations のコンポーネントを管理することもできます。 つまり、kubectl などのツールを使って、Azure IoT Operations の一部のコンポーネントを管理できます。 この機能はプレビュー段階であり、いくつかの制限があります。

• Kubernetes 配置マニフェストの使用は、一部のコンポーネントでのみサポートされます。 MQTT ブローカーやデータ フローがそのようなコンポーネントです。 OPC UA 用コネクタや Akri サービスのような他のコンポーネントでは、この機能はサポートされていません。
• az iot ops enable-rsync コマンドを使用して Azure IoT Operations でリソース同期を有効にしない限り、Kubernetes デプロイ マニフェストを使用してリソースに加えられた変更は Azure に同期されません。 リソースの同期について詳しくは、「リソースの同期」をご覧ください。
• リソースの同期が有効になっている場合でも、Kubernetes 配置マニフェストを使って作成された新しいリソースは Azure に同期されません。 既存のリソースへの変更のみが同期されます。

インスタンスと構成を更新する

Azure Portal

1. Azure portal で、Azure IoT Operations インスタンスを含むリソース グループに移動するか、Azure IoT Operations を検索して選択します。

2. Azure IoT Operations インスタンスの名前を選択します。

3. インスタンスの [概要] ページで、[タグの追加] または [編集] を選択して、インスタンスのタグを変更します。

Azure CLI

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>

インスタンスのすべてのタグを削除するには、tags パラメーターを 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 CLI と Azure portal には、Azure IoT Operations をアンインストールするためのさまざまなオプションが用意されています。

重要

クラスターとリソース グループをクリーンアップする場合は、まず、次のセクションの Azure IoT Operations CLI コマンドを使用して、クラスターから Azure IoT Operations を削除することをお勧めします。 その後、リソース グループを削除できます。 リソース グループを直接削除すると、クラスター上の孤立したリソースが残ります。

Azure Portal

1. Azure portal で、Azure IoT Operations インスタンスを含むリソース グループに移動するか、Azure IoT Operations を検索して選択します。

2. Azure IoT Operations インスタンスの名前を選択します。

3. インスタンスの [概要] ページ上で、[削除] を選択します。

4. この操作の一部として削除されるリソースと削除されないリソースの一覧を確認し、インスタンスの名前を入力して [削除] を選択して確定します。

   

注

Azure Portal で Azure IoT Operations インスタンスを削除しても、Azure IoT Operations のデプロイ時に作成された依存関係は削除されません。 これらの依存関係を削除するには、Azure CLI の手順で説明されている az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps コマンドを使用します。

Azure CLI

az iot ops delete コマンドを使用して、クラスターから Azure IoT Operations デプロイ全体を削除します。 delete コマンドでは、クラスター上の Azure IoT Operations 関連リソースが評価され、削除するリソースのツリー ビューが示されます。 このコマンドの実行時にはクラスターがオンライン状態である必要があります。

delete コマンドを使用すると、同じクラスターへの Azure IoT Operations の再デプロイが効率化されます。 create コマンドが元に戻されるため、create を再実行しなくても、delete、create、もう一度 init のように実行できます。

delete コマンドでは以下が削除されます。

• Azure IoT Operations インスタンス
• Arc 拡張機能
• カスタムロケーション
• 資産、MQTT ブローカー、データ フローなど、Azure IoT Operations ソリューションで構成できるリソース。

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

インスタンスを削除し、Azure IoT Operations の依存関係 (init の出力) も削除するには、フラグ --include-deps を追加します。

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