你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
了解如何将 Azure IoT作部署升级到较新版本。
先决条件
- 拥有有效订阅的 Azure 帐户。 如果没有帐户，可以创建 一个免费帐户。
- Azure CLI 2.53.0 或更高版本。 如有必要，请使用
az --version检查版本，使用az upgrade进行更新。 有关详细信息，请参阅 Azure CLI 入门。
了解升级支持
Azure IoT Operations 版本可以是预览版或正式版（GA），可以在 Azure IoT Operations 版本 文档中找到最新版本。 Azure IoT Operations CLI 扩展版本绑定到 Azure IoT作版本，因此需要确保已安装正确的 CLI 扩展版本来执行升级。
Azure IoT 操作支持以下升级场景：
- 可以将现有的 Azure IoT 操作实例升级到同一次要版本的任何补丁，或升级到下一个次要版本。
- 不能在版本之间降级。 若要回退到旧版本，请卸载 Azure IoT 操作 并重新安装所需的版本。
- 无法从任何预览版升级到正式版。 需要卸载 Azure IoT 操作应用程序 并重新安装新版本。
- 无法从任何 GA 版本升级到预览版。 有关如何安装预览版的详细信息，请参阅 升级到预览版。
注释
Azure IoT 操作不支持实时升级。 请预计升级过程中会有一些停机时间。
升级
Azure IoT 操作支持在新的正式版发布后将实例升级到这些版本。 如果 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 Operations 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 操作时，可以使用 参数在 --broker-backend-rf 命令中指定要创建的后端副本数量。
支持的版本
Microsoft 始终同时支持三个通常可用 (GA) 的 Azure IoT 操作版本：最新版本和之前的两个次要版本。
目前，只有两个次要版本可用。 Azure 支持 目前适用于以下版本：
重要
以前的次要版本不会收到安全修补程序。 始终升级到最新版本，以确保具有最新的安全更新和功能。
若要验证当前版本，请参阅 Azure 门户中 Azure IoT作实例的概述页，或使用 Azure IoT Operations CLI az iot ops instance show 命令。