執行個體遷移的最佳實務 - IoT Platform

物聯網平台提供執行個體遷移功能，可助您將舊版公用執行個體下產品、裝置和規則引擎資料移轉到企業版執行個體中使用。本文以某共用服務企業為例，介紹執行個體遷移的業務改造和遷移方案。

背景資訊

A公司的使用者共用服務平台，採用阿里雲物聯網提供的裝置管理能力，聚焦智慧園區、智慧校園等情境提供共用洗衣機、烘乾機、按摩椅等共用服務。

物聯網平台提供的企業版執行個體服務，與舊版公用執行個體服務相比，功能更豐富、擴充性更好、效能更穩定，更適合使用者的業務模式。執行個體對比詳細說明，請參見公用執行個體與企業版執行個體區別。

採用不同類型的企業版執行個體，可區分不同使用者交付的共用服務平台專案，實現資源隔離，使共用服務平台更穩定，同時降低專案評估成本。企業版執行個體類型的詳細說明，請參見企業版執行個體類型說明。

由於物聯網平台是在舊版公用執行個體之後提供的企業版執行個體服務，存量裝置是在舊版公用執行個體下啟動並執行。從資源隔離、穩定性和專案成本考慮，可將裝置相關資料從公用執行個體遷移到企業版執行個體中使用。

業務情境介紹

業務情境

序號	說明
1~1.2	將共用裝置連網接入阿里雲物聯網平台，然後上報資料。
	您的應用通過物聯網平台的AMQP訂閱或資料流轉，接收裝置上報的資料、狀態等訊息。
	您的資料庫即時儲存已訂閱或流轉的裝置資料。
2~2.2	消費者通過共用服務平台提供的App掃碼認證授權後，可查看共用裝置狀態，然後通過App下髮指令，控制共用裝置提供服務。說明鑒權成功後，App串連到共用服務平台，開始計費。
	您的應用接收到消費者下發的指令，調用阿里雲物聯網平台提供的裝置控制服務，控制裝置開始工作。
	裝置運行過程中和服務完成後，均上報裝置狀態，並通過資料流轉功能同步給您的應用，儲存在資料庫中。服務完成後，共用服務平台會推送PUSH訊息給App，提示消費者服務結束和計費等資訊。

遷移方案

執行個體遷移的整體流程說明，請參見使用前必讀。根據遷移流程說明，您需對共用裝置相關業務進行評估，然後制定遷移方案。

系統改造

針對業務情境評估後，以下業務情境配置需要改造，以保證裝置遷移後正常通訊。

業務項	改造方案	相關文檔
AMQP服務端訂閱	對於AMQP用戶端接入的SDK，需要複製新的企業版執行個體ID和接入網域名稱，配置新的AMQP用戶端，然後在灰階遷移時，複製更新消費組ID，啟動新的AMQP用戶端。您需啟動兩個AMQP用戶端，保證公用執行個體和企業版執行個體同時存在AMQP用戶端接收資料，防止資料丟失。	AMQP用戶端接入
雲產品流轉	在公用執行個體下，配置流轉資料：設定執行個體遷移事件流轉全部任務，訂閱執行個體遷移任務狀態變更訊息。執行個體遷移過程中，裝置遷移成功後的訊息中會流轉裝置成功的訊息。流轉裝置資訊並儲存到資料庫中。執行個體遷移過程中，會遷移資料流轉，更新資料庫中裝置所屬執行個體資訊為目標企業版執行個體的執行個體ID。	設定資料流轉規則執行個體遷移任務的狀態通知
雲端API調用	您需自行開發應用，在調用雲端介面時，先查詢資料庫表中執行個體ID資訊（企業版執行個體ID），然後設定介面請求參數IotInstanceId為該企業版執行個體ID，最後發起介面調用。	更新雲端SDK 執行個體遷移服務端修改樣本

業務項

改造方案

相關文檔

AMQP服務端訂閱

對於AMQP用戶端接入的SDK，需要複製新的企業版執行個體ID和接入網域名稱，配置新的AMQP用戶端，然後在灰階遷移時，複製更新消費組ID，啟動新的AMQP用戶端。

您需啟動兩個AMQP用戶端，保證公用執行個體和企業版執行個體同時存在AMQP用戶端接收資料，防止資料丟失。

AMQP用戶端接入

雲產品流轉

在公用執行個體下，配置流轉資料：

設定執行個體遷移事件流轉全部任務，訂閱執行個體遷移任務狀態變更訊息。
執行個體遷移過程中，裝置遷移成功後的訊息中會流轉裝置成功的訊息。
流轉裝置資訊並儲存到資料庫中。
執行個體遷移過程中，會遷移資料流轉，更新資料庫中裝置所屬執行個體資訊為目標企業版執行個體的執行個體ID。

雲端API調用

您需自行開發應用，在調用雲端介面時，先查詢資料庫表中執行個體ID資訊（企業版執行個體ID），然後設定介面請求參數IotInstanceId為該企業版執行個體ID，最後發起介面調用。

執行個體遷移

完成系統改造後，應用發布上線，即可通過物聯網平台的執行個體遷移功能遷移公用執行個體下共用裝置，如下圖所示。遷移流程

序號	操作	說明
1~1.2	調試公用執行個體下待遷移共用裝置。	消費者通過App使用共用服務平台提供的裝置共用服務時，應用系統查詢裝置資訊仍在公用執行個體中。此時，調用服務相關介面，無需傳入執行個體ID，即可通過阿里雲網關使用物聯網平台服務，控制待遷移裝置。
2~2.5	開始執行個體遷移：步驟一：建立遷移任務。步驟二：灰階遷移。	在物聯網平台控制台建立並發起執行個體遷移任務，進行灰階遷移：將公用執行個體下指定產品、規則引擎和灰階裝置的資料移轉到企業版執行個體中。此時，線上裝置被迫下線。裝置重連時自動接入企業版執行個體。裝置遷移完成，會同時將遷移資料流轉到商務服務器中，商務服務器更新資料庫中儲存的裝置資訊。灰階驗證完成後，對於新的AMQP消費端，需複製灰階遷移中產生的新消費組ID，重啟新AMQP消費端，用於接收資料。
3	步驟三：全量遷移。	在物聯網平台控制台發起全量遷移任務：將公用執行個體下指定產品下全量裝置遷移到企業版執行個體中。裝置遷移流程與灰階裝置遷移流程相同。說明全量遷移裝置不再包含已灰階遷移的裝置。
4~4.2	驗證企業版執行個體下已遷移共用裝置。	消費者對裝置所屬執行個體不感知，仍通過App使用共用服務平台提供的裝置共用服務，應用系統查詢裝置資訊在企業版執行個體中。此時，調用服務相關介面，必須傳入執行個體ID，才可通過阿里雲網關使用物聯網平台服務，控制已遷移裝置。說明裝置全量遷移完成，驗證業務結果正確，表示執行個體遷移完成且成功。若驗證業務有問題，可通過復原功能，將裝置從企業版執行個體中遷移到公用執行個體，其他資料保持不變。具體內容，請參見可選：復原遷移任務。