flutter>> zk-apache-bridge>> 返回
项目作者： BartRobeyns

项目描述 ：
Apache load-balancing based on Zookeeper service-discovery
高级语言： Java
项目地址: git://github.com/BartRobeyns/zk-apache-bridge.git
创建时间： 2018-07-15T20:46:01Z
项目社区：https://github.com/BartRobeyns/zk-apache-bridge
开源协议：
下载


zk-apache-bridge

Apache load-balancing based on Zookeeper service-discovery

(Caveat: works with spring-cloud defaults for service-registration and health-check)

Provides the endpoints, registered in Zookeeper, to Apache. Either as a rewritemap-file, for RewriteRule-based loadbalancing, or as a true LoadBalancer-configuration.

The discovered endpoints are health-checked based on Spring-Boot’s /actuator/health endpoint

The service-names, as they are registered in Zookeeper, are mapped to the /services/ on the Apache-root.
Only characters [-_a-zA-Z0-9] are allowed in these service-names; all others are replaced with ‘-‘.

Build it

  1. git clone https://github.com/BartRobeyns/zk-apache-bridge.git
  2. cd zk-apache-bridge
  3. mvn install

Test it in Docker

  1. cd zkclientsample
  2. docker-compose up -d
  3. # repeat the following, and see the same ip-address in the reponse
  4. curl http://localhost/zk-sample-client/zkclient
  6. docker-compose up -d --scale zkclientsample=3
  7. # give it some time, then repeat the following to see different  ip-addresses in the response
  8. curl http://localhost/zk-client-sample/zkclient
  10. # The RewriteRule-based loadbalancing listens on port 80, to see the LoadBalancer-configuration in action use port 8080 instead:
  11. curl http://localhost:8080/services/zk-client-sample/zkclient

Run it with an existing Apache

  1. java -jar zk-apache-bridge-1.0.0-SNAPSHOT-exec.jar

parameters:

  1. --spring.cloud.zookeeper.connect-string=<zookeeper-url> (defaults to localhost:2181)
  2. --spring.cloud.zookeeper.discovery.register=<true|false> (default: true, makes zk-apache-bridge itself discoverable)
  4. --zkapachebridge.healthcheck.interval=(default:20000, time in ms between healthchecks)
  5. --zkapachebridge.healthcheck.timeout.connect=(default:5000)
  6. --zkapachebridge.healthcheck.timeout.socket=(default:5000)
  7. --zkapachebridge.healthcheck.timeout.connectionRequest=(default:5000)
  8. --zkapachebridge.healthcheck.enabled=(default:true)
  10. --zkapachebridge.urls.prefix=<prefix for the exposed endpoints> (defaults to 'services/')
  12. --zkapachebridge.rewritemap.active=<true|false> (default: true)
  13. --zkapachebridge.rewritemap.path=<path where to write the rewritemap> (default: /etc/apache2/maps/apimap.map)
  15. --zkapachebridge.loadbalancer.active=<true|false> (default: false)
  16. --zkapachebridge.loadbalancer.path=<path where to write the LoadBalancer configuration> (default: /etc/apache2/maps/lbconfig.conf)
  17. --zkapachebridge.loadbalancer.apache-reload=<command to restart apache after the LoadBalancer configuration has been updated) (default: apachectl graceful)
  18. --zkapachebridge.loadbalancer.template=(default: /loadbalancer-config.ftl, location of the freemarker-template to construct the loadbalancer configuration)

Monitor it

  1. # default port is 8080
  2. # list services, endpoints and active-status
  3. GET http://<host>:<port>/api/info
  4. # show the resultant loadbalancer configuration
  5. GET http://<host>:<port>/api/info/loadbalancer
  6. # show the resultant rewritemap
  7. GET http://<host>:<port>/api/info/rewritemap

Configure your application

You can enable or disable healtchecks on your application, and set an alternative health-check endpoint

  1. spring.cloud.zookeeper.discovery.metadata.healthcheck.enabled=<true|false> (default:true)
  2. spring.cloud.zookeeper.discovery.metadata.healthcheck.endpoint=<endpoint where zk-apache-bridge should check for service health> (default:/actuator/health)

RewriteRule-based loadbalancing

See the RewriteMap Docker-image

Apache allows you include key-value pairs useable in RewriteRules with RewriteMap.
A value can be a list (delimited with |), from where an entry is picked at random.

E.g. with map/apimap.txt

  1. service1 http://192.168.0.1:80|http://192.168.0.2:80

you can get either the …0.1 or the ….0.2 address in a RewriteRule like this:

  1.     RewriteMap apimap rnd:maps/apimap.txt 
  2.     RewriteRule /service1/(.*) ${apimap:service1}/$1 [LP]

These RewriteMaps are reloaded dynamically, whenever they change.

This is the basis of the RewriteMap-based implementation, which is fully elaborated in zk-apache-bridge-docker/zk-apache-bridge-docker-rewritemap;
take a look at the 000-default-conf file in there.

LoadBalancer-based loadbalancing

See the LoadBalancer Docker-image

RewriteMaps are quite limited for LoadBalancing: there’s no other algorithm than the randomness of the map.

Apache httpd offers a better solution through the proxy_balancer module. The only downside: it’s not dynamically reloadable (at least not based on dynamic service discovery). But Apache httpd itself allows you to restart it ‘gracefully’: this means it will load changed configuration in a new set of worker-processes, and the old worker-processes are allowed to handle their current requests and only then are killed.

When zk-apache-bridge receives a change in service-endpoints, it changes the Apache configuration, and then asks it to restart gracefully (using ‘apachectl graceful’).
The configuration it writes looks like this, for every service and every active endpoint:

  1. <Proxy "balancer://service1">
  2.     BalancerMember "http://192.168.0.1:80"
  3.     BalancerMember "http://192.168.0.2:80"
  4. </Proxy>
  5. ProxyPass        "/service1" "balancer://service1"

It’s written to the path defined through --zkapachebridge.loadbalancer.path, which should be included in the Apache configuration
with, e.g., Include maps/lbconfig.conf