執行期匹配器 (proto)

此擴展的合格名稱為 envoy.matching.matchers.runtime_fraction

注意

此擴展旨在針對不受信任的下游和上游流量具有強大的防禦能力。

提示

此擴展擴展並可與以下擴展類別一起使用

• envoy.matching.input_matchers

此擴展必須使用以下類型 URL 之一進行配置

• type.googleapis.com/envoy.extensions.matching.input_matchers.runtime_fraction.v3.RuntimeFraction

extensions.matching.input_matchers.runtime_fraction.v3.RuntimeFraction

[extensions.matching.input_matchers.runtime_fraction.v3.RuntimeFraction proto]

執行期比例匹配器會從輸入計算雜湊值，如果針對產生的雜湊啟用了執行期功能，則進行匹配。每次考慮輸入進行匹配時，其雜湊值必須落在此欄位指示的匹配百分比內。對於分數 N/D，數字計算為輸入的雜湊，其範圍為 [0,D)。如果數字小於或等於分子 N 的值，則匹配器評估為 true。執行期比例輸入匹配器可用於逐步推出匹配器變更，而無需完全的程式碼或組態部署。請注意，匹配結果的分佈僅與輸入之一一樣好。

{
  "runtime_fraction": {...},
  "seed": ...
}

runtime_fraction

(config.core.v3.RuntimeFractionalPercent, 必要) 根據給定的執行期金鑰匹配輸入。如果執行期組態中不存在金鑰，則使用指定的預設值。

seed

(uint64) 可選的種子，透過雜湊函數傳遞。這允許在計算雜湊值時使用其他資訊：透過變更種子值，可以針對相同的輸入達成可能不同的結果。