Git 與交付 深入了解 C · 業界慣例 平台: 通用

Canary Deployment

金絲雀部署

金絲雀部署會先讓少量真實使用者或流量使用新版。觀察結果用來決定要擴大還是停止。

看看怎麼運作
也有人這樣說 Canary Deployment金絲雀發布小流量試放小批測試發布

看看怎麼運作

原創情境範例金絲雀部署
建置 → 執行 → 發布金絲雀部署stable + small canary share -> observe gates -> promote, pause, or abort
CHECKOUT V2CANARY · 5%
穩定版 v195%金絲雀 v25%
  1. ✓錯誤率0.3% ≤ 1%
  2. ✓p95 latency380 ≤ 500 ms
  3. ✓結帳成功率穩定
5% → 25% → 100%擴大或中止
結果通過檢查後,真實流量會從 5% 增加到 25%,最後到 100%。界線只推出少數執行個體還不算金絲雀部署。必須依觀察結果決定是否擴大。
stable + small canary share -> observe gates -> promote, pause, or abortOPS
金絲雀部署容器執行與漸進式交付

另一個例子

第 2 版先接收 5% 的結帳流量。團隊會觀察十分鐘的錯誤與延遲。任何一項超過上限就停止。

主要部分

  1. 01穩定版本
  2. 02金絲雀版本
  3. 03流量或使用者比例
  4. 04觀察時間
  5. 05成功與停止上限
  6. 06擴大或中止

什麼時候用

需要觀察正式環境的真實行為,而且能安全分流時,可以使用金絲雀部署。要定義對象、步驟、指標、上限、等待時間和回滾。

什麼時候不要用

不要把每次慢慢推出都叫做金絲雀部署。必須讓選定群組試用,並依結果決定是否擴大。

程式裡的名稱

stable + small canary share -> observe gates -> promote, pause, or abort

上線前要檢查

發布前核對正確的程式碼儲存庫、分支、目標與程式差異。保留尚未發布的工作,並通過審查與自動檢查(CI)。記錄衝突、資料遺失風險、發布順序、版本追查、復原與回復上一版的方法。

可以直接複製的需求

預期成果:用 金絲雀部署 (Canary Deployment) 安全交付或復原變更,並留下可查核記錄。 使用者情境:第 2 版先接收 5% 的結帳流量。團隊會觀察十分鐘的錯誤與延遲。任何一項超過上限就停止。 交付概念或操作:金絲雀部署 (Canary Deployment)。 適用理由:需要觀察正式環境的真實行為,而且能安全分流時,可以使用金絲雀部署。要定義對象、步驟、指標、上限、等待時間和回滾。 不應使用的情況:不要把每次慢慢推出都叫做金絲雀部署。必須讓選定群組試用,並依結果決定是否擴大。 交付要求:指出程式碼儲存庫與目標。列出前置條件、變更內容、審查與自動檢查(CI)、衝突和資料遺失風險、發布順序,以及復原或回復上一版的指令。 儲存庫防護:保留尚未發布的工作與可查核歷史。沒有明確備份時,不可執行破壞性操作。發布前核對精確的程式差異與遠端儲存庫目標。 驗收條件:預期的程式差異已審查,必要檢查已通過。目標版本可追查,失敗復原已演練,發布歷史也可查核。 證據與限制(證據邊界):沒有一份官方標準能管到全部內容。不同團隊、平台或框架的用法可能不同。 待確認:程式碼儲存庫與分支、協作狀態、發布環境、核准負責人、受保護的檢查,以及要回復的版本。

檢查這份需求

請 AI 程式助手檢查目前如何使用 金絲雀部署 (Canary Deployment)。 定義:金絲雀部署會先讓少量真實使用者或流量使用新版。觀察結果用來決定要擴大還是停止。 正式環境檢查:發布前核對正確的程式碼儲存庫、分支、目標與程式差異。保留尚未發布的工作,並通過審查與自動檢查(CI)。記錄衝突、資料遺失風險、發布順序、版本追查、復原與回復上一版的方法。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。

C
這個術語有多正式?

業界慣例

工作上常會用到這個術語。列出的來源可能說明用法或限制,但不會定義全部內容。

沒有一份官方標準能管到全部內容。不同團隊、平台或框架的用法可能不同。

適用範圍
只包含來源有說明的內容:正式名稱、定義、平台 API、實作、使用指南、避免事項
文件狀態
穩定
查證日期
2026-07-30

證據來源與適用範圍

正式來源 + 術語參考資料 · Argo Rollouts · 穩定 Canary Deployment Strategy 適用範圍: 正式名稱、定義、平台 API、實作、使用指南、避免事項 本頁用途: 直接術語參考 來源涵蓋內容: 正式名稱, 定義, 平台 API, 實作, 使用指南, 避免事項

自行複製

瀏覽器無法自動複製。請選取下方文字,再自行複製。