內網升級維運平台

1.1 版本說明

1.2 應用場景

內網升級使用 FineKey 容器化部署工具及離線安裝包，更新 FineOps 維運平台和維運組件，適用於鏡像倉庫無法連結帆軟雲端倉庫的環境。

能夠線上獲取鏡像的環境，建議直接線上升級，詳情請參見：外網升級維運平台。

本文不用於更新專案中的 FineReport、FineBI 應用版本。詳情請參見：內網升級維運平台。

升級維運平台前，可查閱近期功能變更，詳情請參見：維運平台更新日誌

1.3 升級影響

升級程式中會重啟維運平台；如觸發 Docker 引擎升級，還會重啟對應伺服器上的容器。

如果維運平台與維運專案部署在同一伺服器上，則升級維運平台可能影響該伺服器上的維運平台或專案存取。

請安排業務允許中斷的維護時間，再執行升級。

3.1 選擇離線安裝包

從下載頁獲取目標版本 FineKey。詳情請參見：FineOps維運平台下載。

內網環境不要選擇線上版安裝包，推薦選擇「全量版離線安裝包」。

3.2 上傳並解壓安裝包

1）將安裝包上傳到維運平台所在伺服器；需要從其他伺服器執行時，先完成第 2 節的節點連通檢查。

本文範例是將工具包上傳到了維運平台所在伺服器的 /home 路徑下，如下圖所示：

2）進入安裝包所在目錄並解壓。（請根據安裝包實際名稱和位置調整命令）

cd /home

tar zxvf finekey-amd64-tomcat-all-publish..tar.gz

3）得到 FineKey 工具目錄。

3.3 遷移原配置

注意：新舊版本的配置項可能不同。保留新安裝包的 finekey.yaml 結構，將原配置值逐項遷入；不要用舊檔案整體改寫新檔案，也不要整段取代全部內容。

1）開啟第二章準備的原工具包的 finekey/conf/finekey.yaml。

2）逐項覈對，將對應配置值寫入新工具包的 finekey/conf/finekey.yaml。

3）FineKey 與維運平台不在同一台伺服器時，補充待升級節點的連結資訊。

update:
nodes:
  - ip: localhost            #機器ip
    port: 22                 #機器ssh埠
    user:                    #節點ssh使用者
    password:                #節點ssh密碼
#  - ip: 192.168.101.145
#    port: 22
#    user:     xxx
#    password: xxx

4.1 執行升級命令

1）進入 3.2 節解壓所得的 finekey 工具包所在資料夾的 bin 目錄下。

cd /home/finekey/bin

2）使用語句啟動升級

./finekey update

注意：嚴格按上述命令執行，不要自行改為sudo ./finekey update，更改執行方式可能導致部署失敗。

4.2 執行升級流程

啟動升級後，FineKey升級維運平台的流程如下表所示，請耐心等待升級完成。

4.3 完成維運組件更新

1）平台恢復存取後，管理者重新登入。

2）若出現「維運平台正在完成最後一步更新，更新結束後將自動重新整理此頁面，更新期間請勿關閉維運平台！」，等待更新結束，不要關閉維運平台。

3）若未出現自動更新提示，進入「維運平台管理>維運組件」，按「一鍵升級」觸發剩餘組件更新。

4.4 確認升級成功

1）管理者登入維運平台。

2）按「維運平台管理>更新升級」，查看版本，提示「當前已是最新版本」，即代表維運平台升級成功。

問題描述

維運平台升級程式中，提示docker engine相關報錯

使用finekey語句檢查docker版本時報錯can not update for non finekey docker

原因分析

由於docker引擎、FineOps維運平台、專案的ops_agent組件存在對應關係。

如需手動升級維運平台，必須確定維運平台所在伺服器、維運平台對接的專案所在伺服器，均支援升級docker引擎。

如在執行finekey update程式中，檢查到系統禁止升級docker引擎，就會出現相關報錯，中斷升級。

解決方案

1）依次分別登入維運平台所在伺服器、維運平台對接的專案所在的每一台伺服器

2）執行語句，升級docker引擎：./finekey engine --update

3）再次參考上文使用語句啟動升級：./finekey update

注意事項

在升級FineOps維運平台時，在哪一台伺服器觸發了docker引擎升級，就會重啟該機器上的容器。

因此會影響終端使用者使用維運平台和專案。請選擇非工作時間進行升級，降低業務影響。