你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

教程：使用 Ubuntu Server 22.04 x64 包代理的 Azure IoT 中心的设备更新

项目
11/01/2024

Device Update for Azure IoT Hub 支持基于映像、包和脚本的更新。

基于包的更新是有针对性的更新，只改变设备上的特定组件或应用程序。它们将降低带宽的消耗，并有助于减少下载和安装更新的时间。基于包的更新通常还可以在应用更新时减少设备的停机时间，并避免创建映像的开销。它们使用 APT 清单，该清单为设备更新代理提供从指定存储库中下载和安装 APT 清单文件中指定的包（及其依赖项）所需的信息。

本教程指导你使用设备更新包代理来更新 Ubuntu Server 22.04 x64 上的 Azure IoT Edge。尽管本教程演示如何安装 Microsoft Defender for IoT，但通过类似的步骤也可以更新其他包，例如 IoT Edge 本身或它使用的容器引擎。

即使你计划使用其他 OS 平台配置，本教程中的工具和概念仍然适用。完成对端到端更新过程的介绍。然后选择你喜欢的更新操作系统平台的形式，深入了解详细信息。

本教程介绍以下操作：

下载并安装设备更新代理及其依赖项。
将标记添加到设备。
导入更新。
部署包更新。
监视更新部署。

先决条件

创建 Device Update 帐户和实例（如果尚未这样做）。配置 IoT 中心。
你需要 IoT Edge 设备的连接字符串。
如果使用模拟器代理教程进行了先前的测试，请运行以下命令以调用 APT 处理程序并部署本教程中的无线包更新：
```
sudo /usr/bin/AducIotAgent --register-content-handler /var/lib/adu/extensions/sources/libmicrosoft_apt_1.so --update-type 'microsoft/apt:1'
```

准备设备

使用“自动部署到 Azure”按钮

为方便起见，本教程使用基于 cloud-init 的 Azure 资源管理器模板来帮助你快速设置 Ubuntu 22.04 LTS VM（虚拟机）。这将同时安装 Azure IoT Edge 运行时和设备更新包代理。然后，它使用你提供的 IoT Edge 设备（先决条件）的设备连接字符串，使用预配信息自动配置设备。资源管理器模板还避免了启动 SSH 会话来完成设置的需要。

要开始，请选择以下按钮：

。
填写可用的文本框：
- 订阅：要将虚拟机部署到的活动 Azure 订阅。
- 资源组：用于包含该虚拟机及其相关资源的现有或新建的资源组。
- 区域：要将虚拟机部署到的地理区域。此值默认为所选资源组的位置。
- DNS 标签前缀：必需的值，用作虚拟机主机名的前缀。
- 管理员用户名：一个用户名，将为其提供对部署的 root 特权。
- 设备连接字符串：在所需 IoT 中心内创建的设备的设备连接字符串。
- VM 大小：要部署的虚拟机的大小
- Ubuntu OS 版本：要在基础虚拟机上安装的 Ubuntu OS 版本。保持默认值不变，因为它已设置为 Ubuntu 22.04-LTS。
- 身份验证类型：根据你的喜好选择 sshPublicKey 或 password。
- 管理员密码或密钥：SSH 公钥的值或密码的值，具体取决于所选的身份验证类型。
填写完所有复选框后，选中页面底部的复选框以接受条款。选择“购买”以开始部署。
验证部署是否已成功完成。在部署完成后，留出几分钟用于安装后和配置，以完成安装 IoT Edge 和设备包更新代理。

虚拟机资源应会部署到所选的资源组中。记下计算机名称，其格式为 vm-0000000000000。另请注意关联的 DNS 名称，其格式为 <dnsLabelPrefix>.<location>.cloudapp.azure.com。

可以从 Azure 门户中新部署的虚拟机的“概述”部分获取 DNS 名称。

提示

设置后若要通过 SSH 连接到此 VM，请在以下命令中使用关联的“DNS 名称”：ssh <adminUsername>@<DNS_Name>。

在 VM 上安装设备更新代理。

sudo apt-get install deviceupdate-agent

打开配置详细信息（请参阅如何使用以下命令在此处设置配置文件。将 connectionType 设置为“AIS”，将 connectionData 设置为空字符串。请注意，必须设置所有带有“将值置于此处”标记的值。请参阅配置设备更新代理。
```
sudo nano /etc/adu/du-config.json
```

重启 Device Update 代理。

sudo systemctl restart deviceupdate-agent

Device Update for Azure IoT Hub 软件包受以下许可条款的约束：

在使用程序包之前，请阅读许可条款。安装和使用包即表示你接受这些条款。如果你不同意许可条款，请不要使用该包。

将标记添加到设备

登录 Azure 门户并转到 IoT 中心。
在左侧窗格的“设备”下，找到你的 IoT Edge 设备并转到设备孪生或模块孪生。
在 Device Update 代理模块的“模块孪生”中，通过将现有 Device Update 标记值设置为 null 来删除这些标记。如果在设备更新代理中使用设备标识，请在“设备孪生”中进行这些更改。
按如下所示添加新的 Device Update 标记值：
```
    "tags": {
        "ADUGroup": "<CustomTagValue>"
    },
```
此屏幕截图显示了需要在孪生体中添加标记的部分。

导入更新

在 GitHub 中转到“设备更新版本”，然后选择“资产”下拉列表。选择它以下载 Tutorial_IoTEdge_PackageUpdate.zip。提取文件夹的内容，以发现一个示例 APT 清单 (sample-defender-iot-apt-manifest.json) 及其相应的导入清单 (sample-defender-iot--importManifest.json)。
登录到 Azure 门户并转到具有设备更新的 IoT 中心。在左窗格的“自动设备管理”下，选择“更新”。
选择“更新”选项卡。
选择“+ 导入新更新”。
选择“+ 从存储容器中选择”。选择一个现有帐户，或使用“+ 存储帐户”创建一个新帐户。然后选择现有容器，或者使用“+ 容器”创建新容器。此容器将用于暂存更新文件以供导入。

备注

建议每次导入更新时都使用新容器，以避免意外地从以前的更新导入文件。如果不使用新容器，请务必在完成此步骤之前删除现有容器中的任何文件。
在容器中，选择“上传”并转到在步骤 1 中下载的文件。选择所有更新文件后，选择“上传”。然后选择“选择”按钮以返回到“导入更新”页。

此屏幕截图显示了导入步骤。文件名可能与示例中使用的名称不匹配。
在“导入更新”页上，查看要导入的文件。然后选择“导入更新”以启动导入过程。
导入过程开始后，屏幕切换到“导入历史记录”部分。当“状态”列指示导入成功时，选择“可用更新”标题。现在应会在列表中看到导入的更新。

有关导入过程的详细信息，请参阅将更新导入到 Device Update。

查看设备组

Device Update 使用组来组织设备。 Device Update 根据设备的分配标记和兼容性属性自动将设备分组。每个设备仅属于一个组，但组可以有多个子组来对不同的设备类进行排序。

转到页面顶部的“组和部署”选项卡。
查看组列表和更新合规性图表。更新合规性图表显示了处于各种合规性状态的设备的计数：“最新的更新”、“可用的新更新”和“正在进行的更新”。了解更新合规性。
应会看到一个设备组，其中包含在本教程中设置的模拟设备，以及新组中设备的任何可用更新。如果设备不满足组的设备类要求，它们将显示在相应的无效组中。若要从此视图中将最佳可用更新部署到新的用户定义组，请选择组旁边的“部署”。

有关标记和组的详细信息，请参阅管理设备组。

部署更新

创建组后，你应该会看到新的更新可用于你的设备组，并在最佳更新下显示该更新的链接。可能需要刷新一次。

有关合规性的详细信息，请参阅 Device Update 合规性。
通过选择组名称来选择目标组。你将转到“组基本信息”下的组详细信息。
要启动部署，请前往“当前部署”选项卡。在“可用更新”部分，选择所需更新旁边的“部署”链接。给定组的最佳可用更新将以“最佳”高亮表示。
计划你的部署，以便立即开始部署或在将来开始部署。然后选择“创建”。

提示

默认情况下，开始日期和时间距当前时间 24 小时。如果你希望部署更早开始，请务必选择其他日期和时间。
在“部署详细信息”下，“状态”变为“活动”。已部署的更新标有“(正在部署)”。
查看合规性图表以了解更新是否现在正在进行。
成功更新设备后，你会看到合规性图表和部署详细信息也会更新，以反映相同的情况。