管理 Azure IoT 作業實例的生命週期

發行項
11/20/2024

使用 Azure CLI 和 Azure 入口網站來管理、卸載或更新 Azure IoT 作業實例。

必要條件

部署至叢集的 Azure IoT 作業實例。如需詳細資訊，請參閱部署 Azure IoT Orchestrator。
在您的開發電腦上安裝 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 CLI

您可以在 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 CLI

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

若要刪除執行個體上的所有標籤，請將 tags 參數設定為 null 值。例如：

az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""

管理元件

每個 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 create --enable-rsync啟用資源同步處理來部署 Azure IoT 作業，否則使用 Kubernetes 部署指令清單對資源的變更不會同步處理至 Azure。若要深入瞭解資源同步，請參閱資源同步處理。
即使已啟用資源同步處理，使用 Kubernetes 部署指令清單建立的新資源也不會同步處理至 Azure。只會同步處理現有資源的變更。

解除安裝

Azure CLI 和 Azure 入口網站會提供不同選項供您解除安裝 Azure IoT 操作。

Azure 入口網站步驟可以刪除 Azure IoT 作業實例，但不會影響部署中的相關資源。如果您想要刪除整個部署，請使用 Azure CLI。

Azure 入口網站
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

共用方式為