Recommend simpleConnectionPool for Cloud (#1193)

toby-sutor · web-flow · commit 3cab97a538a7 · 2022-02-02T12:02:11.000+01:00
As per #918 (comment) and https://elastic.slack.com/archives/CH37CF39S/p1643707941052409 we recommend using the `simpleConnectionPool` when there is a proxy or load balancer in place. This applies to Elasticsearch Service and ECE (Cloud). Hence the comments need to be updated.
diff --git a/docs/connection-pool.asciidoc b/docs/connection-pool.asciidoc
@@ -78,8 +78,10 @@ The `SimpleConnectionPool` returns the next node as specified by the selector;
 it does not track node conditions. It returns nodes either they are dead or 
 alive. It is a simple pool of static hosts.
 
-The `SimpleConnectionPool` is not recommended for routine use but it may be a 
-useful debugging tool.
+The `SimpleConnectionPool` is recommended where the Elasticsearch deployment
+is located behnd a (reverse-) proxy or load balancer, where the individual
+Elasticsearch nodes are not visible to the client. This should be used when
+running Elasticsearch deployments on Cloud.
 
 To use the `SimpleConnectionPool`:
 
