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 で、Azure IoT Operations を検索して選択します。
- フィルターを使用して、サブスクリプション、リソース グループなどに基づいて Azure IoT Operations インスタンスを表示します。
サブスクリプションまたはリソース グループ内のすべての Azure IoT Operations インスタンスを表示するには、az iot ops list
コマンドを使用します。
基本コマンドは該当するサブスクリプションのすべてのインスタンスを返します。
az iot ops list
リソース グループで結果をフィルター処理するには、--resource-group
パラメーターを追加します。
az iot ops list --resource-group <RESOURCE_GROUP>
インスタンスを表示する
Azure portal で Azure IoT Operations インスタンスを表示できます。
Azure portal で、Azure IoT Operations インスタンスを含むリソース グループに移動するか、Azure IoT Operations を検索して選択します。
Azure IoT Operations インスタンスの名前を選択します。
インスタンスの [概要 ] ページで、インスタンスのプロパティを確認できます。 たとえば、 プレビュー コネクタの状態を確認できます。この状態は、有効または無効にすることができます。 プレビュー コネクタの状態を変更するには、[ 編集] をクリックします。
この操作により、 ONVIF プレビュー コネクタを有効または無効にできる構成パネルが開きます。
[ リソースの概要 ] タブには、クラスターにデプロイされたリソースが表示されます。
インスタンスのプロパティを表示するには 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 portal では Azure IoT Operations インスタンスの複製はサポートされていません。 Azure CLI を使用してインスタンスを複製できます。
az iot ops clone
コマンドを使用して、既存のインスタンスに基づいて新しい Azure IoT Operations インスタンスを作成します。 複製の出力を、レプリケーションと呼ばれる別の接続されたクラスターに適用できます。 後で使用するために複製をローカル ディレクトリに保存し、クラスターに適用する前にいくつかの構成変更を実行することもできます。
詳細については、 複製コマンド Wiki ページを参照してください。
インスタンスを別のクラスターに複製するには、次のコマンドを実行します。
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 IoT Operations インスタンスを含むリソース グループに移動するか、Azure IoT Operations を検索して選択します。
Azure IoT Operations インスタンスの名前を選択します。
インスタンスの [概要] ページで、[タグの追加] または [編集] を選択して、インスタンスのタグを変更します。
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 インスタンスには、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 rsync enable
を使用して Azure IoT Operations でリソース同期を有効にしない限り、Kubernetes デプロイ マニフェストを使用してリソースに加えられた変更は Azure に同期されません。 リソースの同期について詳しくは、「リソースの同期」をご覧ください。
- リソースの同期が有効になっている場合でも、Kubernetes 配置マニフェストを使って作成された新しいリソースは Azure に同期されません。 既存のリソースへの変更のみが同期されます。
アンインストール
Azure IoT Operations CLI と Azure portal には、Azure IoT Operations をアンインストールするためのさまざまなオプションが用意されています。
重要
クラスターとリソース グループをクリーンアップする場合は、まず、次のセクションの Azure IoT Operations CLI コマンドを使用して、クラスターから Azure IoT Operations を削除することをお勧めします。 その後、リソース グループを削除できます。 リソース グループを直接削除すると、クラスター上の孤立したリソースが残ります。
Azure portal で、Azure IoT Operations インスタンスを含むリソース グループに移動するか、Azure IoT Operations を検索して選択します。
Azure IoT Operations インスタンスの名前を選択します。
インスタンスの [概要] ページ上で、[削除] を選択します。
この操作の一部として削除されるリソースと削除されないリソースの一覧を確認し、インスタンスの名前を入力して [削除] を選択して確定します。
注
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 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