內網升級維運專案

1.1 版本

1.2 應用場景

為滿足客戶的新需求以及完善之前版本某些功能的不足之處，FineReport/FineBI在不斷地更新迭代。

小明部署好容器化FR/BI工程後，需要定期對工程進行更新升級，但是他發現傳統的升級方式存在着一些問題。

1）FineReport內網/FineBI的小版本升級需要手動更換JAR包，操作門檻高。

2）由於部分版本的相容問題，使用者需要升級指定版本而非最新版本，只能手動更換JAR包，操作門檻高。

3）FineReport外網升級，需要手動重啟工程/叢集所有節點，操作麻煩。

4）升級失敗後工程無法自動回退，存在風險。

1.3 功能簡介

FineOps維運平台提供面向組件的「更新」功能。

1）支援升級最新/指定版本。

2）透過推播鏡像方式，支援內網安全更新。

3）任何更新失敗均可自動回退。

1.4 適用範圍

內網升級版本：僅內網使用的維運平台，透過finekey推播鏡像，將專案組件升級到指定/最新版本時的解決方案。

注：外網升級最新版本，請參考：外網升級維運專案

2.1 容器化部署

使用維運平台更新帆軟專案，僅面向容器化部署的專案，非容器化部署工程不支援本文相關操作。

2.2 檢查工程版本

請先檢查當前工程版本。

管理者登入FR/BI工程，點選「管理系統>註冊管理>版本資訊」，查看當前版本號。

檢查 FineReport更新日誌、FineBI更新日誌 即可查看官方發佈的最新版本號，確認自己需要升級到的版本。

2.3 備份工程

建議在更新組件前，對專案進行整體備份，防止更新程式出現不可控意外。

管理者登入維運平台，選擇指定專案，點選「維護>備份管理」。

建議勾選「備份鏡像」，點選「開始備份」，維運平台即會對該專案進行整體備份。

3.1 儲存原yaml檔案

從原容器化部署工具finekey/conf目錄下獲取finekey.yaml檔案，下文需要用到。

3.2 獲取指定版本FineKey

1）最新版本

點選可跳轉至下載頁下載安裝包：FineOps維運平台下載

請下載全量版離線安裝包。

2）指定版本

付費使用者聯絡技術支援，索要指定版本的鏡像檔案。請提供所需的FineReport/FineBI小版本號。

技術支援聯絡方式：帆軟官方服務渠道使用説明

技術支援會提供該版本對應的FineKey容器化部署工具，工具中有相關鏡像包。

3.3 上傳FineKey安裝包

獲得工具包後，需要將它上傳到 Linux，上傳檔案的方法請自行查閱相關資料。

本文範例是將工具包上傳到了 CentOS 7.6.1810 的 /home 路徑下，如下圖所示：

3.4 解壓FineKey安裝包

1）先使用 cd 命令進入工具包所在資料夾下。

2）鍵入如下命令進行解壓：

tar zxvf finekey-operation.tar.gz

解壓後的檔案如下表所示：

3.5 配置yaml檔案

yaml 檔案指的是工具解壓目錄下 conf 資料夾裏的 finekey.yaml，該檔案是控制後面整個升級流程的。

更換finekey.yaml檔案

取出3.1節從原finekey部署工具finekey/conf目錄下獲取finekey.yaml檔案，將檔案中的配置值，一項一項的複製更換到新fineKey部署工具finekey/conf目錄下的finekey.yaml檔案。

注：請勿直接更換yaml檔案，或一鍵複製貼上檔案內容，因為新舊版本中，yaml檔案設定可能存在微小差異，建議逐項copy配置值即可。

3.6 執行推播

1）先使用 cd 命令進入工具包所在資料夾的bin目錄下。

2）使用語句啟動升級：./finekey update

3.7 檢查倉庫內鏡像

推播成功後，管理者登入維運平台，點選「維護中心>鏡像管理」，查看推播到倉庫的新鏡像。

記下需要更新到的版本號，下文需要用到。

1）管理者登入維運平台，選擇指定專案，點選「維護>組件管理」。

2）找到待更新組件，點選「更新」，輸入倉庫中的版本號，點選「開始更新」，即可進行工程更新。

• 如存在24小時內的備份，則無需再次備份，直接更新。

• 如不存在24小時內的備份，且維運平台磁碟空間充足，則先進行備份，再進行更新。

• 如不存在24小時內的備份，且維運平台磁碟空間不足，則更新終止，請對磁碟進行清理/擴容後再進行更新。