共用方式為


設定您的 API 管理實例的服務更新設定

適用於:基本 |標準 |獎賞

本文說明如何在 API 管理實例中設定 服務更新 設定(預覽)。 Azure 會定期透過分階段部署方式,自動為 API Management 實例套用服務更新。 這些更新包括新功能、安全性增強功能和可靠性改善。

你無法精確控制 Azure 何時更新每個 API Management 實例,但在特定服務層級中,你可以選擇更新 群組 ,讓它在更新推出期間收到更新的時間比平常早或晚。 您也可以在想要實例接收更新的一天中設定 維護期間

更新群組

更新群組(也稱為 發行通道)是一組在生產部署期間接收更新的 API 管理服務的實例,該更新可能持續數天至數週不等。

更新群組 Description
AI Gateway 早期版本 (GenAI 發布管道) 在最新的 AI 介面功能和更新發布到其他更新群組之前,優先存取最新版。

結合最穩定的主線服務更新與最新的 AI 專屬功能。 作為 晚期 更新群組的一部分,接收其他服務更新,促進 AI 相關功能的快速部署。
早期 在推出初期就收到更新,方便測試並搶先體驗新功能。 此選項不建議用於生產部署。
預設值 作為定期發行的一部分,會收到更新。 建議針對大部分服務使用此選項,包括生產部署。
延遲 更新通常比前一組晚,通常是在初次推出後數週。 只有任務關鍵性部署才建議使用此選項。

備註

  • Azure 透過 安全部署實踐(SDP)框架部署所有更新。 推出初期發行的更新可能較不穩定,稍後會由穩定版本取代。 所有實例最終都會更新為最穩定的發行組建。
  • 所有更新群組都可以在預覽版中包含功能。 預覽功能在 Azure 入口網站和文件中有明確標示。
  • 功能依序在更新群組中傳播: AI Gateway 早期 (僅限 AI 功能)→ 早期預設晚期

例如,您可能想要將測試實例新增至 早期 更新群組。 此實例會在您用於生產的實例之前接收更新,這些實例位於 預設延遲 更新群組中。 您可以監視測試實例,以尋找更新到達生產實例之前所造成的任何問題。 使用 API 管理深入瞭解 Canary 部署

維護時間範圍

維護時段是指每天 8 小時的時間段,讓你的實例能收到更新。 根據預設,實例時區中的維護時間範圍是下午 10 點到 6 點。

在更新期間,服務中斷很少見,但您可能想要藉由選取低服務使用時間來降低風險。 例如,針對生產實例,請在工作日晚上和週末早上設定維護期間。

設定服務更新設定

  1. 登入 Azure 入口網站 ,並移至您的 API 管理實例。
  2. 在左側功能表中,選取 [部署 + 基礎結構>服務更新設定]。
  3. [更新群組] 底下,檢閱目前的設定,然後選取 [ 編輯 ] 加以變更。
  4. [維護] 視窗底下,檢閱目前的設定,然後選取 [ 編輯 ] 以變更它們。 每天你可以選擇預設視窗、不同的標準視窗,或是按天自訂視窗。

知道你的實例何時收到更新

以下是您可以了解預期或正在進行的服務更新的方法。

  • API 管理更新會在 API 管理 GitHub 存放庫上宣佈。 訂閱此儲存庫的通知,以瞭解何時開始更新發布。

  • 使用 Azure 活動日誌 來監控 API Management 實例中發生的服務更新。 當更新開始時,就會發出「排程維護」事件。

    入口網站中活動記錄中的預定維護事件。

    若要自動接收通知,請在活動記錄檔上 設定警示

  • 根據預設,更新會在下列階段推出至區域:Azure EUAP 區域,後面接著美國中西部,接著幾個後續階段的剩餘區域。 在後續部署階段中更新的區域順序,因不同的服務而有差異。 在每個產品部署階段之間,您可以預期至少 24 小時的間隔。

  • 在某一區域內,高級層的 API 管理實例接收更新的時間會比其他服務層級晚數小時。

小提示

如果您的 API 管理實例部署至多個位置(區域),更新的時間取決於實例 的主要 位置。

Canary 部署策略

您可以使用指派給特定更新群組的 API 管理實例(如果有該選項可用),或部署在特定 Azure 區域中,作為早於生產實例接收更新的 Canary 部署。

  • 將實例新增至早期更新群組 - 使用早期更新群組中的 API 管理實例,在生產推出初期驗證更新。 此執行個體實際上是您的 Canary 部署。

  • 在 Canary 區域中部署 - 如果您有 Azure EUAP 區域的存取權,請在將更新發行至生產管線時,使用該處的實例來驗證更新。 瞭解 Azure 區域存取要求程式

    備註

    由於 EUAP 區域中的容量限制,您可能無法視需要調整 API 管理實例。

  • 部署在試驗區域中 - 使用美國中西部的實例來模擬您的生產環境,或在生產環境中用於非關鍵 API 流量。 雖然此區域會在 EUAP 區域之後收到更新,但部署會更可能識別服務設定特有的迴歸。

  • 在區域中部署重複的實例 - 如果您的生產工作負載是在特定區域中的高階層實例,請考慮在較低層,但能較早接收更新的實例中部署相似的設定。 例如,在開發人員層中設定生產前實例來驗證更新。