Azure IoT Operations プレビューを Arc 対応 Kubernetes クラスターにデプロイする

1. 以前に既にサインインしている場合も、ブラウザーを使って対話操作で Azure CLI にサインインします。 対話操作でサインインしないと、Azure IoT Operations をデプロイする次の手順に進んだときに、"リソースにアクセスするにはデバイスを管理対象にする必要があります" というエラーが表示される場合があります。

   az login
   

   Note

   ブラウザーで Github Codespaces を使用している場合、ログイン後に、az login によってブラウザー ウィンドウに localhost エラーが表示されます。 修正するには、次のいずれかを行います。

   • VS Code デスクトップで codespace を開き、ターミナルでaz login を実行します。 ブラウザー ウィンドウが開き、Azure にログインできます。
   • または、ブラウザーで localhost エラーが発生した後、ブラウザーから URL をコピーして、新しいターミナル タブで curl <URL> を使用します。「Microsoft Azure にログインしました！」というメッセージを含む JSON 応答が表示されます。

2. Azure IoT Operations をクラスターにデプロイします。 オプションのフラグを使って、シナリオに合わせて az iot ops init コマンドをカスタマイズできます。

   既定では、az iot ops init コマンドによって次のアクションが実行されます。一部のアクションでは、CLI にサインインしているプリンシパルが昇格されたアクセス許可を持っている必要があります。

   • サービス プリンシパルとアプリの登録を設定して、クラスターにキー コンテナーへのアクセス権を付与します。
   • TLS 証明書を構成します。
   • キー コンテナーに接続するクラスターにシークレット ストアを構成します。
   • Azure IoT Operations リソースをデプロイします。

   az iot ops init --cluster <CLUSTER_NAME> --resource-group <RESOURCE_GROUP> --kv-id <KEYVAULT_SETTINGS_PROPERTIES_RESOURCE_ID>
   

   省略可能なパラメーターを使用して、次のようにデプロイをカスタマイズします。

   パラメーター	価値	説明
   --add-insecure-listener		既定のリスナーに安全でない 1883 ポート構成を追加します。 運用環境向けではありません。
   --broker-config-file	JSON ファイルへのパス	MQTT ブローカー用の構成ファイルを提供します。 詳細については、「高度な MQTT ブローカー構成」と「MQTT ブローカーのコア設定を構成する」を参照してください。
   --disable-rsync-rules		リソース グループの Microsoft.Authorization/roleAssignment/write アクセス許可がない場合は、デプロイ機能フラグのリソース同期ルールを無効にします。
   --name	String	Azure IoT Operations インスタンスの名前を指定します。 そうでない場合は、既定の名前が割り当てられます。 コマンド出力で instanceName パラメーターを表示できます。
   --no-progress		ターミナルでのデプロイの進捗の表示を無効にします。
   --simulate-plc		OPC UA コネクタに同梱されている OPC PLC シミュレーターを含めます。
   --sp-app-id, --sp-object-id, --sp-secret	サービス プリンシパル アプリ ID、サービス プリンシパル オブジェクト ID、サービス プリンシパル シークレット	init が新しいサービス プリンシパル、アプリの登録、シークレットを作成できるようにする代わりに、既存のものを使用する場合は、これらのパラメーターのすべてまたは一部を含めます。 詳しくは、「サービス プリンシパルとキー コンテナーを手動で構成する」を参照してください。

1. Azure portal で、Azure IoT Operations を検索して選択します。

2. ［作成］ を選択します

3. [基本] タブで次の情報を指定します。

   パラメーター	値
   サブスクリプション	Arc 対応クラスターを含むサブスクリプションを選択します。
   リソース グループ	Arc 対応クラスターを含むリソース グループを選択します。
   [Cluster name](クラスター名)	Azure IoT Operations をデプロイするクラスターを選択します。
   カスタムの場所名	省略可能: カスタムの場所の既定の名前を置き換えます。

   

4. [Next:構成] を選択します。

5. [構成] タブで、次の情報を入力します。

   パラメーター	値
   Azure IoT Operations 名	省略可能: Azure IoT Operations インスタンスの既定の名前を置き換えます。
   MQTT ブローカーの構成	省略可能: MQTT ブローカの既定の設定を置き換えます。 詳細については、「MQTT ブローカーのコア設定を構成する」を参照してください。

6. [次へ: オートメーション] を選択します。

7. [オートメーション] タブで、次の情報を指定します。

   パラメーター	値
   サブスクリプション	Azure キー コンテナーが含まれているサブスクリプションを選択します。
   Azure Key Vault	Azure キー コンテナーを選択します。 または、[新規作成] を選択します。 キー コンテナーの権限モデルとしてコンテナー アクセス ポリシーがあることを確認してください。 この設定を確認するには、[選択したコンテナーの管理]>[設定]>[アクセス構成] を選択します。

   

8. Azure CLI 環境を前提条件に従って準備していない場合は、任意のターミナルで今すぐ準備してください。

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

9. 以前に既にサインインしている場合も、ブラウザーを使って対話操作で Azure CLI にサインインします。 対話操作でサインインしないと、Azure IoT Operations をデプロイする次の手順に進んだときに、"リソースにアクセスするにはデバイスを管理対象にする必要があります" というエラーが表示される場合があります。

   az login
   

10. Azure portal の [オートメーション] タブから az iot ops init コマンドをコピーし、ターミナルで実行します。

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

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

az iot ops list

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

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

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

インスタンスのプロパティを表示するには 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 インスタンスを表示できます。

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

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

3. インスタンスの [概要] ページで [コンポーネント] タブを選択して、クラスターにデプロイされたリソースを表示します。

   

az iot ops update コマンドを使用して、Azure IoT Operations インスタンスのタグと説明パラメーターを編集します。 update コマンドで指定された値は、既存のタグや説明を置き換えます

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 ""

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

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

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

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

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

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

az iot ops delete --cluster <CLUSTER_NAME> --resource-group <RESOURCE_GROUP>

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

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

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

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