服務發現 · ENVOY 智能代理中文參考文檔

## 服務發現 - [LbEndpoint](#lbendpoint) - [LocalityLbEndpoints](#localitylbendpoints) - [ClusterLoadAssignment](#clusterloadassignment) - [ClusterLoadAssignment.Policy](#clusterloadassignmentpolicy) ### LbEndpoint [LbEndpoint proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/eds.proto#L62) EndPoint是指Envoy可以將流量路由到的端口。 ``` { "endpoint": "{...}", "metadata": "{...}", "load_balancing_weight": "{...}" } ``` - **endpoint** ([Endpoint](../v2APIreference/Commontypes.md)) 上游主機標識符 - **metadata** ([Metadata](../v2APIreference/Commontypes.md)) 負載均衡端口元數據是指可用于為請求選擇群集中的端口。過濾器名稱應該指定為`envoy.lb`。一個bool類型的鍵值對例子為`canary`，提供上游主機的可選`canary`狀態。這可以在路由的`ForwardAction` `metadata_match`字段中匹配，以在集群負載平衡中考慮的端口子集。 - **load_balancing_weight** ([UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#uint32value)) 上游主機的可選負載平衡權重，范圍為1~128. 在某些內置Envoy負載平衡器中，會使用負載平衡權重。端口的負載平衡權重除以本地所有端口權重的總和，以獲得端口的所占通信量百分比。然后這個百分比再由來自`LocalityLbEndpoints`的端點的本地負載平衡權重加權。如果沒有指定，每個主機被假定在一個地方具有相同的權重。注意：當前128的限制是有些隨意，但是考慮當前實現的性能問題而使用，若解決這個問題是可以取消這個限制。 ### LocalityLbEndpoints [LocalityLbEndpoints proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/eds.proto#L100) 一組端口歸屬一個局部負載均衡器。一個本地可以有多個局部負載均衡器，通常只有在不同的組之間需要負載平衡權重或不同的優先級時，才會使用多個組。 ``` { "locality": "{...}", "lb_endpoints": [], "load_balancing_weight": "{...}", "priority": "..." } ``` - **locality** ([Locality](../v2APIreference/Commontypes.md)) 標識上游主機運行的位置。 - **lb_endpoints** ([LbEndpoint](#lbendpoint)) 所屬的端口組配置。 - **load_balancing_weight** ([UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#uint32value)) 可選：配置每個端口組的優先級、`region`、`zone`、`sub_zone`權重，范圍1~128。一個端口組的負載均衡權重除以相同優先級的所有權重之和，獲得該端口組的承載業務有效百分比。必須為相同優先級的所有局部端口組指定權重，若不指定，則認為每個局部在群集中具有相同的權重。注意：當前128的限制是有些隨意，但是考慮當前實現的性能問題而使用，若解決這個問題是可以取消這個限制。 - **priority** ([uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 可選：此局部負載均衡端口組的優先級。如果未指定，則默認為最高優先級（0）。一般情況下，Envoy只會選擇最高優先級（0）的端口。如果該優先級的所有端口不可用/不健康，Envoy將快速故障恢復至下一個最高優先級的端口組。優先級應該配置為從0（最高）到N（最低），中間沒有間隔。 ### ClusterLoadAssignment [ClusterLoadAssignment proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/eds.proto#L244) 從RDS中獲取的路由，映射到單個集群或者使用RDS集群權重實現跨集群的流量拆分。使用EDS，每個集群都有獨立的LB進行處理，將在集群內的產生局部LB，即在一個局部主機之間具有更細粒度的LB。對于給定的集群，主機的有效權重是其`load_balancing_weight`乘以其局部的LB權重`load_balancing_weight`。 ``` { "cluster_name": "...", "endpoints": [], "policy": "{...}" } ``` - **cluster_name** ([string](https://developers.google.com/protocol-buffers/docs/proto#scalar), REQUIRED) 集群的名稱。如果在集群[EdsClusterConfig](../v2APIreference/ClustersandCDS.md)中指定，則是`service_name`值。 - **endpoints** ([LocalityLbEndpoints](#localitylbendpoints)) 對應的局部端口組列表。 - **policy** ([ClusterLoadAssignment.Policy](#clusterloadassignmentpolicy)) 負載均衡策略設置。 ### ClusterLoadAssignment.Policy [ClusterLoadAssignment.Policy proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/eds.proto#L255) 負載平衡策略設置。 ``` { "drop_overload": "..." } ``` - **drop_overload** ([double](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 應該丟棄的流量（0-100）的百分比。如果上游主機無法從down機中恢復，或者無法進行自動調整，則需要對上游主機進行保護，因此需要修整整個傳入流量以保護它們。注意：v2 API與v1 API存在差異，在v1中被稱為維護模式。 ## 返回 - [上一級](../v2APIreference.md) - [首頁目錄](../README.md)