launchdarkly-guarded-rollout 是做什麼的？
設定具備漸進式流量增加、指標監控與自動回滾功能的受防護發布。適用於在安全閾值下逐步釋出功能。
概述
此技能讓您能夠使用 LaunchDarkly 功能旗標來設定受防護的逐步發布。您可定義階段性的流量遞增計畫，指定每個階段的目標流量百分比、持續時間，以及用於監控的關鍵業務指標。若任何指標超出定義的安全閾值，發布將自動回滾至先前的穩定版本。
使用方式
若要使用此技能，請提供 LaunchDarkly 環境的 API 金鑰與項目金鑰，並指定要發布的功能旗標名稱。技能將根據您的設定自動建立或更新旗標的釋出階段。
支援的步驟
- 定義階段：設定每個階段的流量百分比（例如 10%、25%、50%、100%）與持續時間。
- 設定指標：選擇要監控的 LaunchDarkly 指標（如錯誤率、延遲、自訂事件）。
- 設定閾值：為每個指標指定觸發回滾的臨界值。
- 執行發布：觸發受防護的逐步發布，技能將在背景持續監控。
- 自動回滾：若任何指標超出閾值，則自動將流量恢復至 0%。
範例
以下範例演示如何設定一個受防護的逐步發布：
phases:
- percentage: 10
duration: 30m
metrics:
- name: error-rate
threshold: 0.05
comparison: greater-than
- percentage: 25
duration: 1h
metrics:
- name: error-rate
threshold: 0.05
comparison: greater-than
- percentage: 50
duration: 2h
metrics:
- name: latency-p99
threshold: 200
comparison: greater-than
- percentage: 100
duration: 24h
metrics:
- name: error-rate
threshold: 0.03
comparison: greater-than
環境變數
| 變數名稱 | 說明 |
|---|---|
LAUNCHDARKLY_SDK_KEY | LaunchDarkly SDK 金鑰，用於驗證 API 請求 |
LAUNCHDARKLY_PROJECT_KEY | 目標項目的金鑰 |
LAUNCHDARKLY_FLAG_KEY | 要執行發布的功能旗標金鑰 |
注意事項
- 確保已安裝 LaunchDarkly SDK 並在環境中正確設定憑證。
- 設定閾值時，建議先以較寬鬆的條件開始測試，再逐步調整。
- 自動回滾僅會影響受監控的發布階段；若需完全取消發布，請手動介入。