update service discovery content based on v1.9 doc

allenlsy · allenlsy · commit f3cfcc1180b7 · 2018-10-10T21:21:15.000-07:00
diff --git a/intro/arch_overview/service_discovery.md b/intro/arch_overview/service_discovery.md
@@ -22,15 +22,22 @@
 
 &#24403;&#20256;&#20837;&#36830;&#25509;&#36890;&#36807; iptables &#37325;&#23450;&#21521;&#25110; TPROXY&#65288;&#26597;&#30475;&#30495;&#23454; IP &#65289;&#30446;&#26631;&#25110;&#20351;&#29992;&#20195;&#29702;&#21327;&#35758;&#37325;&#23450;&#21521;&#21040; Envoy &#26102;&#65292;&#21487;&#20197;&#20351;&#29992;&#21407;&#22987;&#30446;&#26631;&#38598;&#32676;&#12290;&#22312;&#36825;&#20123;&#24773;&#20917;&#19979;&#65292;&#20351;&#29992;&#20803;&#25968;&#25454;&#37325;&#23450;&#21521;&#30340;&#31574;&#30053;&#20250;&#20351;&#36335;&#30001;&#21040;&#21407;&#22987;&#30446;&#26631;&#38598;&#32676;&#30340;&#35831;&#27714;&#36716;&#21457;&#21040;&#19978;&#28216;&#20027;&#26426;&#65292;&#24182;&#19988;&#19981;&#38656;&#35201;&#20219;&#20309;&#26126;&#30830;&#30340;&#20027;&#26426;&#37197;&#32622;&#25110;&#19978;&#28216;&#20027;&#26426;&#21457;&#29616;&#26426;&#21046;&#12290;&#19982;&#19978;&#28216;&#20027;&#26426;&#30340;&#36830;&#25509;&#20250;&#34987;&#25918;&#20837;&#38142;&#25509;&#65292;&#24182;&#19988;&#38386;&#32622;&#30340;&#20027;&#26426;&#22312;&#31354;&#38386;&#26102;&#38388;&#27604; [cleanup_interval_ms](https://www.envoyproxy.io/docs/envoy/latest/api-v1/cluster_manager/cluster#config-cluster-manager-cluster-cleanup-interval-ms) &#38271;&#65288;&#40664;&#35748;&#20540;&#20026;5000 ms&#65289;&#26102;&#20250;&#34987;&#21047;&#26032;&#12290;&#22914;&#26524;&#21407;&#22987;&#30446;&#26631;&#22320;&#22336;&#19981;&#21487;&#29992;&#65292;&#21017;&#19981;&#20250;&#25171;&#24320;&#19978;&#28216;&#36830;&#25509;&#12290;&#36825;&#31181;&#21407;&#22987;&#30446;&#30340;&#22320;&#26381;&#21153;&#21457;&#29616;&#30340;&#26041;&#24335;&#24517;&#39035;&#19982;&#21407;&#22987;&#30446;&#30340;&#22320;[&#36127;&#36733;&#22343;&#34913;](load_balancing.md#arch-overview-load-balancing-types-original-destination)&#19968;&#36215;&#20351;&#29992;&#12290;
 
+### &#32456;&#31471;&#21457;&#29616;&#26381;&#21153; (Endpoint Discovery Service)
 
-### &#26381;&#21153;&#21457;&#29616;&#26381;&#21153;&#65288;SDS&#65289;
-Envoy &#36890;&#36807;&#19968;&#20010;*&#21457;&#29616;&#26381;&#21153;&#30340;&#26381;&#21153;*&#33719;&#21462;&#38598;&#32676;&#25104;&#21592;&#65292;&#23427;&#26159;&#19968;&#20010; [REST &#39118;&#26684;&#30340; API](https://www.envoyproxy.io/docs/envoy/latest/api-v1/cluster_manager/sds#config-cluster-manager-sds-api)&#12290;Lyft &#25552;&#20379;&#20102;&#22522;&#20110; Python &#35821;&#35328;&#30340; [&#21457;&#29616;&#26381;&#21153;](https://github.com/lyft/discovery)&#21442;&#32771;&#23454;&#29616;&#12290;&#35813;&#23454;&#29616;&#20351;&#29992; AWS DynamoDB &#20316;&#20026;&#23384;&#20648;&#31867;&#22411;&#65292;&#20294;&#35813; API &#38750;&#24120;&#31616;&#21333;&#65292;&#21487;&#20197;&#36731;&#26494;&#22320;&#22312;&#21508;&#31181;&#19981;&#21516;&#30340;&#23384;&#20648;&#31867;&#22411;&#20043;&#19978;&#23454;&#26045;&#12290;&#23545;&#20110;&#27599;&#20010; SDS &#38598;&#32676;&#65292;Envoy &#23558;&#23450;&#26399;&#20174;&#21457;&#29616;&#26381;&#21153;&#20013;&#33719;&#21462;&#38598;&#32676;&#25104;&#21592;&#12290;&#30001;&#20110;&#20197;&#19979;&#20960;&#20010;&#21407;&#22240;&#65292;SDS &#26159;&#39318;&#36873;&#30340;&#26381;&#21153;&#21457;&#29616;&#26426;&#21046;&#65306;
+&#32456;&#31471;&#21457;&#29616;&#26381;&#21153;(EDS)&#26159;&#19968;&#20010;&#23621;&#20110; gRPC &#25110; REST-JSON API &#26381;&#21153;&#22120;&#30340; xDS &#31649;&#29702;&#26381;&#21153;&#65292;&#22312; Envoy &#20013;&#29992;&#26469;&#33719;&#21462;&#38598;&#32676;&#25104;&#21592;&#12290;&#38598;&#32676;&#25104;&#21592;&#22312; Envoy &#30340;&#26415;&#35821;&#20013;&#34987;&#31216;&#20026;&ldquo;&#32456;&#31471;&rdquo;&#12290;&#23545;&#20110;&#27599;&#20010;&#38598;&#32676;&#65292;Envoy &#37117;&#20250;&#36890;&#36807;&#21457;&#29616;&#26381;&#21153;&#26469;&#33719;&#21462;&#25104;&#21592;&#30340;&#32456;&#31471;&#12290;&#30001;&#20110;&#20197;&#19979;&#20960;&#20010;&#21407;&#22240;&#65292;EDS &#26159;&#39318;&#36873;&#30340;&#26381;&#21153;&#21457;&#29616;&#26426;&#21046;&#65306;
 
 - Envoy &#23545;&#27599;&#20010;&#19978;&#28216;&#20027;&#26426;&#37117;&#26377;&#26126;&#30830;&#30340;&#20102;&#35299;&#65288;&#19982;&#36890;&#36807; DNS &#35299;&#26512;&#30340;&#36127;&#36733;&#22343;&#34913;&#36827;&#34892;&#36335;&#30001;&#30456;&#27604;&#32780;&#35328;&#65289;&#65292;&#24182;&#21487;&#20197;&#20570;&#20986;&#26356;&#26234;&#33021;&#30340;&#36127;&#36733;&#22343;&#34913;&#20915;&#31574;&#12290;
 - &#22312;&#27599;&#20010;&#20027;&#26426;&#30340;&#21457;&#29616; API &#21709;&#24212;&#20013;&#25658;&#24102;&#30340;&#39069;&#22806;&#23646;&#24615;&#36890;&#30693; Envoy &#36127;&#36733;&#22343;&#34913;&#26435;&#37325;&#12289;&#37329;&#19997;&#38592;&#29366;&#24577;&#12289;&#21306;&#22495;&#31561;&#12290;&#36825;&#20123;&#38468;&#21152;&#23646;&#24615;&#22312;&#36127;&#36733;&#22343;&#34913;&#12289;&#32479;&#35745;&#20449;&#24687;&#25910;&#38598;&#31561;&#36807;&#31243;&#20013;&#20250;&#34987; Envoy &#32593;&#26684;&#20840;&#23616;&#20351;&#29992;&#12290;
 
 &#36890;&#24120;&#65292;&#20027;&#21160;&#20581;&#24247;&#26816;&#26597;&#19982;&#26368;&#32456;&#19968;&#33268;&#30340;&#26381;&#21153;&#21457;&#29616;&#26381;&#21153;&#25968;&#25454;&#32467;&#21512;&#20351;&#29992;&#65292;&#20197;&#36827;&#34892;&#36127;&#36733;&#22343;&#34913;&#21644;&#36335;&#30001;&#20915;&#31574;&#12290;&#36825;&#23558;&#22312;&#19979;&#19968;&#33410;&#20013;&#36827;&#19968;&#27493;&#35752;&#35770;&#12290;
 
+
+### &#26381;&#21153;&#21457;&#29616;&#26381;&#21153;&#65288;v1 SDS&#65289;
+
+> (&#24323;&#29992;) &#36825;&#20010;&#21457;&#29616;&#26381;&#21153;&#22312; v2 xDS API &#20013;&#20250;&#34987;&#32456;&#31471;&#21457;&#29616;&#26381;&#21153;&#21462;&#20195;
+
+Envoy &#36890;&#36807;&#19968;&#20010;*&#21457;&#29616;&#26381;&#21153;&#30340;&#26381;&#21153;*&#33719;&#21462;&#38598;&#32676;&#25104;&#21592;&#65292;&#23427;&#26159;&#19968;&#20010; [REST &#39118;&#26684;&#30340; API](https://www.envoyproxy.io/docs/envoy/latest/api-v1/cluster_manager/sds#config-cluster-manager-sds-api)&#12290;Lyft &#25552;&#20379;&#20102;&#22522;&#20110; Python &#35821;&#35328;&#30340; [&#21457;&#29616;&#26381;&#21153;](https://github.com/lyft/discovery)&#21442;&#32771;&#23454;&#29616;&#12290;&#35813;&#23454;&#29616;&#20351;&#29992; AWS DynamoDB &#20316;&#20026;&#23384;&#20648;&#31867;&#22411;&#65292;&#20294;&#35813; API &#38750;&#24120;&#31616;&#21333;&#65292;&#21487;&#20197;&#36731;&#26494;&#22320;&#22312;&#21508;&#31181;&#19981;&#21516;&#30340;&#23384;&#20648;&#31867;&#22411;&#20043;&#19978;&#23454;&#26045;&#12290;&#23545;&#20110;&#27599;&#20010; SDS &#38598;&#32676;&#65292;Envoy &#23558;&#23450;&#26399;&#20174;&#21457;&#29616;&#26381;&#21153;&#20013;&#33719;&#21462;&#38598;&#32676;&#25104;&#21592;&#12290;
+
 ## &#20851;&#20110;&#26381;&#21153;&#21457;&#29616;&#30340;&#26368;&#32456;&#19968;&#33268;&#24615;
 
 &#35768;&#22810;&#29616;&#26377;&#30340; RPC &#31995;&#32479;&#23558;&#26381;&#21153;&#21457;&#29616;&#35270;&#20026;&#23436;&#20840;&#19968;&#33268;&#30340;&#36807;&#31243;&#12290;&#20026;&#27492;&#65292;&#23427;&#20204;&#20351;&#29992;&#23436;&#20840;&#19968;&#33268;&#30340;&#39046;&#23548;&#36873;&#20030;&#31639;&#27861;&#65292;&#22914; Zookeeper&#12289;etcd&#12289;Consul &#31561;&#12290;&#25105;&#20204;&#30340;&#32463;&#39564;&#26159;&#65292;&#22823;&#35268;&#27169;&#20351;&#29992;&#36825;&#20123;&#31574;&#30053;&#26159;&#24456;&#30171;&#33510;&#30340;&#12290;
@@ -59,4 +66,4 @@ Envoy **&#19981;&#20250;&#36335;&#30001;**&#21040;&#30446;&#26631;&#20027;&#26426;&#12290;&#25105;&#20204;&#20551;&#35774;&#20581;&#24247;&#26816;&#26597;&#25968;&#25454;&#27604;&#21457;&#29616;
 
 **&#26410;&#21457;&#29616;&#20027;&#26426;&#65292;&#20581;&#24247;&#26816;&#26597;&#22833;&#36133;**
 
-Envoy **&#19981;&#20250;&#36335;&#30001;&#24182;&#23558;&#21024;&#38500;&#30446;&#26631;&#20027;&#26426;**&#12290;&#36825;&#26159; Envoy &#28165;&#38500;&#20027;&#26426;&#25968;&#25454;&#30340;&#21807;&#19968;&#19968;&#31181;&#24773;&#20917;&#12290;
+Envoy **&#19981;&#20250;&#36335;&#30001;&#24182;&#23558;&#21024;&#38500;&#30446;&#26631;&#20027;&#26426;**&#12290;&#36825;&#26159; Envoy &#28165;&#38500;&#20027;&#26426;&#25968;&#25454;&#30340;&#21807;&#19968;&#19968;&#31181;&#24773;&#20917;&#12290;

-Original file line number
+Diff line change
 当传入连接通过 iptables 重定向或 TPROXY（查看真实 IP ）目标或使用代理协议重定向到 Envoy 时，可以使用原始目标集群。在这些情况下，使用元数据重定向的策略会使路由到原始目标集群的请求转发到上游主机，并且不需要任何明确的主机配置或上游主机发现机制。与上游主机的连接会被放入链接，并且闲置的主机在空闲时间比 [cleanup_interval_ms](https://www.envoyproxy.io/docs/envoy/latest/api-v1/cluster_manager/cluster#config-cluster-manager-cluster-cleanup-interval-ms) 长（默认值为5000 ms）时会被刷新。如果原始目标地址不可用，则不会打开上游连接。这种原始目的地服务发现的方式必须与原始目的地[负载均衡](load_balancing.md#arch-overview-load-balancing-types-original-destination)一起使用。
 +### 终端发现服务 (Endpoint Discovery Service)
 -### 服务发现服务（SDS）
 -Envoy 通过一个*发现服务的服务*获取集群成员，它是一个 [REST 风格的 API](https://www.envoyproxy.io/docs/envoy/latest/api-v1/cluster_manager/sds#config-cluster-manager-sds-api)。Lyft 提供了基于 Python 语言的 [发现服务](https://github.com/lyft/discovery)参考实现。该实现使用 AWS DynamoDB 作为存储类型，但该 API 非常简单，可以轻松地在各种不同的存储类型之上实施。对于每个 SDS 集群，Envoy 将定期从发现服务中获取集群成员。由于以下几个原因，SDS 是首选的服务发现机制：
 +终端发现服务(EDS)是一个居于 gRPC 或 REST-JSON API 服务器的 xDS 管理服务，在 Envoy 中用来获取集群成员。集群成员在 Envoy 的术语中被称为“终端”。对于每个集群，Envoy 都会通过发现服务来获取成员的终端。由于以下几个原因，EDS 是首选的服务发现机制：
 - Envoy 对每个上游主机都有明确的了解（与通过 DNS 解析的负载均衡进行路由相比而言），并可以做出更智能的负载均衡决策。
 - 在每个主机的发现 API 响应中携带的额外属性通知 Envoy 负载均衡权重、金丝雀状态、区域等。这些附加属性在负载均衡、统计信息收集等过程中会被 Envoy 网格全局使用。
 通常，主动健康检查与最终一致的服务发现服务数据结合使用，以进行负载均衡和路由决策。这将在下一节中进一步讨论。
++
 +### 服务发现服务（v1 SDS）
++
 +> (弃用) 这个发现服务在 v2 xDS API 中会被终端发现服务取代
++
 +Envoy 通过一个*发现服务的服务*获取集群成员，它是一个 [REST 风格的 API](https://www.envoyproxy.io/docs/envoy/latest/api-v1/cluster_manager/sds#config-cluster-manager-sds-api)。Lyft 提供了基于 Python 语言的 [发现服务](https://github.com/lyft/discovery)参考实现。该实现使用 AWS DynamoDB 作为存储类型，但该 API 非常简单，可以轻松地在各种不同的存储类型之上实施。对于每个 SDS 集群，Envoy 将定期从发现服务中获取集群成员。
++
 ## 关于服务发现的最终一致性
 许多现有的 RPC 系统将服务发现视为完全一致的过程。为此，它们使用完全一致的领导选举算法，如 Zookeeper、etcd、Consul 等。我们的经验是，大规模使用这些策略是很痛苦的。
 **未发现主机，健康检查失败**
 -Envoy **不会路由并将删除目标主机**。这是 Envoy 清除主机数据的唯一一种情况。
 +Envoy **不会路由并将删除目标主机**。这是 Envoy 清除主机数据的唯一一种情况。