使用 Azure CLI 和 Azure 入口網站來管理、解除安裝或更新 Azure IoT 操作執行個體。
先決條件
部署至叢集的 Azure IoT 操作執行個體。 如需詳細資訊,請參閱 部署 Azure IoT 作業。
在您的開發電腦上安裝 Azure CLI。 此案例需要 Azure CLI 2.53.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 操作執行個體。
檢視執行個體
您可以在 Azure 入口網站中檢視 Azure IoT 操作執行個體。
在 Azure 入口網站中,移至包含 Azure IoT 作業實例的資源群組,或搜尋並選取 [Azure IoT 作業]。
選取 Azure IoT 操作執行個體的名稱。
在實例的 [ 概觀 ] 頁面上,您可以看到實例的屬性。 例如,您可以查看 連接器的狀態,可以啟用或停用。 若要變更連接器的狀態,請按一下 [編輯]。
此動作會開啟組態面板,您可以在其中啟用或停用 ONVIF 的連接器。
[ 資源摘要] 索引標籤會顯示已部署至叢集的資源。
檢視 Azure 裝置登錄
在 Azure 入口網站中,您可以檢視 Azure 裝置登錄,這是連線到 Azure IoT 作業執行個體之所有裝置和資產的集合。
Azure 裝置登錄會使用 命名空間 來組織資產和裝置。 每個 Azure IoT 作業實例都會針對其資產和裝置使用單一命名空間。 多個實例可以共用單一命名空間。
若要在 Azure 入口網站中檢視 Azure 裝置登錄中的專案:
在 Azure 入口網站中,搜尋並選取 [Azure 裝置登錄]。 「 概觀 」頁面摘要說明訂閱中的資產、結構描述登錄和命名空間的數量:
使用 [資產] 頁面來檢視 Azure Device Registry 中的資產。 根據預設, 「資產」 頁面會顯示訂閱中所有命名空間中的資產。 使用篩選器來檢視資產的子集,例如特定命名空間或資源群組中的資產:
使用 [結構描述登錄 ] 頁面來檢視 Azure Device Registry 中的結構描述登錄。 根據預設,「 結構描述登錄」 頁面會顯示訂閱中所有命名空間中的結構描述登錄。 使用篩選器來檢視綱目登錄的子集,例如特定命名空間或資源群組中的綱目登錄:
使用 [ 命名空間 ] 頁面來檢視 Azure Device Registry 中的命名空間。 根據預設, 「命名空間 」頁面會顯示訂閱中的命名空間。 使用篩選器來檢視命名空間的子集,例如特定資源群組中的名稱空間。 從此頁面,您可以建立新的命名空間,或檢視現有命名空間的詳細資料:
您也可以檢視資源群組中現有命名空間的詳細數據,其中包含 Azure IoT 作業執行個體。 例如,下列螢幕擷取畫面顯示與 aio-131235032 Azure IoT 作業實例相關聯的 adr-namespace 資源:
上一個螢幕擷取畫面也顯示 Azure 裝置登錄中的其他資源,例如 IoT 結構描述登錄、 IoT 命名空間資產,以及包含 Azure IoT 作業執行個體之資源群組內容中的 裝置 。
將資產 (傳統) 移轉至資產
如果您的 Azure IoT 作業執行個體中有想要移至命名空間的現有資產,您可以使用命令 az iot ops migrate-assets 。 此命令會將根層級資產 (傳統) 移轉至 Azure Device Registry 中的資產。
備註
移轉資產需要 Azure IoT Operations 執行個體 1.2.36 版或更新版本。
目標資產集 (傳統) 會轉換成對等的資產表示法,並取代原始根層級資產 (傳統)。 在移轉期間,裝置會在根資產所參考的端點設定檔就地建立。 如果多個資產參考相同的端點設定檔,則移轉的資產只會參考一個裝置。
若要移轉與執行個體相關聯的所有根資產,請執行下列命令:
az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>
若要移轉與執行個體相關聯的特定根資產,請執行下列命令:
az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --pattern <ASSET_ID_1> <ASSET_ID_2> <ASSET_ID_3>
若要移轉與符合 glob 樣式模式之執行個體相關聯的所有根資產,請執行下列命令:
az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --pattern asset-pl-* asset-eng?-01
這很重要
在移轉資產之前,請務必使用 az iot ops clone 命令拍攝執行個體的快照。 這可讓您視需要將執行個體還原至先前的狀態。 如需詳細資訊,請參閱 建立 IoT Operations 範例。
移轉完成後,您可以使用 az iot ops ns asset 和 az iot ops ns device 命令來管理 Azure IoT 作業執行個體中的資產和裝置。
設定連接器範本
在 Azure 入口網站中,您可以設定 Azure IoT 作業執行個體的 連接器範本 。 連接器範本會定義部署至叢集的連接器組態,例如 OPC UA 的連接器。 當您建立連接器範本時,它可讓 OT 使用者在作業體驗 Web UI 中建立使用連接器類型的裝置。
若要深入瞭解連接器範本,請參閱 部署 ONVIF 的連接器。
管理執行個體元件
每個 Azure IoT 操作執行個體都包含數個元件,例如 MQTT 代理程式、OPC UA 的連接器,以及資料流。 若要深入了解如何管理這些元件,請參閱其各自的文章。 例如,若要管理 MQTT 訊息代理程式,請從 Broker 概觀開始。
使用 Kubernetes 部署清單管理元件(預覽)
一般而言,Azure IoT 操作會使用 Azure Arc 平台來提供混合式雲端體驗,您可以在其中透過 Azure Resource Manager (ARM) 和前端工具如 Azure 入口網站、Bicep 和 Azure CLI 來管理設定。
不過,您也可以使用 YAML Kubernetes 部署資訊清單來管理 Azure IoT 操作的元件。 這表示您可以使用 kubectl 之類的工具來管理 Azure IoT 操作的某些元件。 這項功能處於預覽狀態,且具有一些限制:
- 只有某些元件支援使用 Kubernetes 部署資訊清單。 這些元件是 MQTT 訊息代理程式和數據流。 其他元件,例如 OPC UA 和 Akri 服務的連接器不支援此功能。
- 除非您使用命令在
az iot ops enable-rsyncAzure IoT 作業中啟用資源同步處理,否則使用 Kubernetes 部署資訊清單對資源所做的變更不會同步至 Azure。 若要深入瞭解資源同步,請參閱 資源同步處理。 - 即使已啟用資源同步處理,使用 Kubernetes 部署資訊清單建立的新資源也不會同步處理至 Azure。 只會同步處理現有資源的變更。
更新實例和組態
在 Azure 入口網站中,移至包含 Azure IoT 作業實例的資源群組,或搜尋並選取 [Azure IoT 作業]。
選取 Azure IoT 操作執行個體的名稱。
在執行個體的 [概觀] 頁面上,選取 [新增標籤] 或 [編輯] 以修改執行個體上的標籤。
解除安裝
Azure IoT Operations CLI 和 Azure 入口網站提供不同選項來卸載 Azure IoT 作業。
這很重要
如果您想要清除叢集和資源群組,建議您先使用下一節中的 Azure IoT Operations CLI 命令,從叢集中移除 Azure IoT 作業。 然後,您可以刪除資源群組。 直接刪除資源群組會讓孤立的資源留在叢集上。
在 Azure 入口網站中,移至包含 Azure IoT 作業實例的資源群組,或搜尋並選取 [Azure IoT 作業]。
選取 Azure IoT 操作執行個體的名稱。
在實例的 [ 概觀] 頁面上,選取 [ 刪除]。
檢閱在此操作中刪除和未刪除的資源清單,然後輸入執行個體的名稱,並選取 [刪除] 以確認。
備註
刪除 Azure 入口網站中的 Azure IoT 作業實例並不會移除部署 Azure IoT 作業時所建立的相依性。 若要移除這些相依性,請使用 az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps Azure CLI 程式中所述的命令。