本文介紹如何在Ubuntu 16.04的系統中搭建Link IoT Edge專業版(LE Pro)的Docker運行環境,實現網關與云端連接的步驟。
專業版(LE Pro)規格的詳細說明請參見產品規格。
準備工作
LE Pro版需要您提前安裝好Docker環境,請參見Docker官方文檔安裝使用您Ubuntu 16.04系統的Docker客戶端。要求Docker版本大于V17.03。
創建邊緣實例和網關
- 登錄邊緣計算控制臺。
- 在左側導航欄單擊邊緣實例。
- 創建一個邊緣實例。
- 單擊新增實例,在彈出對話框中設置實例名稱。說明 實例名稱支持中文、英文字母大小寫、數字、下劃線(_)和短劃線(-),長度不超過20個字符,1個漢字算2個字符。
- 根據所搭建的環境,選擇對應的Link IoT Edge產品規格。詳細介紹,請參見產品規格。物聯網邊緣計算支持自動分配網關到邊緣實例,您可以無需設置其它新增實例相關參數,直接跳轉到步驟4。物聯網邊緣計算自動為您的邊緣實例創建名為LEGatewayAuto的網關產品,并在該產品下添加一個隨機命名的網關設備。說明
- 物聯網邊緣計算自動為您創建LEGatewayAuto產品時,若您已有該名稱的產品,則會在該名稱后添加隨機后綴,作為自動創建的網關產品。
- 物聯網邊緣計算已為您自動創建過一次LEGatewayAuto產品后,在您后續新建邊緣實例并自動分配網關時,會在LEGatewayAuto產品下新增網關設備,分配到您新的邊緣實例中。
- (可選)單擊標簽信息下的新增標簽,可以設置實例標簽。通過標簽您可以更加有效地歸類及識別實例。您也可以不設置標簽。若設置實例標簽,請填寫標簽key和標簽value。
表 3. 參數說明 參數 描述 標簽key 不可為空,僅支持英文字母大小寫,長度不超過20個字符,同一個邊緣實例不可以重復定義標簽key。 標簽value 不可為空,支持中文、英文字母大小寫、數字、下劃線(_)和短劃線(-),長度不超過20個字符,1個中文漢字算2個字符。
- 單擊新增實例,在彈出對話框中設置實例名稱。
- (可選)若您想要手動創建網關產品和設備并分配到邊緣實例,請按如下步驟操作。
- 在新增實例對話框,單擊高級選項。
- 在網關產品下單擊新建網關產品,為實例創建網關。物聯網邊緣計算中的網關承載邊緣計算能力,每個實例必須分配一個網關設備,并且該網關設備同一時間只能被分配到一個邊緣實例。
- 在創建產品對話框中,設置網關產品參數,然后單擊完成。物聯網邊緣計算中的新建網關產品,繼承了物聯網平臺中的產品功能,此處已自動為您簡化了創建產品的步驟,以便您更快速地創建適合物聯網邊緣計算中使用的網關產品。
表 4. 參數說明 參數 說明 產品名稱 為網關產品設置名稱,用于后續的查詢及識別網關產品。支持中文、英文字母大小寫、數字和下劃線(_),長度限制4~30個字符,一個中文漢字算2位。 所屬品類 選擇品類,為該產品定義物模型。
可選擇的值為:
- 標準品類:選擇任一物聯網平臺預定義的品類,快速完成產品的功能定義。選擇產品模板后,您可以在該模板基礎上,編輯、修改、新增功能。
- 自定義品類:需根據實際需要,定義產品功能。
若您需要的網關沒有特殊功能定義,建議您選擇自定義品類。
產品描述 可輸入文字,用來描述產品信息。字數限制為100個字符。可以為空。 產品創建成功后,自動跳轉回新增實例對話框,并且在網關產品參數下自動分配剛剛創建的網關產品。
- 在新增實例對話框,單擊網關設備下的新建網關設備,為網關產品添加設備。物聯網邊緣計算中的新建網關設備功能,繼承物聯網平臺的功能。
- 根據界面提示設置參數后,單擊確認。
表 5. 參數說明 參數 描述 產品 系統已自動關聯上一步創建的網關產品。 設備名稱 為該網關設備命名。設備名稱需保持產品內唯一。如不填寫,系統將自動生成。 說明 設備名稱長度為4~32個字符,可包含英文字母、數字和特殊字符,包括短劃線(-)、下劃線(_)、at(@)、英文句號(.)和英文冒號(:)。
- 實例參數設置完成后,單擊確定,至此您已創建邊緣實例和網關。
安裝并啟動Link IoT Edge
根據本文上方創建邊緣實例和網關內容,創建完成邊緣實例并分配網關后,您需要在網關上安裝并啟動Link IoT Edge。
- 在邊緣實例頁面,單擊實例名稱右側的軟件安裝。
- 根據環境設置軟件安裝相關參數,然后單擊生成安裝命令。
表 1. 參數說明 參數 描述 邊緣網關CPU架構 您的設備系統對應的CPU架構。此處選擇x86-64。 產品規格 在創建邊緣實例時,已選擇實例中使用的Link IoT Edge版本。此處不可操作。 邊緣版本 選擇Link IoT Edge的發布版本。
操作系統 選擇您的設備對應的操作系統。此處選擇Linux。 - 復制軟件包下載命令備用。
- 登錄您的Ubuntu系統機器。
- 任意目錄下執行步驟3中已復制的命令。該命令實現一鍵下載、配置并啟動Link IoT Edge。命令執行完成后,會在當前目錄中下載link-iot-edge.sh腳本。
- 如果第一次啟動Link IoT Edge,則需要完成如下交互式配置,您可以直接按Enter鍵使用默認配置。
- 確認啟動版本。
- 確認函數計算的runtime,函數默認運行在獨立的進程中。
- 確認是否啟動流式計算,默認開啟流式計算。
- 確認是否卸載之前已安裝的版本,默認卸載。
拉取Docker鏡像完成并啟動可能需要等待5~10分鐘,啟動完成后通過docker ps命令查看相關Docker容器是否已啟動,若系統顯示如下圖所示信息,表示啟動成功。
- 如果不是第一次安裝啟動Link IoT Edge,可使用已下載的link-iot-edge.sh腳本,對Link IoT Edge進行重啟、停止、獲取狀態、修改配置參數等操作,命令詳情請見下圖。
- 如果第一次啟動Link IoT Edge,則需要完成如下交互式配置,您可以直接按Enter鍵使用默認配置。
- 返回邊緣計算控制臺,在左側導航欄選擇邊緣實例,找到已創建好的邊緣實例,單擊右側操作欄中的查看,進入實例詳情頁面,選擇網關查看網關狀態。
打開遠程訪問按鈕,可對網關進行遠程管理,詳細操作步驟,請參見遠程服務訪問。
- (可選)在實例詳情頁面,查看CPU使用率、內存使用率、存儲使用率以及實例進程需要授權訪問阿里云云監控(CloudMonitor)服務。
- 添加角色或分配已有的角色,并確保該角色擁有管理云監控(CloudMonitor)的權限。詳細操作,請參見云資源訪問。
- 選擇監控信息頁簽,打開頁面右側的云監控狀態開關,如下圖所示。
云監控狀態打開后,可在監控信息頁簽,查看網關的各類監控信息。
- (可選)Link IoT Edge支持將邊緣實例授權給其他阿里云賬號操作。在邊緣實例頁面,單擊左上角授權,在彈出對話框中單擊新增授權,根據界面提示設置參數。
表 6. 參數說明 參數 描述 授權用戶UID 獲取被授權用戶的阿里云賬號ID,填入此處。 授權實例 選擇允許該阿里云賬號ID的用戶進行遠程運維操作的邊緣實例。
Link IoT Edge的其它操作
- 重新配置Link IoT Edge。
使用如下命令,對當前已安裝的Link IoT Edge版本配置進行修改。
./link-iot-edge.sh --reconfig {Version}
其中,{Version}替換為目標版本號,例如目標版本號為V1.8.2,則實際命令為
./link-iot-edge.sh --reconfig v1.8.2
。 - 停止Link IoT Edge。
使用如下命令,可以停止所有Link IoT Edge運行的容器,但是不會刪除。
./link-iot-edge.sh --stop
- 重新啟動Link IoT Edge。
在容器已存在且沒有運行的狀態下,執行如下命令可重新啟動Link IoT Edge。
./link-iot-edge.sh --restart {Version}
其中,{Version}替換為目標版本號,例如目標版本號為V1.8.2,則實際命令為
./link-iot-edge.sh --restart v1.8.2
。 - 清理Link IoT Edge。
執行如下命令,可停止當前運行的Link IoT Edge相關容器 ,并會刪除所有已安裝的相關鏡像,刪除相關數據卷以及啟動配置文件。
./link-iot-edge.sh --clean
- 提取Link IoT Edge的日志。
執行如下命令,可打包Link IoT Edge的所有日志,并拷貝到當前目錄。
./link-iot-edge.sh --packagelog
下一步
環境搭建完成后,您可以根據設備接入內容,把您的設備接入到物聯網邊緣計算。同時也可以為邊緣實例分配其他資源(如函數計算、消息路由等)管理您的設備。
接入設備或分配其他資源到邊緣實例后,需要根據如下步驟部署邊緣實例。
- 在實例詳情頁面,單擊右上角部署后,在彈出對話框中單擊確定,部署邊緣實例。
- 當部署狀態顯示為部署成功,表示部署實例完成。您可以單擊查看日志,查看部署詳情。您也可以通過單擊實例詳情頁面右上角的查看部署日志,查看歷史部署情況。