操作流程

私有化部署華為云Astro大屏應(yīng)用的操作流程，如圖1所示。

圖1 華為云Astro大屏應(yīng)用私有化部署流程

1. 步驟一：購買華為云Astro大屏應(yīng)用企業(yè)版實例

   購買一個華為云Astro大屏應(yīng)用企業(yè)版實例，當(dāng)前僅華為云Astro大屏應(yīng)用企業(yè)版實例才支持私有化部署。

2. 步驟二：下載運行環(huán)境

   在企業(yè)版華為云Astro大屏應(yīng)用界面，下載運行環(huán)境部署包。運行環(huán)境部署包用于在服務(wù)器上部署華為云Astro大屏應(yīng)用運行環(huán)境。

3. 步驟三：（可選）校驗軟件包完整性

   為了避免軟件包部署前被惡意篡改，在安裝軟件包前建議進行軟件包完整性校驗。

4. 步驟四：安裝運行環(huán)境

   在本地服務(wù)器上，安裝運行環(huán)境部署包，獲取機器碼。在企業(yè)版華為云Astro大屏應(yīng)用注冊機器碼，生成Key。服務(wù)器綁定Key后，才可正常訪問私有化部署的華為云Astro大屏應(yīng)用運行環(huán)境。

5. 步驟五：使用私有化部署的華為云Astro大屏應(yīng)用服務(wù)

   在私有化部署的華為云Astro大屏應(yīng)用運行環(huán)境中，安裝可視化應(yīng)用部署包，更新可視化應(yīng)用的配置。

私有化部署對服務(wù)器的軟硬件要求

系統(tǒng)和硬件要求如下：

• CentOS 7.0 64位Linux系統(tǒng)
• 4核4GHz處理器
• 8GB內(nèi)存
• 100GB硬盤

步驟一：購買華為云Astro大屏應(yīng)用企業(yè)版實例

1. 進入購買華為云Astro大屏應(yīng)用實例頁面。
2. 實例版本選擇“華為云Astro大屏應(yīng)用企業(yè)版”，選擇購買時長，單擊“立即購買”。
3. 選擇支付方式，單擊“確認(rèn)付款”，完成訂單支付。
4. 訂單支付成功后，單擊“返回Astro輕應(yīng)用控制臺”。

   在華為云Astro大屏應(yīng)用控制臺中，可以查看到華為云Astro大屏應(yīng)用的安裝狀態(tài)。當(dāng)“實例狀態(tài)”變?yōu)椤斑\行中”時，說明實例已安裝好，可以正常使用。

   圖2 華為云Astro大屏應(yīng)用控制臺
   

5. 單擊實例中的“進入首頁”，進入華為云Astro大屏應(yīng)用界面，開發(fā)頁面并發(fā)布。

   如何使用華為云Astro大屏應(yīng)用開發(fā)可視化頁面，請參見創(chuàng)建頁面。

步驟二：下載運行環(huán)境

1. 在華為云Astro大屏應(yīng)用服務(wù)控制臺，單擊實例中的“進入首頁”，進入華為云Astro大屏應(yīng)用界面。
2. 在頁面右上角，單擊“賬號名”，選擇“本地部署”。
   圖3 選擇本地部署
   

3. 在本地部署信息中，單擊“下載運行環(huán)境”，下載華為云Astro大屏應(yīng)用運行環(huán)境部署包。

   運行環(huán)境部署包用于在服務(wù)器上部署華為云Astro大屏應(yīng)用服務(wù)，包名為“AstroCanvas_Runtime.zip”。如果需要下載歷史版本的部署包，可以單擊“版本列表”，再單擊對應(yīng)版本后的，即可將該版本的部署包下載到本地。

   圖4 下載運行環(huán)境
   

步驟三：（可選）校驗軟件包完整性

為了避免軟件包部署前被惡意篡改，在安裝軟件包前建議參照本章節(jié)操作進行軟件包完整性校驗。

1. 在本地的PC機上，快捷鍵windows+R，輸入cmd進入命令提示符系統(tǒng)。
2. 在命令提示符系統(tǒng)中，輸入以下命令查看文件SHA256值。

   certutil -hashfile 文件路徑 SHA256

   其中，文件路徑為軟件包在PC機上的存放路徑。

   執(zhí)行上述命令后，在回顯信息中查看文件SHA256的值，如圖5所示。如果回顯信息與表1中SHA256值相同，說明軟件包未被篡改。

   圖5 回顯信息
   

   表1 歷史版本號

   歷史版本號	SHA256值
   v1.0.0	851240cb215f53d303003583d410fd793595c7e8a0e30a78a9c673c18273e558

步驟四：安裝運行環(huán)境

1. 部署華為云Astro大屏應(yīng)用服務(wù)。
   1. 登錄您的服務(wù)器，創(chuàng)建安裝目錄。

      cd /home/mkdir canvas_private

      其中，“canvas_private”為安裝目錄，可自定義。本章節(jié)以在“home”目錄創(chuàng)建安裝目錄為例進行介紹，您也可以在其他目錄下創(chuàng)建該目錄。

   2. 將步驟二：下載運行環(huán)境中獲取的華為云Astro大屏應(yīng)用運行環(huán)境部署包（AstroCanvas_Runtime.zip），上傳到安裝目錄下。
   3. 解壓已上傳的部署包，并進入已解壓后的目錄。

      unzip AstroCanvas_Runtime.zipcd AstroCanvas_Runtime

      圖6 解壓后包中的內(nèi)容
      
   4. 進入config目錄，新增“application.yml”配置文件。

      cd configvi application.yml

      在配置文件中，添加如下內(nèi)容：

      # 配置當(dāng)前機器的ip（默認(rèn)127.0.0.1）hostIp: 10.10.*.*# 配置http連接器超時時間（默認(rèn)3000）http:  connectTimeout: 30000  socketTimeout: 30000magno:  deploy:    # 配置私有化環(huán)境啟動端口（默認(rèn)8081）    serverPort: 19996    # 配置是否開啟匿名訪問，默認(rèn)是false，開啟則改為true    enableAnonymous: false    # 租戶ID    tenantId: tenant-2bb76b9b9f24****09737a83

      其中，“tenantId”為租戶ID，請參考步驟二：下載運行環(huán)境中操作，進入“本地部署信息”頁面。在租戶ID后，單擊，即可復(fù)制租戶ID。

      圖7 復(fù)制租戶ID
      
   5. 進入解壓后的目錄，執(zhí)行啟動命令。

      cd /home/canvas_private/AstroCanvas_Runtimesh start.sh

      如果啟動失敗，請查看啟動日志“/home/canvas_private/AstroCanvas_Runtime/startlogs/start.log”。如果提示權(quán)限不足，請返回安裝目錄，設(shè)置目錄下所有文件為最大權(quán)限。

      cd /home/canvas_private/AstroCanvas_Runtimechmod -R 777 AstroCanvas_Runtime

      

      其他常用操作及命令如下：

      • 查看日志：/home/canvas_private/AstroCanvas_Runtime/logs/***-PrivateDeployApp.log
      • 重啟服務(wù)：sh restart.sh，執(zhí)行啟動命令后，如果修改了“application.yml”文件，需要執(zhí)行該命令，重新啟動。
      • 停止服務(wù)：sh stop.sh

2. 服務(wù)啟動后，在瀏覽器中，輸入華為云Astro大屏應(yīng)用服務(wù)所在服務(wù)器的IP地址和端口，獲取機器碼。

   http://10.10.*.*:19996/

   其中，“10.10.*.*”為1.d中，修改application.yml時配置的服務(wù)器ip、“19996”為端口。

   圖8 復(fù)制服務(wù)器機器碼
   

3. 注冊服務(wù)器。
   1. 在華為云Astro大屏應(yīng)用界面，單擊右上角的賬號名，選擇“本地部署”。
      圖9 華為云Astro大屏應(yīng)用界面選擇本地部署
      
   2. 在本地部署信息頁面，單擊“注冊”。
      圖10 選擇新建服務(wù)機器碼
      
   3. 輸入服務(wù)器機器碼和名稱，單擊“確定”，生成測試Key。
      圖11 生成測試Key
      

      其中，“服務(wù)器機器碼”請配置為2中獲取的內(nèi)容，服務(wù)器名稱請根據(jù)實際情況進行配置。

   4. 返回本地部署信息頁面，單擊服務(wù)器機器碼后的，下載測試Key文件（runtime.key）。
      圖12 下載測試Key文件
      
   5. 將獲取的測試Key，上傳到本地服務(wù)器的“/home/canvas_private/AstroCanvas_Runtime/config”目錄下，驗證服務(wù)器部署情況。

      cd /home/canvas_private/AstroCanvas_Runtime/config

      • 測試Key有效期為3天，過期后請使用機器碼重新注冊并生成測試Key或啟用為正式Key。下載新的Key后，需要刪除原先的Key，替換為新的Key。
      • 使用機器碼生成新的測試Key時，需要先刪除失效的Key，再重新注冊。因為一個機器碼只能注冊一個Key。
      在瀏覽器中，輸入華為云Astro大屏應(yīng)用服務(wù)所在服務(wù)器的IP地址和端口，可正常進入華為云Astro大屏應(yīng)用界面，說明已部署成功。

      http://10.10.*.*:19996/

      其中，“10.10.*.*”為1.d中，修改application.yml時配置的服務(wù)器公網(wǎng)ip，“19996”為端口。

   6. 驗證無誤后，單擊測試Key右側(cè)操作欄中的，在彈出的頁面單擊“確定”，啟動測試Key。
      圖13 啟動測試Key
      

      啟動成功后，返回本地部署信息頁面，可查看到“Key類型”由“測試”變?yōu)?span id="q0iys8m" class="uicontrol" id="astrocanvas_05_7162__uicontrol103077241194">“正式”。

      圖14 正式Key
      

4. 下載正式Key文件（runtime.key），替換測試Key的runtime.key文件，替換后重啟服務(wù)即可使用。
5. 配置登錄私有化部署華為云Astro大屏應(yīng)用的用戶名和密碼。
   1. 進入“/home/canvas_private/AstroCanvas_Runtime”目錄。

      cd /home/canvas_private/AstroCanvas_Runtime

   2. 編輯userConfig.json文件，在文件中設(shè)置登錄華為云Astro大屏應(yīng)用的用戶名和密碼。

      vi userConfig.json

      配置示例如下：

      {    "accounts": [        {            "name": "user1",            "pwd": "user1用戶登錄密碼"        },        {            "name": "user2",            "pwd": "user2用戶登錄密碼"        }    ]}

   3. 配置完成后，保存文件并退出。

步驟五：使用私有化部署的華為云Astro大屏應(yīng)用服務(wù)

1. 登錄私有化部署的華為云Astro大屏應(yīng)用界面。
   1. 在瀏覽器中，輸入華為云Astro大屏應(yīng)用服務(wù)所在服務(wù)器的IP地址和端口，進入華為云Astro大屏應(yīng)用登錄頁。

      http://10.10.*.*:19996/

      其中，“10.10.*.*”為1.d中，修改application.yml時配置的服務(wù)器公網(wǎng)ip，“19996”為端口。

   2. 輸入5中配置的用戶名和密碼，單擊“登錄”，即可進入華為云Astro大屏應(yīng)用界面。
      圖15 輸入用戶名和密碼
      

2. 獲取可視化應(yīng)用本地部署包。
   1. 在步驟一：購買華為云Astro大屏應(yīng)用企業(yè)版實例中，單擊華為云Astro大屏應(yīng)用實例中的“進入首頁”，進入華為云Astro大屏應(yīng)用界面。
   2. 在項目列表中，將鼠標(biāo)放在對應(yīng)的項目上，單擊。
      圖16 單擊下載本地部署包圖標(biāo)
      
   3. 在彈出的頁面，勾選需要下載的頁面，單擊“下載本地部署包”。

      可視化應(yīng)用本地部署包用于在部署后的華為云Astro大屏應(yīng)用運行環(huán)境中安裝應(yīng)用，實現(xiàn)項目的遷移，包名為“AstroCanvas_項目名_隨機編碼.zip“。

      圖17 選擇本地部署的頁面
      

3. 添加可視化應(yīng)用。
   1. 在項目列表中，單擊“導(dǎo)入項目包”。
   2. 選擇2中下載的可視化應(yīng)用本地部署包（AstroCanvas_項目名_隨機編碼.zip）。

      在項目列表中，可查看到項目已成功導(dǎo)入。

      圖18 查看導(dǎo)入的項目
      

4. 配置數(shù)據(jù)源密碼和加密字段。

   在運行環(huán)境中導(dǎo)入可視化應(yīng)用本地部署包后，如果應(yīng)用包中包含關(guān)系型 數(shù)據(jù)庫 、Prometheus和HTTP連接器數(shù)據(jù)源，需要重新配置密碼和加密字段。

   圖19 修改關(guān)系型數(shù)據(jù)庫數(shù)據(jù)源密碼
   
   圖20 修改Prometheus數(shù)據(jù)源密碼
   
   圖21 修改HTTP連接器數(shù)據(jù)源加密字段
   

5. 訪問項目中的頁面。
   在華為云Astro大屏應(yīng)用企業(yè)版項目中發(fā)布頁面時，如果“訪問限制”設(shè)置的是“Token認(rèn)證”，則不需要執(zhí)行如下操作，直接在項目詳情頁單擊“頁面URL”地址，即可正常訪問頁面。如何設(shè)置Token認(rèn)證，請參見如何設(shè)置Token認(rèn)證。發(fā)布頁面時如果“訪問限制”設(shè)置的是“分享碼”，在私有化部署的華為云Astro大屏應(yīng)用環(huán)境中導(dǎo)入項目后，頁面中原先設(shè)置的分享碼會被置空，請按照如下操作重新設(shè)置。

   1. 在項目列表中，單擊已導(dǎo)入的項目，進入項目詳情頁。
   2. 單擊待訪問頁面后的，為頁面設(shè)置分享碼。
      圖22 為頁面設(shè)置分享碼
      
   3. 輸入分享碼，單擊，保存設(shè)置。
      圖23 設(shè)置頁面分享碼
      
   4. 單擊，復(fù)制頁面URL地址。
      圖24 獲取頁面URL
      
   5. 在瀏覽器中輸入獲取到的地址，輸入分享碼后，即可正常訪問頁面。
      圖25 輸入分享碼訪問頁面
      

（可選）增加私有化部署根目錄

當(dāng)前私有化部署沒有統(tǒng)一的根目錄，在實際運維場景中可能需要配置在指定的根目錄下，此時可按照如下操作執(zhí)行。

以根目錄“canvas”為例，在Nginx的“conf/nginx.conf” 文件的“http”中增加如下代碼。在實際配置時，請將代碼中的canvas、{私有化部署的IP}、{私有化部署的端口}、{Nginx對應(yīng)的IP}和{對應(yīng)的端口}替換為對應(yīng)的字段。

完成私有化部署根目錄配置后，原1中的訪問地址需要更改為“http://{Nginx對應(yīng)的IP}:{對應(yīng)的端口}/canvas”。

sub_filter_once off;server {        listen       8080; #請確保端口未被占用        server_name  localhost;        location /canvas/magno {            proxy_pass http://{私有化部署的IP}:{私有化部署的端口}/magno;            # 域名替換            sub_filter 'http://{私有化部署的IP}:{私有化部署的端口}' 'http://{Nginx對應(yīng)的IP}:{對應(yīng)的端口}/canvas';            sub_filter '"http:\/\/{私有化部署的IP}:{私有化部署的端口}' '"http://{Nginx對應(yīng)的IP}:{對應(yīng)的端口}/canvas';            sub_filter '{私有化部署的IP}:{私有化部署的端口}' '{Nginx對應(yīng)的IP}:{對應(yīng)的端口}/canvas';            sub_filter '/magno/studio/dmax_share/auth/' '/canvas/magno/studio/dmax_share/auth/';            sub_filter '="/resources/' '="/canvas/resources/';             sub_filter '"\/magno\/gallery' '"\/canvas\/magno\/gallery';             sub_filter 'magno\\\\/gallery' 'canvas\\\\/magno\\\\/gallery';             sub_filter '{Nginx對應(yīng)的IP}/magno/render/share/' '{Nginx對應(yīng)的IP}:{對應(yīng)的端口}/canvas/magno/render/share/';             sub_filter_types *;        }        location /canvas/resources {            proxy_pass http://{私有化部署的IP}:{私有化部署的端口}/resources;            sub_filter '.appBaseUrl' '.appBaseUrls';            sub_filter '"/magno/render' '"/canvas/magno/render';            sub_filter_types *;        }        location /canvas/global {            proxy_pass http://{私有化部署的IP}:{私有化部署的端口}/global;            sub_filter '/magno/gallery/asset/globalImageUrl' '/canvas/magno/gallery/asset/globalImageUrl';             sub_filter '/magno/render/share' '/canvas/magno/render/share';            sub_filter_types *;        }        location /canvas/default {            proxy_pass http://{私有化部署的IP}:{私有化部署的端口}/default;         }        location /canvas/obs {            proxy_pass http://{私有化部署的IP}:{私有化部署的端口}/obs;        }    }