Canary Strategy · 灰度策略

---
doc_type: "canary-strategy"
variant: "light"
status: "draft"
owner: "<your-name>"
last_updated: "YYYY-MM-DD"
upstream:
  required: ["slo", "release-plan"]
  optional: ["business-kpi"]
---

# Canary Strategy: <release-name>

**Status:** Draft v0.X · **Owner:** <DevOps name> · **Last updated:** YYYY-MM-DD

> [!IMPORTANT]
> **AI 填寫規則：** 本範本 6 段（編號 1, 2, 3, 5, 7, 10），全部必填——刻意沿用完整版的章節編號讓兩版可對照。每結論行內加 `（依據：slo §XXX / kpi §YYY）`；每量化欄位加 `[H]/[M]/[L]` confidence badge；缺資料寫 `_TODO: 需要 XXX_` 不編造；每階段 success criteria 必須同時含 1 個 SLI + 1 個業務 KPI。

---

## 1. Executive Summary

<!-- ai-fill: 3-5 行，on-call SRE 30 秒讀完。寫「灰度幾階段、總時長、最大 blast radius」 -->

<3-5 行說明>

> **TL;DR:** <一句話：階段切分 + 總 bake time + abort 觸發>

---

## 2. Stages

<!-- ai-rule: 3-4 階段為宜（例：1% → 5% → 25% → 100%）。每階段必含 traffic % / duration / population -->

| Stage | Traffic % | Duration | Population | Promote gate | Confidence |
|---|---|---|---|---|---|
| 1 | 1% | 30 min | internal-only | auto (SLI pass) | **[H]** |
| 2 | 5% | 2 hr | <geo / cohort> | auto | **[H]** |
| 3 | 100% | — | all | manual | **[M]** |

---

## 3. Success Criteria per Stage

<!-- ai-rule: 每階段同時含 SLI 門檻 + 業務 KPI 門檻，避免只看 5xx 不看 conversion -->

### Stage 1

- **SLI:** error_rate < 1% · p95 latency < 200ms · saturation < 70% **[H]**
- **Business KPI:** conversion_delta ≥ -2% vs baseline **[M]**
- **Source:** slo §XXX + kpi §YYY

### Stage 2 / 3

<同格式>

---

## 5. Abort Signals

<!-- ai-rule: 區分 hard_abort（立即退回）與 soft_abort（暫停觀察）；hard 必須含 SLI 急速劣化條件 -->

- **Hard abort（立即退回）：**
  - error_rate > 5% for 1 min
  - p95 latency > baseline × 2 for 2 min
- **Soft abort（暫停觀察）：**
  - conversion 下滑 > 5% for 10 min

---

## 7. Blast Radius per Stage

<!-- ai-rule: 每階段估算 affected_users 數量；高風險 cohort 單獨列 -->

| Stage | Affected users | Affected features | Confidence |
|---|---|---|---|
| 1 | ~<N> internal | <feature list> | **[H]** |
| 2 | ~<N> external | ... | **[M]** |

---

## 10. Decision Log（key 2-3 條）

<!-- ai-rule: 每條必含 chosen + 至少 1 個 rejected option + 拒絕原因 -->

| Date | Decision | Options | Chosen | Rejected why | Confidence |
|---|---|---|---|---|---|
| YYYY-MM-DD | 階段切分節奏 | 1/5/25/100 vs 5/50/100 | 1/5/25/100 | 5/50 跳太快、blast radius 超出 error budget | **[H]** |

---

> [!CAUTION]
> **輸出前 AI 自檢：**
> - [ ] 6 段 H2 章節齊全（編號 1, 2, 3, 5, 7, 10）
> - [ ] 每階段 success criteria 同時含 SLI + 業務 KPI
> - [ ] Abort signals 區分 hard / soft
> - [ ] Blast radius 每階段都有 affected_users 估算
> - [ ] Decision Log ≥ 1 條，含 rejected reason
> - [ ] 無 YAML / JSON schema 輸出