Merge pull request #610 from spring-cloud/lb-integration-hoxton

LB integration hoxton

docs/src/main/asciidoc/load-balancer.adoc

@@ -0,0 +1,28 @@
+== LoadBalancer for Kubernetes
+This project includes Spring Cloud Load Balancer for load balancing based on Kubernetes Endpoints and provides implementation of load balancer based on Kubernetes Service.
+To include it to your project add the following dependency.
+====
+[source,xml]
+----
+<dependency>
+    <groupId>org.springframework.cloud</groupId>
+    <artifactId>spring-cloud-starter-kubernetes-loadbalancer</artifactId>
+</dependency>
+----
+====
+
+To enable load balancing based on Kubernetes Service name use the following property. Then load balancer would try to call application using address, for example `service-a.default.svc.cluster.local`
+====
+[source]
+----
+spring.cloud.kubernetes.loadbalancer.mode=SERVICE
+----
+====
+
+To enabled load balancing across all namespaces use the following property. Property from `spring-cloud-kubernetes-discovery` module is respected.
+====
+[source]
+----
+spring.cloud.kubernetes.discovery.all-namespaces=true
+----
+====

docs/src/main/asciidoc/spring-cloud-kubernetes.adoc

@@ -23,6 +23,8 @@ include::pod-health-indicator.adoc[]
 
 include::leader-election.adoc[]
 
+include::load-balancer.adoc[]
+
 include::security-service-accounts.adoc[]
 
 include::service-registry.adoc[]