內網升級維運專案

  • 最後修改時間:2025-07-30
  • 1. 概述

    1.1 版本

    維運平台版本功能變更
    V1.5.5
    -
    V2.12.0降低維運專案升級前備份要求,存在24小時內備份即可升級
    V2.15.0支援「批量更新」組件功能

    1.2 應用場景

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

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

    1)FineReport內網/FineBI的小版本升級需要手動取代JAR包,操作門檻高。

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

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

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

    1.3 功能簡介

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

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

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

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

    1.4 適用範圍

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

    注1:外網升級最新版本,請參考:外網升級維運專案

    注2:最新版finekey預設不攜帶FineBI6.0相關鏡像,無法透過本文方案完成FineBI6.0.x小版本升級。

             內網如需升級6.0.x小版本,請透過服務平台聯絡帆軟技術支援,獲取鏡像包。技術支援聯絡方式:「服務>線上支援」

    2024-07-12_13-43-52.jpg

    2. 使用前提

    2.1 容器化部署

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

    2.2 檢查工程版本

    請先檢查當前工程版本。

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

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

    QQ图片20240712144926.png

    2.3 檢查叢集配置

    對於多應用叢集(注意,對於FineBI6.1專案,即使只有1個應用節點,也是叢集),請在升級專案前,檢查叢集配置是否全部開啟。

    請確認各個工程節點與檔案伺服器、狀態伺服器、資料儲存組件、外接配置庫等組件間的對接是否正常

    如對接異常或斷開,升級後可能導致工程檔案永久性丟失,相關範本和資料無法找回。

    2.4 備份工程

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

    更新時如檢查不到24小時內的備份,則無法更新。提示「組件更新失敗,更新前請保證至少有24小時內的備份,請備份後重試」

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

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

    注:部分檔案未進行備份(例如/assets/temp_attach),請自行對此類檔案進行備份。

          備份內容請參見:備份內容

    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

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

    資料夾/檔案
    檔案說明
    finekey/bin運作finekey的可執行檔案
    finekey/conffinekey.yaml新部署維運平台配置檔案
    finekey.push.yaml拉取鏡像配置檔案
    finekey/resources資源檔案,鏡像包放在其中images資料夾中

    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 檢查倉庫內鏡像

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

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

    2024-07-12_14-44-18.jpg

    4. 更新版本

    鏡像準備完畢後,使用者即可對組件進行更新。

    4.1 注意事項

    1)更新維運專案組件,支援對組件批量更新,支援對單個組件更新,但不支援對單個組件下的部分容器進行更新

    • 此設定是為了確定同一組件下容器版本的一致

    • 帆軟建議,在升級時將專案下的所有組件都更新到最新版本,以便提升專案安全性。

    2)部分組件版本之間存在主從依賴關係(例如升級bi-web組件,會觸發bi-engine-worker組件的更新)

    • 如組件間版本存在主從依賴關係,從屬組件的更新按鈕灰化,僅可對主組件進行更新。

    • 更新組件時,如有聯動更新組件,會提示「觸發更新後,xxx組件會同時停機更新至對應版本」

    4.2 操作步驟

    對於專案中的各個組件支援批量更新或對指定組件進行更新。

    帆軟建議在升級時,將專案下的所有組件都更新到最新版本,以便提升專案安全性。

    4.2.1 對單個組件進行更新

    1)管理者登入維運平台,選擇維運專案。點選「維護>組件管理」。

    2)找到待更新組件,點選「更新」。

    注:如組件間版本存在主從依賴關係,從屬組件的更新按鈕灰化,僅可對主組件進行更新。

           更新時會提示「觸發更新後,xxx組件會同時停機更新至對應版本」

    3)點選「開始更新」後,提示「更新程式將重啟組件,可能影響專案正常運作,請勿在使用期間操作。是否確認更新」

    點選「確定」後,開始更新組件,如下圖所示:

    4)更新完畢後,自動重新整理組件管理介面,提示「更新完成」,組件版本顯示:「當前已為最新版本」

    4.2.2 對專案組件批量更新

    1)管理者登入維運平台,選擇維運專案。點選「維護>組件管理」,點選「批量更新」。

    2)升級最新版本,無需輸入更新版本號,直接點選「開始更新>確定」,即可進行專案更新。

    • 觸發更新後,組件會同時停機更新到最新版本,可能影響專案正常運作,請勿在使用期間操作。

    • 如不存在24小時內的備份,則更新終止,請對專案進行備份後再進行更新。

    附件列表


    主題: 已有專案接入升級遷移擴容
    已經是第一篇
    已經是最後一篇
    • 有幫助
    • 沒幫助
    • 只是瀏覽