全部產品
Search
文件中心

Dataphin:不停機升級Dataphin

更新時間:Mar 06, 2026

本文介紹如何在Dataphin Manager中不停機升級Dataphin版本。

使用限制

僅當Dataphin目前的版本與目標版本的版本號碼前三位相同時(例如,V5.1.2.02升級至V5.1.2.04),支援不停機升級。

前提條件

  • 已瞭解版本升級的影響範圍,詳情請參見版本升級的影響範圍

  • 當前沒有進行中的配置和升級。如果系統正處於升級中的狀態,請等待當前升級完成,或在必要時強制終止進行中的版本升級後,再次進行升級。

背景資訊

不停機升級Dataphin版本的操作可分為兩個主要步驟:選擇版本及升級模式、升級。在升級過程中,使用者可正常登入Dataphin,升級時將對Dataphin的應用進行滾動升級。完整流程如下圖:

image

操作步驟

步驟一:選擇版本及升級模式

  1. 在Dataphin的登入地址後補充輸入/opsconsole/v2,跳轉至Dataphin Manager的登入介面。

  2. 在Dataphin Manager的登入介面輸入使用者名稱密碼後,單擊登入(使用者名稱和密碼您可聯絡Dataphin營運人員擷取)。

  3. 升級記錄頁面單擊升級Dataphin

  4. 在升級Dataphin頁面中,選擇版本及升級模式。參數及說明如下表。

    參數

    說明

    目標版本

    在版本列表中選擇要升級到的目標版本。

    若版本列表中未包含所需的目標版本,可單擊上傳版本配置,上傳目標版本設定檔。

    設定檔上傳完成後,系統將進行設定檔校正。若配置檔案內容不正確,則校正不通過,系統將會報錯並展示失敗原因;若設定檔通過校正,且系統中尚未包含該版本的設定檔,此時繼續上傳將匯入該版本配置;若設定檔通過校正,且系統中已包含該版本的設定檔,此時繼續上傳將覆蓋系統配置

    設定檔

    • 標準化配置:單擊上傳檔案,上傳YAML或zip格式的設定檔。上傳後可下載設定檔。

      設定檔上傳完成後,系統將進行設定檔校正。若設定檔中未包含所有配置項,系統將會報錯,可單擊報錯資訊中的查看詳情,查看缺失配置項的列表。

    • 非標準化配置:在上傳檔案前,您可與Dataphin營運團隊溝通擷取所需的設定檔(zip格式)。單擊上傳檔案,上傳擷取到的設定檔。設定檔上傳完成後,系統將自動進行以下校正:

      • 設定檔中的版本標準化配置模板(product/dataphin/...)與上傳的版本配置是否相同(MD5校正一致)。若不一致,系統將提示:設定檔中的配置模板與選擇的版本不相容,建議您與Dataphin營運團隊進行確認,確認無誤後再繼續升級。

      • 設定檔中的overlay檔案values.yaml檔案版本標準化配置模板 (product/dataphin/...)是否相容。若不相容,系統將阻斷本次升級,並提示:設定檔中的配置資訊與選擇的版本不相容,無法繼續升級,請您與Dataphin營運團隊進行確認。

      • 設定檔中的values.yaml檔案與您當前線上環境中啟動並執行values.yaml檔案是否一致。若不一致,系統將提示:設定檔中的配置資訊與當前環境的線上配置不一致,繼續升級將使用新設定檔繼續升級。

      說明

      若無特殊情況,無需使用非標準化配置。

    升級模式

    選擇不停機升級。升級時,資料服務不停服,且資料服務API調用持續可用(包括同步調用和非同步呼叫)。

    通過目前的版本及目標版本的可相容性配置,來確認是否支援不停機升級。若不支援不停服升級,則預設選擇停服升級。

  5. 選中風險聲明後,單擊開始升級

步驟二:開始升級

系統升級進度由進度條展示,升級過程中可單擊查看日誌,查看升級日誌詳情。