共用方式為


將裝置和群組從公開預覽移轉至公開預覽更新版本

當 IoT 中樞的裝置更新服務發行新版本時,您要想要更新裝置以取得最新功能和安全性改善。 本文提供如何從 公開預覽版本 移轉至目前 公開預覽重新整理 (PPR) 版本的相關信息。 本文也會說明這些發布版本中的群組和用戶體驗(UX)行為。 如果您沒有使用公開預覽版本的裝置、群組和部署,您可以忽略此頁面。

若要成功移轉,您必須升級在裝置上執行的 DU 代理程式。 您也必須建立新的裝置群組,才能部署和管理更新。 請注意,由於 PPR 版本有重大變更,建議您密切關注指示,以避免發生錯誤。

更新裝置更新代理程式

針對公開預覽重新整理版本,裝置更新代理程式必須手動更新,如下所述。 由於公開預覽和 PPR 版本發生重大變更,因此不支援透過裝置更新部署更新代理程式。

  1. 若要使用舊版代理程式(0.7.0/0.6.0 版)和 2022 年 02 月 3 日之前建立的群組來檢視裝置,請流覽至可透過橫幅存取的公開預覽入口網站。

    橫幅的螢幕快照。

  2. 在 Azure 入口網站上建立新的 IoT/IoT Edge 裝置。 從裝置檢視複製裝置的主要連接字串,以供稍後使用。 如需詳細資訊,請參閱 將裝置新增至IoT中樞 一節。

  3. 然後,透過 SSH 連線到您的裝置,並移除任何舊的裝置更新代理程式。

    sudo apt remove deviceupdate-agent 
    sudo apt remove adu-agent 
    
  4. 拿掉舊的組態檔

    sudo rm -f /etc/adu/adu-conf.txt 
    
  5. 安裝新的代理程式

    sudo apt-get install deviceupdate-agent 
    

    或者,您可以從 GitHub 取得.deb資產並安裝代理程式

    sudo apt install <file>.deb
    

    嘗試升級裝置更新代理程式而不移除舊的代理程式和組態檔會導致下列錯誤。

    更新錯誤的螢幕快照。

  6. 執行下列命令,以在組態檔中輸入IoT裝置的主要連接字串(或模組,視您使用 裝置更新布建裝置的方式而定)。

    sudo nano /etc/adu/du-config.json
    
  7. 在組態檔中新增您的模型、製造商、代理程式名稱、連線類型和其他詳細數據

  8. 從公開預覽入口網站刪除舊的IoT/IoT Edge裝置。

備註

嘗試透過 DU 部署更新代理會導致該裝置無法再由 Device Update 服務管理。 裝置必須重新佈建,才能從 Device Update 服務進行管理。

將群組移轉至公開預覽重新整理

  1. 如果您的裝置使用裝置更新代理程式 0.6.0 或 0.7.0 版,請依照上述步驟升級至最新的代理程式版本 0.8.0。

  2. 請透過導覽列刪除公開預覽入口中的現有群組。

  3. 將群組標籤添加到已更新設備的雙重對應項中。 如需詳細資訊,請參閱 將標籤新增至您的裝置一 節。

  4. 移至 [新增群組],然後從下拉式清單中選取對應的群組標籤,以在 PPR 入口網站中重新建立群組。

  5. 請注意,如果未刪除公開預覽入口網站中的群組,則無法在 PPR 入口網站中建立具有相同名稱的群組。

跨版本群組和部署行為

  • 在公開預覽重新整理發行入口網站中建立的群組只允許新增具有最新裝置更新代理程式 (0.8.0) 的裝置。 具有舊版代理程式 (0.7.0/0.6.0) 的裝置無法新增至這些群組。

  • 任何使用最新代理程式的新裝置都會自動新增至 [群組和部署] 索引標籤中的 [預設 DeviceClass 群組]。如果群組標籤已新增至裝置屬性,則如果該標籤的群組存在,裝置將會新增至該群組。

  • 對於使用最新代理程式的裝置,如果群組卷標已新增至裝置屬性,但尚未建立對應的群組,裝置將不會顯示在 [群組和部署] 索引卷標中。

  • 如果未新增群組標籤,使用舊版代理程式的裝置將會在舊入口網站中顯示為未分組。

後續步驟

了解裝置更新代理程式配置檔

您可以使用下列教學課程來簡單示範 IoT 中樞的裝置更新: