集群 · ENVOY 智能代理中文參考文檔

## 集群 ``` { "name": "...", "type": "...", "connect_timeout_ms": "...", "per_connection_buffer_limit_bytes": "...", "lb_type": "...", "ring_hash_lb_config": "{...}", "hosts": [], "service_name": "...", "health_check": "{...}", "max_requests_per_connection": "...", "circuit_breakers": "{...}", "ssl_context": "{...}", "features": "...", "http2_settings": "{...}", "cleanup_interval_ms": "...", "dns_refresh_rate_ms": "...", "dns_lookup_family": "...", "dns_resolvers": [], "outlier_detection": "{...}" } ``` - **name** (required, string) 群集名稱，所提供群集名稱在所有群集中必須唯一。發布統計信息時會使用集群名稱。默認情況下，群集名稱的最大長度限制為60個字符。可通過`--max-obj-name-len`命令行參數設置為所需的值，以提高此限制。 - **type** (required, string) 用于解析集群的[服務發現類型](../../Introduction/Architectureoverview/Servicediscovery.md)。可能的選項有`static`，`strict_dns`，`logical_dns`，`original_dst`和`sds`。 - **connect_timeout_ms** (required, integer) 指定群集中主機網絡連接超時時間，以毫秒為單位。 - **per_connection_buffer_limit_bytes** (optional, integer) 集群連接的讀寫緩沖區大小限制。如果未指定，則默認值（1MB）。 - **lb_type** (required, string) 在集群中選擇主機時使用的[負載均衡器類型](../../Introduction/Architectureoverview/Loadbalancing.md)。可能的選項有`round_robin`，`least_request`，`ring_hash`，`random`和`original_dst_lb`。請注意，`original_dst_lb`必須與`original_dst`類型的集群一起使用，并且不能與其他任集群類型一起使用。 - **ring_hash_lb_config** (optional, object) 可選的[環哈希負載均衡器](Cluster/Ringhashloadbalancerconfiguration.md)配置，當`lb_type`設置為`ring_hash`時使用。 - **hosts** (sometimes required, array) 如果服務發現類型是`static`，`strict_dns`或`logical_dns`，則主機數組是必需的。主機數組不支持`original_dst`集群類型。指定方式由服務發現類型決于： - **static** 靜態集群，必須使用完整解析主機，不需要DNS查找。支持TCP和unix域套接字（UDS）地址。一個TCP地址如下所示： ``` tcp://<ip>:<port> ``` 一個UDS地址如下所示： ``` unix://<file name> ``` 以下示例指定地址列表： ``` [{"url": "tcp://10.0.0.2:1234"}, {"url": "tcp://10.0.0.3:5678"}] ``` - **strict_dns** 嚴格DNS群集類型，可以指定任意數量的主機名、端口組合。將使用DNS解析所有名稱，并組合在一起形成最終的群集。如果相同的名字返回多個記錄，則所有將被使用。例如： ``` [{"url": "tcp://foo1.bar.com:1234"}, {"url": "tcp://foo2.bar.com:5678"}] ``` - **logical_dns** 邏輯DNS群集類型，指定主機名稱方式與嚴格DNS非常類似，但只有第一個主機將被使用。例如： ``` [{"url": "tcp://foo1.bar.com:1234"}] ``` - **service_name** (sometimes required, string) 如果服務發現類型是[sds](../Clustermanager/Servicediscoveryservice.md)，則此參數是必需的。當獲取集群成員時，它將被傳遞給SDS API。 - **health_check** (optional, object) 可選的群集主動[健康檢查配置](Cluster/Healthchecking.md)。如果未指定配置，則不會執行健康檢查，并且所有群集成員都將始終處于健康狀態。 - **max_requests_per_connection** (optional, integer) 可選的單個上游連接的最大請求數。HTTP/1.1和HTTP/2連接池，都遵循此參數。如果沒有指定，則沒有限制。將此參數設置為1，將有效地禁用保活狀態的請求。 - **circuit_breakers** (optional, object) 可選的群集[熔斷配置](Cluster/Circuitbreakers.md)。 - **ssl_context** (optional, object) 上游群集的[TLS配置](Cluster/TLScontext.md)。如果沒有指定TLS配置，則新的連接將不會使用TLS。 - **features** (optional, string) 上游群集支持的功能，以逗號分隔的字符串列表。目前支持的功能為： - **http2** 如果指定了http2，Envoy將假定在建立新的HTTP連接時，支持HTTP/2。目前，Envoy僅支持上游連接的預知。即使TLS與ALPN一起使用，也必須指定http2。另外，這允許通過純文本建立HTTP/2連接。 - **http2_settings** (optional, object) 在啟動HTTP連接池時，直接傳遞給HTTP/2編解碼器的相關設置。這些與HTTP連接管理器[http2_settings](../../v1APIreference/Networkfilters/HTTPconnectionmanager.md)選項相同。 - **cleanup_interval_ms** (optional, integer) 從`original_dst`集群類型中刪除舊主機的時間間隔。如果主機在這段時間內，沒有被用作上游目的地址，則認為它們是舊的。隨著重定向到Envoy的新連接，新的主機被按需添加到原始目標集群中，從而導致集群中的主機數量隨著時間而增長。若沒有舊主機（它們被主動用作目的地址）被保存在群集中，從而允許與它們的連接保持打開狀態，從而節省了打開新連接所花費的等待時間。如果未指定此設置，則默認為5000.對于`original_dst`以外的群集類型，此設置將被忽略。 - **dns_refresh_rate_ms** (optional, integer) 如果指定了dns刷新率，并且群集類型為`strict_dns`或`logical_dns`，則將此值用作群集的dns刷新率。如果未指定此設置，則該值默認為5000。對于`strict_dns`和`logical_dns`以外的群集類型，此設置將被忽略。 - **dns_lookup_family** (optional, string) DNS IP地址解析策略。選項為`v4_only`，`v6_only`和`auto`。如果未指定此設置，則該值默認為`v4_only`。當選擇`v4_only`時，DNS解析器將僅執行IPv4系列的地址查找。如果選擇`v6_only`，則DNS解析程序將僅執行IPv6系列的地址查找。如果指定了`auto`，則DNS解析器將首先執行IPv6系列的地址查找操作，并然會再回到IPv4系列的地址查找。對于`strict_dns`和`logical_dns`以外的集群類型，該設置將被忽略。 - **dns_resolvers** (optional, array) 如果指定DNS解析程序，并且群集類型是`strict_dns`或`logical_dns`，則此值用于指定群集的dns解析程序。如果未指定此設置，則該值默認為使用`/etc/resolv.conf`配置的默認解析器。對于除`strict_dns`和`logical_dns`以外的集群類型，此設置將被忽略。 - **outlier_detection** (optional, object) 如果指定，則會為此上游群集啟用[異常值檢測](Cluster/Outlierdetection.md)。有關異常值檢測的更多信息，請參閱相應[架構概述](../../Introduction/Architectureoverview/Outlierdetection.md)。 ### 子章節 - [健康檢查](Cluster/Healthchecking.md) - [熔斷](Cluster/Circuitbreakers.md) - [TLS上下文](Cluster/TLScontext.md) - [異常值檢測](Cluster/Outlierdetection.md) - [環哈希負載均衡配置](Cluster/Ringhashloadbalancerconfiguration.md) ## 返回 - [上一級](../Clustermanager.md) - [首頁目錄](../../README.md)