Azure CLI を使用して Azure IoT Operations を展開する

Azure CLIを使用して、既存のAzure Arc対応KubernetesクラスターにAzure IoT Operationsを展開します。 この記事では、Azure 依存関係を作成または選択し、クラスタを初期化し、インスタンスを展開し、展開を検証します。

基本インスタンスはテストと評価をサポートします。 本稼働ワークロードについては、 本番環境のセキュア設定を有効にすることも完了してください。 代わりに Azure ポータルでの展開を構成するには、「本番クラスターへの Azure IoT Operations の展開」を参照してください。

Prerequisites

  • Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、開始する前に 無料でアカウントを 1 つ作成してください。
  • 開発用コンピューターにインストールされているAzure CLI。 利用可能な Azure CLI 拡張機能で、azure-iot-ops 拡張機能を使用するために必要な最小バージョンを確認してください。 az --version を使用してバージョンを確認し、必要に応じて az upgrade を使用して更新します。 詳細については、「 Azure CLI のインストール」を参照してください。

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

    az extension add --upgrade --name azure-iot-ops
    
  • サポートされている環境要件を満たす Azure Arc 対応 Kubernetes クラスター。 リソースプロバイダーの登録、カスタムロケーションサポート、ワークロードIDの構成を含め、Azure Arc対応のKubernetesクラスターを完全準備します。
  • Microsoftを含む必要なAzure権限。スキーマレジストリの役割割り当てのための認証/roleAssignments/書き込み。
  • ターゲットクラスターへのローカル kubectl アクセス。 kubectl config current-context と kubectl get nodes を実行して、目的のクラスターに接続されていることを確認します。
  • 本環境では、初期化および作成前に証明書発行者とトラスト設定を構成してください。 詳細については、「独自の発行者を使用する」をご覧ください。

Azure Government で展開するには、サインイン前にaz cloud set --name AzureUSGovernmentを実行してください。 その他の違いについては、「Azure Government における Azure IoT Operations」を参照してください。

以前にサインインしていた場合でも、インタラクティブにサインインする:

az login

同じ Bash または PowerShell セッション内でコマンドを実行します。 続行する前にコマンドの失敗を解決してください。

デプロイ値を設定する

変数ブロック内のプレースホルダーを置き換えます。 RESOURCE_GROUP は、インスタンスを展開するArc対応クラスターのリソースグループです。 スキーマレジストリとデバイスレジストリ名前空間は異なるリソースグループに分類できます。 実際のグループは別々に指定してください。

新しいインスタンスとカスタムロケーションの名前を選択します。 --custom-location カスタムロケーション名を取ります。 このオプションパラメータを createから省略すると、CLI は location-{hash(5)} という形式の名前を生成します。

新しい依存関係の場合は、 サポートされているリージョン、グローバルに一意なストレージアカウント名(小文字3〜24文字の数字)、およびテナント内で一意のスキーマレジストリ名前空間を使用してください。 スキーマレジストリ名前空間は、Azure デバイスレジストリ名前空間および Kubernetes 名前空間とは別です。

SUBSCRIPTION_ID="<SUBSCRIPTION_ID>"
RESOURCE_GROUP="<CLUSTER_RESOURCE_GROUP>"
CLUSTER_NAME="<ARC_ENABLED_CLUSTER_NAME>"
AIO_INSTANCE_NAME="<NEW_AIO_INSTANCE_NAME>"
CUSTOM_LOCATION_NAME="<NEW_CUSTOM_LOCATION_NAME>"
LOCATION="<SUPPORTED_AZURE_REGION>"
SCHEMA_RESOURCE_GROUP="<SCHEMA_REGISTRY_RESOURCE_GROUP>"
NAMESPACE_RESOURCE_GROUP="<DEVICE_REGISTRY_NAMESPACE_RESOURCE_GROUP>"
STORAGE_ACCOUNT_NAME="<STORAGE_ACCOUNT_NAME>"
SCHEMA_REGISTRY_NAME="<SCHEMA_REGISTRY_NAME>"
SCHEMA_REGISTRY_NAMESPACE="<SCHEMA_REGISTRY_NAMESPACE>"
DEVICE_REGISTRY_NAMESPACE_NAME="<DEVICE_REGISTRY_NAMESPACE_NAME>"

az account set --subscription "$SUBSCRIPTION_ID"

依存関係を作成または選択する

Azure IoT Operations には、Azure デバイスレジストリ名前空間と、Azure ストレージアカウントによって裏付けられたスキーマレジストリが必要です。 既存の依存関係を再利用するには、変数ブロック内で名前とリソースグループを設定し、作成コマンドをスキップしてください。 一方の依存関係を作成し、もう一方を再利用することもできます。

スキーマ レジストリの作成では、その ID にストレージ アカウントへのアクセス権を付与し、Microsoft.Authorization/roleAssignments/write 権限が必要です。 詳細については、「az iot ops schema registry create」を参照してください。

az group create --name "$SCHEMA_RESOURCE_GROUP" --location "$LOCATION"
az group create --name "$NAMESPACE_RESOURCE_GROUP" --location "$LOCATION"

az storage account create \
  --name "$STORAGE_ACCOUNT_NAME" \
  --resource-group "$SCHEMA_RESOURCE_GROUP" \
  --location "$LOCATION" \
  --enable-hierarchical-namespace

STORAGE_ACCOUNT_RESOURCE_ID=$(az storage account show \
  --name "$STORAGE_ACCOUNT_NAME" \
  --resource-group "$SCHEMA_RESOURCE_GROUP" \
  --query id --output tsv)

az iot ops schema registry create \
  --name "$SCHEMA_REGISTRY_NAME" \
  --resource-group "$SCHEMA_RESOURCE_GROUP" \
  --location "$LOCATION" \
  --registry-namespace "$SCHEMA_REGISTRY_NAMESPACE" \
  --sa-resource-id "$STORAGE_ACCOUNT_RESOURCE_ID"

az iot ops ns create \
  --name "$DEVICE_REGISTRY_NAMESPACE_NAME" \
  --resource-group "$NAMESPACE_RESOURCE_GROUP" \
  --location "$LOCATION"

ランタイムを選択する

展開の例では、拡張機能のバンドルされた一般利用可能(GA)ランタイムを使用しています。 プレビュー インスタンスを展開するには、--use-preview コマンドを実行する前に az iot ops create を追加します。 このオプションは、インストール済み拡張機能にバンドルされているプレビューランタイムを選択します。

プレビュー選択には、 --use-preview をサポートする拡張機能バージョンが必要です。 インストール済みバージョンとコマンドヘルプを確認してください:

az version
az extension show --name azure-iot-ops --query version --output tsv
az iot ops create --help

フラグを追加する前に、ヘルプリストに --use-preview があることを確認してください。 もしそうでない場合は、az extension add --upgrade --name azure-iot-ops を実行してもう一度確認してください。 フラグがまだない場合は、安定版の手順を使用するか、続行する前にサポート対象の拡張機能バージョンをインストールしてください。

Important

--use-preview を使用することにより、Microsoft Azure プレビューに関する補足利用規約に同意したものとみなされます。 デプロイ前に、プレビュー ランタイムの リリース ノート およびクラスタとストレージの要件を確認してください。

クラスタを初期化し、インスタンスを展開する

以下のコマンドは、依存関係の完全な Azure リソース ID を取得し、クラスタ 基盤を初期化し、インスタンスを展開します。 create を実行する前に、各依存関係の検索が成功し、空でない ID を返す必要があります。

  • --sr-resource-id には /subscriptions/<subscription-id>/resourceGroups/<schema-resource-group>/providers/Microsoft.DeviceRegistry/schemaRegistries/<schema-registry-name> の形式の ID が必要です。
  • --ns-resource-id には /subscriptions/<subscription-id>/resourceGroups/<namespace-resource-group>/providers/Microsoft.DeviceRegistry/namespaces/<namespace-name> の形式の ID が必要です。

これらの値は、リソース名や Kubernetes 名前空間名ではなく、Azure リソース ID です。 例では SUBSCRIPTION_IDの依存関係を選択します。 別のサブスクリプションの依存関係の場合は、そのshowコマンドに--subscription <DEPENDENCY_SUBSCRIPTION_ID>を追加してフルIDを取得します。

目標リリースをサポートするクラスタ Foundation のために、 init を一度だけ実行してください。 --include-depsせずにインスタンスを削除した後に互換性のある、初期化済みのクラスターを再利用する場合は、initスキップしてください。 バージョンアップグレードについては、「Upgrade Azure IoT Operations」に従ってください。

Note

これらの例はシステム提供の自己署名トラストバンドルを使用しています。 自分の発行者を使用するには、「自分の発行者を持ち込む」に従い、初期化時の --user-trust と作成時の --trust-settings を含めてください。

SCHEMA_REGISTRY_RESOURCE_ID=$(az iot ops schema registry show \
  --name "$SCHEMA_REGISTRY_NAME" \
  --resource-group "$SCHEMA_RESOURCE_GROUP" \
  --query id --output tsv)

DEVICE_REGISTRY_NAMESPACE_RESOURCE_ID=$(az iot ops ns show \
  --name "$DEVICE_REGISTRY_NAMESPACE_NAME" \
  --resource-group "$NAMESPACE_RESOURCE_GROUP" \
  --query id --output tsv)

az iot ops init \
  --subscription "$SUBSCRIPTION_ID" \
  --resource-group "$RESOURCE_GROUP" \
  --cluster "$CLUSTER_NAME"

az iot ops create \
  --subscription "$SUBSCRIPTION_ID" \
  --resource-group "$RESOURCE_GROUP" \
  --cluster "$CLUSTER_NAME" \
  --name "$AIO_INSTANCE_NAME" \
  --custom-location "$CUSTOM_LOCATION_NAME" \
  --sr-resource-id "$SCHEMA_REGISTRY_RESOURCE_ID" \
  --ns-resource-id "$DEVICE_REGISTRY_NAMESPACE_RESOURCE_ID"

createが成功するのを待ってから、initを実行しましょう。 どちらのコマンドも数分かかることがあります。

デプロイを検証する

show を使用して、Azureインスタンス構成を表示し、現在の kubeconfig コンテキストで選択したクラスタ上のサービスを評価するcheckを行います。

az iot ops show --name "$AIO_INSTANCE_NAME" --resource-group "$RESOURCE_GROUP"
az iot ops check

チェックの詳細については、「デプロイの確認」を参照してください。

本番環境でセキュア設定を有効にする

initとcreateを実行した後、基本インスタンスはテストの準備が整います。 本番ワークロードにインスタンスを使用する前に、「 セキュア設定を有効にする」の CLI 手順を完了してください:

  1. RBAC 対応の Azure Key Vault と、シークレット用のユーザー割り当て管理型アイデンティティを作成または選択します。 ユーザーアカウントにシークレット管理の権限を付与します。
  2. az iot ops secretsync enable を、キー ボールトとシークレット ID の完全なリソース ID を指定して実行し、シークレット同期を設定します。
  3. クラウド接続には、別途ユーザー割り当てのマネージドIDを使用してください。 az iot ops identity assignを使用し、その ID に必要なクラウド リソースへのアクセス権を付与します。 データフローグラフの場合、wasm-graph ID の使用も設定してください。
  4. セキュア設定手順の指示に従ってスキーマレジストリポッドを再起動し、再度 az iot ops check を実行します。

セキュア設定手順では、これらの手順用の Bash コマンドと PowerShell コマンドが記載されています。 初期化前に選択した証明書発行者およびトラスト構成を保持します。

リソースをクリーンアップする

クリーンアップや再デプロイを行うには、Uninstall を参照してください。 az iot ops deleteコマンドはインスタンスのデプロイを削除し、initで準備された基盤を保持します。 az iot ops delete --include-depsコマンドは初期化依存関係も削除します。 確認する前に削除ツリーを確認してください。 スキーマレジストリ、ストレージアカウント、デバイスレジストリ名前空間など、作成または共有されたリソースは別々に管理します。

切断されたクラスターがアンインストールをブロックする場合は、ブロックされたアンインストールの回復--force および残留リソースのクリーンアップに関するガイダンスを参照してください。

Important

リソースグループを削除する前に Azure IoT Operations をアンインストールし、可能な限りクラスターをオンラインに保ちましょう。 リソースグループを先に削除すると、孤立したリソースがクラスタに残り、後の展開が失敗する可能性があります。

次のステップ