共用方式為


將裝置和群組從公開預覽版移轉至公開預覽版重新整理

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

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

更新裝置更新代理程式

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

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

    螢幕擷取畫面:橫幅。

  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 部署來更新代理程式,將會導致裝置更新無法再管理裝置。 裝置必須重新進行佈建,才能從裝置更新進行管理。

將裝置移轉至公開預覽版重新整理

  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 中樞裝置更新的簡單示範,您可以使用下列教學課程: