本文介紹SaaS開發服務流程。
背景信息
操作步驟
創建應用。
單擊創建應用。
填寫應用基礎信息。
開發管理。
配置開發信息。
開發信息是ISV在開發使用平臺接口時所使用到的相關信息集合。
openAccountId是ISV在平臺的唯一ID標識,密鑰是ISV解密時需要使用的密鑰,平臺請求發送給ISV的接口數據是加密處理的,需要openAccountId和密鑰組合進行解密處理。
回調URL是設備屬性變化上報后,如果對應產品勾選了應用那么該屬性變化值就會請求到ISV服務端進行處理,此時需要指定URL路徑方便平臺根據設置進行對應請求。注:回調URL是ISV賬號維度信息,設置后所有應用看到都是一份;URL 路徑設置只需設置相對路徑即可,不需要域名,如正常請求URL: https://www.taobao.com/get/xxxxx,回調URL只需設置/get/xxxxx即可,詳細信息可參見下方接口管理處平臺調用ISV原理。
應用開發。
在這里添加已創建服務,如未創建,請詳見后續服務管理部分,進行服務創建。
應用調試。
授權產品
目前平臺開放的是私有應用,當應用授權ProductKey后,此ProductKey才能在生活物聯網平臺->人機交互->應用服務處看到該應用進而進行調試。
添加應用
開發完成后,品牌商通過生活物聯網平臺進入
,可查看到該產品可以綁定的應用服務,完成綁定后可在產品調試環節進行驗證和測試。測試通過后可發布產品,產品發布后,該應用或服務將可以被用戶使用。說明產品發布上架如有勾選應用,那么應用也必須上線否則產品無法發布成功。
測試環境
測試環境是應用在調試期間,設備屬性變化上報和H5頁面發起的請求都會請求到該測試環境中,測試環境僅作調試功能使用,應用發布上線后相關請求都會請求到對應正式環境中。測試環境和正式環境參見下文環境管理部分。
調試設備
點添加調試設備后會顯示登錄的SaaS平臺賬號對應的淘寶賬號下綁定的天貓精靈IoT設備,選擇某一設備進入調試設備列表后,那么該設備的屬性變化上報就會請求到ISV創建的測試環境中。
上傳面板
ISV可訪問生活物聯網平臺,選擇具體開發的產品,進入
上傳H5面板,做應用功能調試。具體接口調用詳情參見接口管理部分。服務部署。
應用勾選的自定義服務或者官方服務所對應的接口如果需要后端服務進行響應,那么在應用測試通過后需要云環境正式環境進行部署,否則應用發布后頁面請求會得到失效響應。
應用發布。
用圖文、視頻的形式展現應用的功能。
服務管理。
服務分為官方服務和自定義服務,官方服務目前開放云食譜管理,無需創建接口即可使用;自定義服務需ISV在我的服務內進行創建應用和接口,是對IoT產品某一業務功能的接口集合,如:門鎖數據統計服務、安防服務。
創建服務。
服務關聯接口。
在服務創建時選擇接口,將接口加入到服務。
需要注意列表只會展示已經上線的接口,見下面的兩個截圖,如果沒有顯示想要的接口,請檢查接口的狀態。
只支持已上線的接口供服務選擇使用。如果接口進行版本升級參數有調整后,那么調整的接口未上線前服務所使用的接口依然是前一個版本,調整的接口上線后服務所使用的接口默認會升級為調整后的接口。平臺請求API接口時默認會帶上API接口的版本號,ISV可根據版本號進行服務端接口參數調整的差異。
接口管理。
API接口是ISV開發的H5/小程序發起請求后,由天貓精靈AIoT創新工廠轉發請求至ISV云服務器進行邏輯處理,如下圖所示。其中,ISV接受到的消息是加密后的消息,需要根據openAccountId和數據密鑰解密,具體信息參見“開發管理”一列。根據openAccountId和密鑰進行解密方式參見文檔”附錄">“解密計算方法”。AIoT創新工廠是通過阿里云內網轉發請求到ISV云環境的SLB中,所以ISV需要購買SLB,并且設置為私網協議為HTTPS,端口設置為443,云環境涉及產品部分參見"環境管理"。
創建接口。
接口創建時可以在不同的服務中復用,所以修改接口時需要注意對不同服務的影響。
接口必須參數:名稱、接口路徑定義、版本、出參、入參。
接口調試。
接口調試必須創建測試環境,ISV調試接口的請求都會請求至ISV云環境的測試環境;
API會由平臺直接請求到ISV方SLB中,默認HTTPS協議,post方式。
接口上線。
點擊“上線”即完成了接口上線的操作,如下圖所示;
接口上線后不支持下線,可進行接口版本升級進行參數調整。如果接口進行版本升級參數有調整后,那么調整的接口未上線前服務所使用的接口依然是前一個版本,調整的接口上線后服務所使用的接口默認會升級為調整后的接口。平臺請求API接口時默認會帶上API接口的版本號,ISV可根據版本號進行服務端接口參數調整的差異。
云環境。
ISV開發的H5/小程序發起的請求經由AIoT創新工廠轉發后請求至ISV服務端,因為數據安全因素評估ISV服務端只能部署在阿里云中,相應的阿里云賬號由AIoT創新工廠提供(作了安全策略)。ISV需在給定已有阿里云賬號內購買SLB、ECS、RDS等云產品,將服務端部署至ECS中,H5/小程序對應請求會請求至SLB,之后ISV將請求分發至對應的服務進行邏輯處理。云環境分為正式環境和測試環境,ISV進行接口調試和應用功能調試發起的請求都會默認發送至測試環境部署的服務中,應用發布后應用頁面發起的請求會發送至正式環境部署的服務中。其中,測試環境可僅有SLB和ECS,ECS內部署MySQL,能夠功能調試即可,對產品配置不作要求;而正式環境則必須SLB、ECS、RDS必須具有,具體配置可參考”云環境“>”云環境購買“提供的產品配置信息,最終可結合自身情況而定。
獲取云賬號。
ISV服務需要部署在阿里云內,此處的阿里云賬號和密碼是平臺生成的,會在入駐AIoT創新工廠的時候平臺提供生成。需要確保當前登錄AIoT創新工廠的賬號是認證過的企業/機構賬號,目前暫未對個人賬號放開。
首次登錄云賬號后會要求重置密碼,如果忘記重置后的阿里云賬號和密碼,聯系技術支持人員協助找回。
賬號和密碼的找回,會將驗證碼發送到此郵箱,然后填寫驗證碼檢驗后,之后會顯示密碼。
如果有密碼或者獲取到賬號和密碼,請點擊登錄。
使用賬號登錄阿里云資源管理頁面。
購買云資源。
平臺給出的ECS單機配置是推薦配置,可以根據自己的需求定制。單機規格可定制,但是配置組件數量必須按照標準,否則環境審核不過。
云資源必須購買在張家口(目前只支持此region的資源)。
購買的各個組件必須屬于同一個區域(例如:A區 、H區等)。
購買資源前,先看同一區域的是否有相應的資源,例如購買H區資源,先查看是否有相應ECS、SLB、VPC、RDS、Redis資源
全局只能有一個測試環境 ,測試環境標準配置 : SLB+ECS(可1臺);正式環境標準配置 : SLB 1臺、ECS至少2臺、RDS 1臺、Redis(可選)。
下圖顯示主要資源和規格要求,僅作參考配置。
建議:考慮測試環境僅作調試功能使用,從費用角度觸發,測試環境VPC下ECS可按照包年最低配,數據庫可直接安裝在ECS中更為劃算;線上環境強制要求ECS高配,數據庫使用RDS MySql版本。
購買ECS
結算方式、區域、分區;
不要選擇公網ip;
購買SLB
支付方式、region、可用區域;
購買完以后要對SLB對其配置,并做好和ECS的映射。
注:SLB開通HTTPS協議(443端口),否則上文提到的API接口調用不通。證書部分可申請使用阿里云個人測試證書(免費版),之后在SLB中導入證書;如果申請阿里云證書時,DNS驗證時設置為「手工DNS驗證」,然后根據下一步之后的提示內容將主機記錄和記錄值添加到對應域名記錄名下(因為SLB為私網類型,此處只為初始化證書驗證使用;域名可采用ISV已有的域名進行管理添加不必在阿里云單獨進行域名維護)。
購買RDS
注冊云資源。
無論是測試環境、還是正式環境,創建完阿里云資源后,將資源ID注冊回平臺。
資源注冊后只有查詢和監控權限,資源不可再修改(下線聯系運營走特殊流程)。
云效使用。
服務部署在阿里云中那么就不可避免會涉及到Devops,因此AIoT創新工廠借助云效2020(注意是「云效2020」)來解決這一問題,可使用云效中「流水線」個性化設置部署流程。
開通云效2020后,涉及新增云服務器,其中選擇阿里云ECS后,需要開通權限認證,請聯系技術支持人員協助處理。
注:如果涉及使用到云效進行部署容器服務,因為ECS沒有開訪問公網權限,那么請將部署至阿里云容器鏡像的訪問域名「registry.****」替換成「registry-vpc.****」。
產品&應用管理。
產品授權管理。
產品授權管理方案商在創新工廠開發的私有應用,方案商可在產品授權中對產品ProductKey進行授權,之后品牌商即可在生活物聯網平臺中進行應用勾選,建立關聯關系。
授權應用管理。
當應用授權某款產品后就可以在生活物聯網平臺中看到應用并進行選擇使用,無論是開發中或者已發布的應用都可以在生活物聯網平臺看到并使用,一款產品可選擇多個應用,或者被多個應用授權。