適用於:基本 |標準 |獎賞
本文說明如何在 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 點。
在更新期間,服務中斷很少見,但您可能想要藉由選取低服務使用時間來降低風險。 例如,針對生產實例,請在工作日晚上和週末早上設定維護期間。
設定服務更新設定
- 登入 Azure 入口網站 ,並移至您的 API 管理實例。
- 在左側功能表中,選取 [部署 + 基礎結構>服務更新設定]。
- 在 [更新群組] 底下,檢閱目前的設定,然後選取 [ 編輯 ] 加以變更。
- 在 [維護] 視窗底下,檢閱目前的設定,然後選取 [ 編輯 ] 以變更它們。 每天你可以選擇預設視窗、不同的標準視窗,或是按天自訂視窗。
知道你的實例何時收到更新
以下是您可以了解預期或正在進行的服務更新的方法。
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 區域之後收到更新,但部署會更可能識別服務設定特有的迴歸。
在區域中部署重複的實例 - 如果您的生產工作負載是在特定區域中的高階層實例,請考慮在較低層,但能較早接收更新的實例中部署相似的設定。 例如,在開發人員層中設定生產前實例來驗證更新。
相關內容
- 瞭解如何監視 API 管理實例。
- 了解監控 API 管理實例的其他選項。