你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
管理 Azure IoT 操作实例的生命周期
使用 Azure CLI 和 Azure 门户管理、卸载或更新 Azure IoT 操作实例。
先决条件
部署到群集的 Azure IoT 操作实例。 有关详细信息,请参阅部署 Azure IoT 操作。
已在开发计算机上安装的 Azure CLI。 此场景需要 Azure CLI 2.64.0 或更高版本。 如有必要,请使用az --version
检查版本,使用az upgrade
进行更新。 有关详细信息,请参阅 如何安装 Azure CLI。
适用于 Azure CLI 的 Azure IoT 操作扩展。 使用以下命令添加扩展或将其更新到最新版本:
az extension add --upgrade --name azure-iot-ops
管理
部署后,可以使用 Azure CLI 和 Azure 门户查看和管理 Azure IoT 操作实例。
列出实例
- 在 Azure 门户中,搜索并选择“Azure IoT 操作”。
- 使用筛选器根据订阅、资源组等查看 Azure IoT 操作实例。
使用 az iot ops list
命令查看订阅或资源组中的所有 Azure IoT 操作实例。
基本命令将返回订阅中的所有实例。
az iot ops list
若要按资源组筛选结果,请添加 --resource-group
参数。
az iot ops list --resource-group <RESOURCE_GROUP>
查看实例
可以在 Azure 门户中查看 Azure IoT 操作实例。
在 Azure 门户中,转到包含 Azure IoT 操作实例的资源组,或搜索并选择“Azure IoT 操作”。
选择 Azure IoT 操作实例的名称。
在实例的“概述”页面上,“Arc 扩展”表会显示已部署到群集的资源。
使用 az iot ops show
命令查看实例的属性。
az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>
还可以使用 az iot ops show
命令在 Azure CLI 中查看 Azure IoT 操作部署中的资源。 添加 --tree
标志以显示包含指定 Azure IoT 操作实例的部署的树状视图。
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 操作组件的运行状况和配置。 默认情况下,该命令会检查 MQ,但可以使用 --ops-service
参数指定服务。
在 Azure 门户中,转到包含 Azure IoT 操作实例的资源组,或搜索并选择“Azure IoT 操作”。
选择 Azure IoT 操作实例的名称。
在实例的“概述”页上,选择“添加标记”或“编辑”以修改实例上的标记。
使用 az iot ops update
命令编辑 Azure IoT 操作实例的标记和说明参数。 update
命令中提供的值将替换任何现有标记或说明
az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --desc "<INSTANCE_DESCRIPTION>" --tags <TAG_NAME>=<TAG-VALUE> <TAG_NAME>=<TAG-VALUE>
若要删除实例上的所有标记,请将标记参数设置为 null 值。 例如:
az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""
管理组件
每个 Azure IoT 操作实例都包含多个组件,例如 MQTT 代理、OPC UA 连接器和数据流。 若要详细了解如何管理这些组件,请参阅各自的文章。 例如,若要管理 MQTT 代理,请从代理概述开始。
(预览版)使用 Kubernetes 部署清单管理组件
通常,Azure IoT 操作使用 Azure Arc 平台提供混合云体验,可在其中通过 Azure 资源管理器 (ARM) 和前端工具(如 Azure 门户、Bicep 和 Azure CLI)管理配置。
但是,还可以使用 YAML Kubernetes 部署清单管理 Azure IoT 操作的组件。 这意味着可以使用 kubectl
等工具来管理 Azure IoT 操作的某些组件。 此功能以预览版提供,存在一些限制:
卸载
Azure CLI 和 Azure 门户提供了用于卸载 Azure IoT 操作的不同选项。
Azure 门户步骤可以删除 Azure IoT 操作实例,但无法影响部署中的相关资源。 如果要删除整个部署,请使用 Azure CLI。
在 Azure 门户中,转到包含 Azure IoT 操作实例的资源组,或搜索并选择“Azure IoT 操作”。
选择 Azure IoT 操作实例的名称。
在实例的“概述”页上,选择“删除”。
查看此操作中已删除和未删除的资源列表,然后键入实例的名称并选择“删除”进行确认。
使用 az iot ops delete 命令删除群集中的整个 Azure IoT 操作部署。 delete
命令会评估群集上的 Azure IoT 操作相关的资源,并显示要删除的资源的树视图。 运行此命令时,群集应为联机状态。
delete
命令简化了将 Azure IoT 操作重新部署到同一群集的过程。 它会撤消 create
命令,以便可以再次运行 create
、delete
、create
等,而无需重新运行 init
。
delete
命令会删除:
- Azure IoT 操作实例
- Arc 扩展
- 自定义位置
- 资源同步规则
- 可以在 Azure IoT 操作解决方案中配置的资源,例如资产、MQTT 代理和数据流。
az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>
若要删除实例并删除 Azure IoT 操作依赖项(init
的输出),请添加标志 --include-deps
。
az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps