教程：使用 Azure IoT 中心的设备更新完成代理更新

2022-01-26

如果尚未这样做，请查看将代理更新与 Azure IoT 中心的设备更新配合使用。

设置测试设备或虚拟机

本教程以 Ubuntu Server 18.04 LTS 虚拟机（VM）为例。

安装设备更新代理和依赖项

在 APT 包存储库中完成 packages.microsoft.com 的注册。

sudo apt-get update

sudo apt install curl

curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ~/microsoft-prod.list

sudo cp ~/microsoft-prod.list /etc/apt/sources.list.d/

curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > ~/microsoft.gpg

sudo cp ~/microsoft.gpg /etc/apt/trusted.gpg.d/

sudo apt-get update

在 IoT 设备上安装 deviceupdate-agent。从 packages.microsoft.com下载最新的 Device Update Debian 文件：
```
sudo apt-get install deviceupdate-agent
```
或者，将下载的 Debian 文件复制到测试 VM。如果在计算机上使用 PowerShell，请运行以下 shell 命令：
```
  scp <path to the .deb file> tester@<your vm's ip address>:~
```
然后远程连接到 VM，并在 home 文件夹中运行以下 shell 命令：
```
      #go to home folder 
      cd ~
      #install latest Device Update agent
      sudo apt-get install ./<debian file name from the previous step>
```
转到 Azure IoT 中心，复制 IoT 设备的设备更新模块的主连接字符串。将 connectionData 字段的任何默认值替换为 du-config.json 文件中的主连接字符串：
```
   sudo nano /etc/adu/du-config.json  
```
注释

可以改为复制设备的主连接字符串，但我们建议使用设备更新模块的字符串。有关设置模块的信息，请参阅设备更新代理预配。

确保 /etc/adu/du-diagnostics-config.json 包含日志收集的正确设置。例如：

{
  "logComponents":[
    {
      "componentName":"adu",
       "logPath":"/var/log/adu/"
    },
    {
      "componentName":"do",
      "logPath":"/var/log/deliveryoptimization-agent/"
    }
  ],
  "maxKilobytesToUploadPerLogPath":50
}

重启设备更新代理：
```
sudo systemctl restart adu-agent
```

设置模拟组件

为了进行测试和演示，我们将在设备上创建以下模拟组件：

三个电机
两个相机
“hostfs”
“rootfs”

重要

上述组件配置基于名为 libcontoso-component-enumerator.so的示例组件枚举器扩展的实现。它还需要此模拟组件清单数据文件：/usr/local/contoso-devices/components-inventory.json。

将演示文件夹复制到测试 VM 上的主目录。然后运行以下命令，将所需的文件复制到正确的位置：
```
`~/demo/tools/reset-demo-components.sh` 
```
reset-demo-components.sh 命令代表你执行以下步骤：
1. 它将复制 components-inventory.json 并将其添加到 /usr/local/contoso-devices 文件夹中。
2. 它将 Contoso 组件枚举器扩展（libcontoso-component-enumerator.so）从 Assets 文件夹复制，并将其添加到 文件夹的 /var/lib/adu/extensions/sources。
3. 它注册了扩展：
```
sudo /usr/bin/AducIotAgent -E /var/lib/adu/extensions/sources/libcontoso-component-enumerator.so
```
使用以下命令设置 VM 以支持代理更新，查看和记录当前组件的软件版本：
```
~/demo/show-demo-components.sh
```

导入示例更新

如果尚未执行此作，请创建设备更新帐户和实例，包括配置 IoT 中心。然后启动以下过程。

从最新的设备更新版本中，在资产下下载代理更新的导入清单和镜像。
登录到 Azure 门户并转到具有设备更新的 IoT 中心。在左窗格中，选择 设备管理>更新。
选择“汇报”选项卡。
选择“+ 导入新更新 (Import New Update)”。
选择 + 从存储容器中进行选择，然后选择存储帐户和容器。
选择上传以添加在步骤 1 中下载的文件。
将父导入清单、子导入清单和有效负载文件上传到您的容器。

以下示例展示了上传的样本文件，用于更新连接到智能吸尘器设备的相机。它还包括预安装脚本，用于在无线更新之前关闭相机。

在此示例中，父导入清单 contoso.Virtual-Vacuum-virtual-camera.1.4.importmanifest.json。更新相机详情的子导入清单为 Contoso.Virtual-Vacuum.3.3.importmanifest.json。请注意，这两个清单文件名都遵循所需的格式，以 .importmanifest.json结尾。
选择选择。
UI 现在显示将导入到设备更新的文件列表。选择 导入更新。
导入过程开始，屏幕将更改为 导入历史记录 部分。选择刷新以查看进度，直到导入过程完成。根据更新的大小，导入可能需要几分钟或更长时间才能完成。
当状态列指示导入已成功时，请选择 可用更新 选项卡。现在应会在列表中看到导入的更新。

了解有关导入更新的详细信息。

创建更新组

转到页面顶部的“组和部署”选项卡。
选择“添加组”按钮以创建新组。
从列表中选择 IoT 中心标记和设备类，然后选择“创建组”。
创建组后，你将看到更新符合性图表和组列表已被更新。更新符合性图表显示处于各种符合性状态的设备计数：最新更新、可用的新更新和正在进行的更新。了解更新符合性。
你应该可以看到你新创建的组以及新组中设备的任何可用更新。如果存在不符合该组设备类别要求的设备，它们将显示在相应的无效设备组中。可以通过单击组旁边的“部署”按钮，从此视图中将最佳可用更新部署到新的用户定义的组。