テストおよび評価シナリオに使用できる Arc 対応 Kubernetes クラスターであるテスト クラスターに Azure IoT Operations をデプロイする方法について説明します。
Azure IoT Operations を運用クラスターにデプロイする場合は、「運用クラスターに Azure IoT Operations をデプロイする」を参照してください。
開始する前に
この記事では、Azure IoT Operations の デプロイ と インスタンスについて説明します。これは 2 つの異なる概念です。
Azure IoT Operations のデプロイには、Azure IoT Operations シナリオを実現するすべてのコンポーネントとリソースが記述されています。 これらのコンポーネントとリソースには以下が含まれます。
- Azure IoT Operations インスタンス
- Arc 拡張機能
- カスタムロケーション
- 資産やデバイスなど、Azure IoT Operations ソリューションで構成できるリソース。
Azure IoT Operations の "インスタンス" は、MQTT ブローカー、データ フロー、OPC UA 用コネクタなど、「Azure IoT Operations とは」で定義されている一連のサービスがバンドルされた親リソースです。
Azure IoT Operations のデプロイについて説明するときは、"デプロイ" を構成するコンポーネントの完全なセットを意味します。 デプロイが存在すると、インスタンスを表示、管理、および更新できます。
[前提条件]
クラウド リソース:
Azure サブスクリプション。
Azure アクセス許可。 詳細については、「デプロイの詳細」>「必要なアクセス許可」を参照してください。
開発リソース:
- 開発マシンにインストールされた Azure CLI。 このシナリオには、Azure CLI バージョン 2.53.0 以降が必要です。
az --versionを使用してバージョンを確認し、必要に応じてaz upgradeを使用して更新します。 詳細については、Azure CLIのインストール方法に関するページを参照してください。
クラスター ホスト:
カスタムの場所とワークロード ID 機能が有効になっている Azure Arc 対応 Kubernetes クラスターを設けます。 お持ちでない場合は、「Azure Arc 対応 Kubernetes クラスターを準備する」の手順に従います。
クラスターに Azure IoT Operations を既にデプロイしている場合、続行する前にそれらのリソースをアンインストールします。 詳細については、「Azure IoT Operations を更新する」を参照してください。
Azure portal でのデプロイ
Azure portal のデプロイ エクスペリエンスは、リソースと構成に基づいてデプロイ コマンドを生成するヘルパー ツールです。 最後の手順は Azure CLI コマンドを実行することなので、前のセクションで説明した Azure CLI の前提条件が必要です。
Azure ポータルにサインインします。
検索ボックスで、 Azure IoT Operations を検索して選択します。
を選択してを作成します。
[基本] タブで次の情報を指定します。
パラメーター 価値 サブスクリプション Arc 対応クラスターを含むサブスクリプションを選択します。 リソース グループ Arc 対応クラスターを含むリソース グループを選択します。 クラスター名 Azure IoT Operations をデプロイするクラスターを選択します。 カスタムの場所名 省略可能: カスタムの場所の既定の名前を置き換えます。 デプロイのバージョン 1.2 (最新) バージョンを選択します。 詳細については、IoT Operations のバージョンを参照してください。 「Next: 構成」を選択します。
[構成] タブで、次の情報を入力します。
パラメーター 価値 Azure IoT Operations 名 省略可能: Azure IoT Operations インスタンスの既定の名前を置き換えます。 MQTT ブローカーの構成 省略可能: MQTT ブローカーの既定の設定を編集します。 Azure portal では、カーディナリティとメモリ プロファイルの設定を構成できます。 ディスクベース メッセージ バッファーや高度な MQTT クライアント オプションなどのその他の設定を構成するには、「Azure CLI による高度な MQTT ブローカー構成のサポート」を参照してください。 データ フロー プロファイルの構成 省略可能: データ フローの既定の設定を編集します。 詳細については、「データ フロー プロファイルを構成する」を参照してください。 [次へ: 依存関係の管理] を選択します。
[依存関係の管理] タブで、既存のスキーマ レジストリを選択するか、次の手順を使用して作成します。
[新規作成] を選択します。
スキーマ レジストリ名とスキーマ レジストリ名前空間を指定します。
[Azure Storage コンテナーの選択] を選択します。
階層型名前空間が有効なアカウントの一覧からストレージ アカウントを選択するか、[作成] を選択して作成します。
スキーマ レジストリには、階層型名前空間とパブリック ネットワーク アクセスが有効になっている Azure ストレージ アカウントが必要です。 新しいストレージ アカウントを作成する場合は、ストレージ アカウントの種類として [汎用 v2] を選択し、[階層型名前空間] を [有効] に設定します。
ストレージ アカウントの構成の詳細については、「 運用デプロイガイドライン」を参照してください。
ストレージ アカウントのコンテナーを選択するか、[コンテナー] を選択して作成します。
[適用] を選択して、スキーマ レジストリの構成を確認します。
Azure IoT Operations では 、名前空間を 使用して資産とデバイスを整理します。 各 Azure IoT Operations インスタンスは、その資産とデバイスに 1 つの名前空間を使用します。 [ 依存関係管理 ] タブで、既存の Azure Device Registry 名前空間を選択するか、次の手順を使用して作成します。
[新規作成] を選択します。
[基本] タブで次の情報を指定します。
パラメーター 価値 サブスクリプション サブスクリプションを選択します。 リソース グループ Azure IoT Operations インスタンスを含むリソース グループを選択します。 名前 名前空間の一意の名前を指定します。 リージョン 名前空間を格納する Azure リージョンを選択します。 [次へ] を選択して続行します。
[ タグ ] タブでは、必要に応じて名前空間にタグを追加できます。 [次へ] を選択して続行します。
[ 確認と作成 ] タブで、構成を確認し、[ 作成 ] を選択して名前空間を作成します。
[依存関係管理] タブに戻り、新しく作成した名前空間を一覧から選択します。
[ 依存関係管理 ] タブで、[ テスト設定 のデプロイ] オプションを選択します。 このオプションでは、テスト目的で推奨される既定の設定が使用されます。
[次へ: オートメーション] を選択します。
Azure CLI コマンドを実行する
Azure portal デプロイ エクスペリエンスの最後の手順は、一連の Azure CLI コマンドを実行して、Azure IoT 操作をクラスターにデプロイすることです。 コマンドは、前の手順で指定した情報に基づいて生成されます。
ターミナルの [オートメーション] タブで、各 Azure CLI コマンドを一度に 1 つずつ実行します。
以前に既にサインインしている場合も、ブラウザーを使って対話操作で Azure CLI にサインインします。 対話操作でサインインしないと、"このリソースにアクセスするには、デバイスが管理されている必要があります。" というエラーが表示される場合があります。
az loginまだインストールしていない場合は、最新の Azure IoT Operations CLI 拡張機能をインストールします。
az extension add --upgrade --name azure-iot-ops指定された az iot ops schema registry create コマンドをコピーして実行し、Azure IoT Operations コンポーネントで使用されるスキーマ レジストリを作成します。 既存のスキーマ レジストリを使用することを選択した場合、このコマンドは [自動] タブには表示されません。
Azure IoT Operations のデプロイ用にクラスターを準備します。 提供された az iot ops init コマンドをコピーして実行します。
ヒント
initコマンドは、クラスターごとに 1 回実行するだけでかまいません。 オプションの前提条件に従って独自の証明機関の発行者を設定した場合は、「Bring your own issuer」の手順に従います。このコマンドは、完了までに数分かかる場合があります。 ターミナルのデプロイの進行状況の表示で進行状況を確認できます。
Azure IoT Operations をデプロイするには、指定された az iot ops create コマンドを コピーして実行します。 このコマンドは、完了までに数分かかる場合があります。 ターミナルのデプロイの進行状況の表示で進行状況を確認できます。
すべての Azure CLI コマンドが正常に完了したら、Azure IoT Operations のインストール ウィザードは閉じてかまいません。
create コマンドが正常に完了すると、クラスターで動作する Azure IoT Operations インスタンスが実行されます。 この時点で、インスタンスはほとんどのテストおよび評価シナリオ用に構成されています。
デプロイを検証する
デプロイが完了したら、 az iot ops check を実行して、IoT Operations サービスのデプロイの正常性、構成、および使いやすさを評価します。
check コマンドは、デプロイと構成の問題を見つけるのに役立ちます。
az iot ops check
check コマンドにより、データ フローの欠落に関する警告が表示されますが、これはデータ フローを作成するまでは正常であり、想定内です。 詳細については、「データ フローでのデータの処理とルーティング」を参照してください。
トピック マップ、QoS、メッセージ ルートの構成を確認するには、詳細ビューの --detail-level 2 コマンドに check パラメーターを追加します。
次のコマンドを実行すると、使用可能なすべてのバージョンの Azure IoT Operations CLI 拡張機能を表示できます。
az iot ops get-versions
次のステップ
デプロイした Azure IoT Operations インスタンスは、テスト シナリオ用に構成されています。 セキュリティで保護された設定を有効にし、運用シナリオ用にインスタンスを準備する場合は、「 既存の Azure IoT Operations インスタンスでセキュリティで保護された設定を有効にする」の手順に従います。