物联网设备更新（Device Update for IoT）相关技术咨询

一、OTA 更新部署步骤 #

• 确保设备联网且能正常连接到设备更新服务端点
• 在设备更新服务中创建目标设备组，将需更新的设备纳入该组
• 上传已验证的更新内容（镜像/包）到服务存储容器，并关联对应更新清单
• 创建部署任务，选择目标设备组和指定的更新版本
• 触发部署后，监控设备端 Device Update Agent 日志，确认下载、安装流程启动
• 验证更新结果：检查设备软件/镜像版本是否更新，设备运行状态正常

二、问题解答 #

1. 将 du.config.json 从连接字符串改为证书认证 #

• 在设备上准备好受服务信任的客户端证书（含私钥）
• 编辑 du.config.json，移除 connectionString 项，添加证书认证配置：

  "authentication": {
    "type": "certificate",
    "certificatePath": "/path/to/client-cert.pem",
    "privateKeyPath": "/path/to/client-key.pem",
    "caCertificatePath": "/path/to/ca-cert.pem" // 可选，自定义CA证书路径
  }
  

• 重启 Device Update Agent 服务使配置生效
• 查看 Agent 日志，确认设备已通过证书认证连接服务

2. 配置 Device Update Agent 同时支持镜像与包更新 #

• 确保 Agent 已安装镜像更新处理程序（如 OSTree 处理程序）和包更新处理程序（如 APT/RPM 处理程序）
• 检查 /etc/adu/handlers 目录，确认对应处理程序二进制文件存在且有可执行权限
• 编辑 du-config.json，在 supportedUpdateTypes 中添加两种更新类型：

  "supportedUpdateTypes": [
    "microsoft/update:1",
    "microsoft/ostree:1"
  ]
  

• 重启 Agent 服务加载所有处理程序
• 分别部署镜像和包更新，验证两种类型均能被正常识别执行

3. 解决 APT 文件解析失败错误（ADUC_ERC_UPDATE_CONTENT_HANDLER_PARSE_BAD_FORMAT） #

你提供的清单缺少APT更新所需的关键字段，调整后的正确格式示例：

{
  "name": "Contoso-Video",
  "version": "1.7.8",
  "updateType": "microsoft/apt:1",
  "packages": [
    {
      "name": "azure-iotedge",
      "version": "1.4.20" // 必须指定具体版本号
    }
  ],
  "agentRestartRequired": false
}

• 明确指定 updateType 为 microsoft/apt:1
• 每个包项必须包含 version 字段，APT处理程序依赖该字段解析
• 重新上传调整后的清单和更新内容，创建新部署任务
• 查看 Agent 日志确认解析错误消除，更新流程正常执行

内容的提问来源于stack exchange，提问作者Yogesh Amrutkar