[GitHub] merlimat commented on a change in pull request #1086: Pulsar proxy documentation (WIP)

[GitBox <gi...@apache.org>]

merlimat commented on a change in pull request #1086: Pulsar proxy documentation (WIP)
URL: https://github.com/apache/incubator-pulsar/pull/1086#discussion_r164526644
 
 

 ##########
 File path: site/docs/latest/admin/Proxy.md
 ##########
 @@ -0,0 +1,22 @@
+---
+title: The Pulsar proxy
+---
+
+[`proxy`](../../reference/CliTools#pulsar-proxy) command
+
+To start the proxy:
+
+```bash
+$ bin/pulsar proxy \
+  --zookeeper-servers zk-0,zk-1,zk-2 \
+  --global-zookeeper-servers zk-0,zk-1,zk-2
+```
+
+## Notes
+
+* You can run multiple proxy nodes
+* Stateless proxy over multiple brokers (all brokers in a cluster)
+* Helpful when direct connectivity between clients and brokers is either not possible or not desirable (good way to avoid administrative overhead)
+* Example: Kubernetes (clients can't access individual brokers and thus require a proxy to connect)
+* All lookup and data connections flow through a proxy instance; those instances can be exposed via, for example, a load balancer
+* Minimal interaction between client and broker
 
 Review comment:
   One more point can be: "TLS termination can be done in proxy to offload it from brokers"

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services