將裝置和群組移轉至 IoT 中樞裝置更新發行版本

發行項
05/10/2024

IoT 中樞裝置更新服務發行新版本時，您會想要更新裝置的最新功能和安全性增強功能。本文提供如何從 [公開預覽更新 (PPR) 發行版本] 移轉至最新 GA 發行版本的相關資訊。本文也說明這些發行版本的群組和 UX 行為。如果您沒有使用公開預覽更新發行版本的裝置、群組和部署，則可以忽略此頁面。

若要成功移轉，您將必須升級在裝置上執行的 DU 代理程式。請注意，因為 GA 發行版本有重大變更，建議您密切遵循指示以避免錯誤。

注意

所有建立的 PPR 裝置群組都會自動變更為 GA 群組。移轉之後，群組和裝置將可供使用。部署歷程記錄不會轉移至更新的 GA 群組。

更新裝置更新代理程式

針對 GA 發行版本，裝置更新代理程式可以手動更新，或使用 apt 資訊清單或映像更新的裝置更新服務來更新。如果您使用映像更新，可以在更新中包含 GA 裝置更新代理程式。

手動 DU 代理程式升級

更新裝置之前，裝置屬性將包含 PPR PnP 模型詳細資料。 合約模型名稱會顯示裝置更新模型 V1，而合約模型識別碼會顯示 dtmi:azure:iot:deviceUpdateContractModel;1。

透過 SSH 連線至您的裝置，並更新裝置更新代理程式。

sudo apt install deviceupdate-agent
sudo systemctl restart deviceupdate-agent
sudo systemctl status deviceupdate-agent

確認 DU 代理程式正在正確執行。尋找「HealthCheck 已通過」
```
sudo -u adu /usr/bin/AducIotAgent -h  
```
在裝置更新入口網站中查看更新的裝置。裝置屬性現在會顯示更新後的 PnP 模型詳細資料。合約模型名稱會顯示裝置更新模型 V2，合約模型識別碼會顯示 dtmi:azure:iot:deviceUpdateContractModel;2。

透過 APT 資訊清單升級 OTA DU 代理程式

更新裝置之前，裝置屬性將包含 PPR PnP 模型詳細資料。 合約模型名稱會顯示裝置更新模型 V1，而合約模型識別碼會顯示 dtmi:azure:iot:deviceUpdateContractModel;1。

將裝置更新代理程式升級新增為更新的最後一個步驟。匯入資訊清單版本必須是 "4.0"，以確保其以正確的裝置為目標。請參閱下列範例匯入資訊清單和 APT 資訊清單：

範例匯入資訊清單

{
   "manifestVersion": "4",
   "updateId": {
     "provider": "Contoso",
     "name": "Sensor",
     "version": "1.0"
   },
   "compatibility": [
     {
       "manufacturer": "Contoso",
       "model": "Sensor"
     }
   ],
   "instructions": {
     "steps": [
       {
     "handler": "microsoft/apt:1",
     "handlerProperties": {
       "installedCriteria": "1.0"
     },
     "files": [
       "fileId0"
     ]
       }
     ]
   },
   "files": {
     "fileId0": {
       "filename": "sample-upgrade-apt-manifest.json",
       "sizeInBytes": 210,
       "hashes": {
     "sha256": "mcB5SexMU4JOOzqmlJqKbue9qMskWY3EI/iVjJxCtAs="
       }
     }
   },
   "createdDateTime": "2022-08-20T18:32:01.8404544Z"
 }

範例 APT 資訊清單

  {
    "name": "Sample DU agent upgrade update",
    "version": "1.0.0",
    "packages": [
    {
        "name": "deviceupdate-agent"
    }
    ]
}

注意

代理程式升級必須是最後一個步驟。您可以在代理程式升級之前有其他步驟。新增在代理程式升級之後的任何步驟將無法正確執行並回報，因為裝置會與 DU 服務重新連線。

部署更新。
成功部署更新之後，裝置屬性現在會顯示更新後的 PnP 模型詳細資料。合約模型名稱會顯示裝置更新模型 V2，合約模型識別碼會顯示 dtmi:azure:iot:deviceUpdateContractModel;2。

跨發行版本的群組和部署行為

具有公開預覽重新整理 DU 代理程式 ( 0.8.x) 和 GA DU 代理程式 (1.0.x) 的裝置，可以透過裝置更新入口網站來管理。
具有舊版代理程式 (0.7.0/0.6.0) 的裝置無法新增至這些群組。

下一步

了解裝置更新代理程式設定檔

針對 IoT 中樞裝置更新的簡單示範，您可以使用下列教學課程：

共用方式為

將裝置和群組移轉至 IoT 中樞裝置更新發行版本

更新裝置更新代理程式

手動 DU 代理程式升級

透過 APT 資訊清單升級 OTA DU 代理程式

跨發行版本的群組和部署行為

下一步

意見反應

其他資源