了解如何將 Azure IoT 操作部署升級至較新的版本。
先決條件
- 具有有效訂閱的 Azure 帳戶。 如果您沒有帳戶，可以建立免費帳戶。
- Azure CLI 2.53.0 版或更新版本。 使用
az --version檢查您的版本，並用az upgrade視需要更新。 如需詳細資訊，請參閱開始使用 Azure CLI。
了解升級支援
Azure IoT 操作版本可能為預覽版或正式發行 (GA)，您可以在 Azure IoT 操作版本文件中找到最新版本。 Azure IoT 操作 CLI 延伸模組版本會繫結至 Azure IoT 操作版本，因此您必須確保已安裝正確的 CLI 延伸模組版本，才能執行升級。
Azure IoT 操作可支援下列升級案例：
- 您可以將現有的 Azure IoT 操作執行個體升級至相同次要版本的任何修補程式，或升級至下一個次要版本。
- 您無法在不同版本之間進行降級。 若要移至較舊版本，請將 Azure IoT 操作解除安裝，然後重新安裝所需的版本。
- 您無法從任何預覽版本升級至 GA 版本。 您需要解除安裝 Azure IoT 操作，然後重新安裝新版本。
- 您無法從任何 GA 版本升級至預覽版本。 如需如何安裝預覽版本的詳細資訊，請參閱升級至預覽版本。
備註
Azure IoT 作業不支持實時升級。 請在升級程式期間預期會有一些停機時間。
升級
Azure IoT 操作支援在新的 GA 版本發行時將執行個體升級至該 GA 版本。 如果您的 Azure IoT 操作執行個體符合升級資格，您可以使用 Azure 入口網站或 Azure CLI 來執行升級。
如果最新版本的 Azure IoT 操作處於預覽狀態，請參閱升級至預覽版本。
如果您的 Azure IoT 操作部署符合升級資格，Azure 入口網站會顯示 [升級] 選項。 如果您沒看到升級的選項，則您的部署處於最新版本。
在 Azure 入口網站中，瀏覽至您的 Azure IoT 操作執行個體。
在執行個體的 [概觀] 頁面上選取 [升級]。
您必須使用最新版的 Azure IoT 操作 CLI 延伸模組，以取得最新版的 Azure IoT 操作。 如果您未將延伸項目更新為必要條件的一部分，請立即進行。
az extension add --upgrade --name azure-iot-ops或者，如果您想要將部署升級至較新版本，但並非最新版本，請將 CLI 延伸模組版本設定為與 IoT 操作版本中所需 Azure IoT 操作版本相關聯的版本。
az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>入口網站會顯示 Azure CLI 命令來升級執行個體，並預先填入您的訂用帳戶、資源群組和執行個體詳細資料。 選取 CLI 命令旁的複製圖示。
執行複製的
az iot ops upgrade命令。升級命令成功完成之後，請重新整理執行個體以查看變更。
執行個體概觀頁面上顯示的 [版本] 值會反映 Azure IoT 操作執行個體的版本。 不過，如果必要的 Arc 延伸模組有可用的升級，系統可能會提示您升級。 如果 [升級] 選項從執行個體概觀頁面中消失 (即使看起來沒有什麼改變)，您可以判定升級是否成功。 您可以在 Azure 入口網站中已啟用 Arc 之叢集的 [延伸模組] 頁面上，檢查 Azure IoT 操作部署的 Arc 延伸模組版本。
升級至預覽版本
有時候最新版本的 Azure IoT 操作處於預覽狀態。 檢查 Azure IoT 操作版本，以查看最新版本。 在預覽版本期間，版本升級會遭到封鎖，您需要解除安裝 Azure IoT 操作並重新安裝預覽版本。
您只能使用 Azure CLI 安裝預覽版本。
如果您有現有的 Azure IoT 操作執行個體，您需要解除安裝 Azure IoT 操作，以進行新的部署。
使用
--allow-preview旗標新增最新版本的 Azure IoT 操作 CLI 延伸模組。az extension add --upgrade --name azure-iot-ops --allow-preview
如果您想要升級至非最新版的特定 Azure IoT 操作版本，您可以執行 az iot ops get-versions 或參考 IoT 作業版本，以尋找與您想要的 Azure IoT 操作版本相關聯的 CLI 延伸模組版本。 取得版本號碼，然後執行下列命令以升級至該版本：
az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>
MQTT 代理伺服器升級考慮
為了確保部署升級期間零數據遺失和高可用性，MQTT 訊息代理程式會在 MQTT 訊息代理程式 Pod 上實作滾動更新。 健康情況管理員 Pod 會協調 MQTT 代理程式 Pod 的增量升級流程，以確保：
- 使用者的連線仍維持不中斷。
- 飛行中的任何訊息將會被保留。
- 儲存在磁碟上的數據會在版本之間正確移轉。
如果在升級程式期間發生失敗，健康情況管理員 Pod 會自動重新啟動升級程式，同時確保不會遺失數據或連線。
只有當 MQTT 訊息代理程式部署有兩個以上的後端復本時，才會進行輪流更新。 單一複本部署不支援 MQTT 代理程式升級。 當您部署 Azure IoT 作業時，您可以使用 參數指定要在 az iot ops create 命令 --broker-backend-rf 中建立的後端復本數目。
支援的版本
Microsoft 隨時支援三個正式發行 （GA） 版本的 Azure IoT 作業：最新版本，以及先前的兩個次要版本。 此外，預覽版可用於測試新功能。
目前， Azure 支援 適用於下列版本：
| 版本 | 類型 | 目前修補程式 發布 （年月） |
水流 CLI 版本 |
發布說明 |
|---|---|---|---|---|
| 1.2.x | GA | 1.2.112 (2510) | 2.0.1 | 版本資訊 |
| 1.1.x | GA | 1.1.59 (2506) | 1.7.0 | 版本資訊 |
| 1.0.x | GA | 1.0.34 (2503) | 1.3.0 | 版本資訊 |
若要瞭解版本之間的升級，請參閱 升級至新版本。
這很重要
舊版次要版本不會收到安全性修補程式。 升級到最新版本以獲取最新的安全更新和功能。
警告
請勿在生產環境中使用預覽版本。
若要驗證您目前的版本，請移至 Azure 入口網站中 Azure IoT 作業執行個體的概觀頁面，或使用 Azure IoT 作業 CLI az iot ops instance show 命令。