全部產品
Search
文件中心

:設定無損上下線

更新時間:Jan 28, 2026

在執行個體擴縮容、應用復原升級、應用啟停等情境中,應用可能會出現短時間內服務不可用等異常情況。Serverless 應用引擎 SAE(Serverless App Engine)整合了Microservices Engine (MSE)的無損上下線功能,通過服務預熱、服務延遲註冊等功能,為應用提供業務保障。

背景資訊

  • 無損上線:

    對於任何一個線上應用來說,發布、擴容、縮容、重啟等操作不可避免。在應用啟動各階段,無損上線能夠提供相應的保護能力。微服務的Provider服務只要註冊到註冊中心即可被Consumer調用,但此時,Provider可能還需要更進一步的初始化,例如資料庫連接池的初始化等。因此,對於流量比較大的微服務應用,推薦開啟無損上線功能。

  • 無損下線:

    線上應用在服務更新部署過程中,需要盡量保證用戶端無感知,即從應用停止到重啟恢複服務的階段不能影響正常的業務請求。由於微服務應用自身調用特點,在高並發下,服務提供端應用執行個體的直接下線,會導致服務消費端應用執行個體無法即時感知下遊執行個體的即時狀態,因而出現繼續將請求轉寄到已下線的執行個體,從而出現請求報錯,導致流量有損。因此,在應用執行部署、停止、復原、縮容和重設時,需要通過無損下線配置來保證應用正常關閉。

前提條件

  • 已通過鏡像或程式碼封裝部署Java應用。具體操作,請參見應用部署目錄下的文檔。

    重要
    • 僅適用於2023年11月08日起建立的微服務應用。

    • 微服務治理只適用於Java應用。

  • 開通MSE微服務治理專業版

    說明

    使用MSE時會產生單獨費用。MSE的計費說明,請參見微服務治理計費概述

功能入口

  1. SAE應用列表中,在頂部選擇目標地區和命名空間,點擊目標應用ID跳轉到應用詳情頁。

  2. 點擊微服務治理 > 流量治理,點擊無損上下線

設定無損上下線

  1. 無損上下線頁面,配置相關資訊。

    重要
    • 如果您是第一次使用該功能,需要在該頁面單擊開啟微服務治理重新整理頁面,才能配置無損上下線。

    • 開啟過程大約需要1~2分鐘,請您耐心等待。

    無損上線

    無損上線地區,開啟無損上線的開關,然後配置一下資訊。

    配置項

    說明

    延遲註冊時間(秒)

    設定服務註冊的延遲時間。該參數可以將原本服務註冊時間往後延遲指定時間長度。如果您的應用在啟動後有耗時較長的非同步資源載入過程,可以通過該參數調節新上線節點的服務註冊行為,以延遲其收到調用請求的時機。

    重要

    延遲註冊時間長度不為0時,必須在應用部署中配置readiness(就緒檢查),訪問路徑設定為/readiness,且連接埠設定為54199(開啟微服務治理以後,agent會自動監聽54199連接埠,不需要您在應用程式中監聽該連接埠),以保證服務完全註冊到註冊中心後,Kubernetes才認定該服務為就緒狀態。這一措施能有效避免因服務消費者找不到可用服務提供者而導致的入流量驟降問題。至關重要的是,切忌將LivenessProbe(存活探針)設定為同一路徑/readiness,因為這樣做可能引發應用不斷重啟的死迴圈狀況。配置應用業務就緒檢查的具體步驟,請參見設定健全狀態檢查

    小流量預熱時間長度(秒)

    開啟進階選項,設定小流量預熱時間長度。流量預熱機制是為了確保新節點加入時,初期分配給該節點的微服務調用流量維持在較低水平,並隨著時間平緩增加。這樣設計是為了緩解Java應用冷啟動期間處理能力較弱的問題,防止系統整體回應時間(RT)顯著上升。預熱過程將在預設的時間長度結束後自動終止,之後該節點將正常承載全量流量。

    無損下線

    接入MSE後,無損下線預設開啟。

    如果開啟主動通知開關,節點在下線時會主動通知消費者自身已經下線,避免消費者調用到該節點。預設情況下無需開啟,如果應用使用的是Spring Cloud架構,並且發現應用在下線過程中有消費者調用出錯的情況,可以嘗試開啟該功能來解決。

關閉無損上下線

  • 無損上線

    在目標應用的左側導覽列,選擇微服務治理 > 流量治理,單擊無損上下線頁簽,然後在無損上線地區,關閉開關。

  • 無損下線

    無損下線功能接入MSE後預設開啟,不支援單獨關閉。

如果您無需使用微服務治理功能,為避免產生不必要的MSE費用,可以在應用基本資料頁面右上方,選擇更多 > 關閉微服務治理,根據頁面提示資訊,關閉微服務治理功能。

警告

關閉微服務治理功能後,除服務列表外,其他微服務治理功能(包括無損上下線、灰階規則和限流降級)將無法使用,且關閉過程中會觸發一次應用重啟,請自行判斷業務風險後再進行操作。