Catalog entry for the f5 external-LB service

Using the uppercase F5 in Readme Changed category to Load Balancing More friendlier labels
2016-05-02 15:06:20 -07:00
parent 147709d9a5
commit 6e74b3b6af
5 changed files with 131 additions and 0 deletions
@@ -0,0 +1,26 @@
+external-lb
+==========
+Rancher service facilitating integration of rancher with F5 BIG-IP - external load balancer. This service updates F5 with services created in Rancher that ask to be load balanced using F5.
+Initial version comes with support for an unpartitioned F5 BIG-IP installation
+
+Design
+==========
+* The F5 service gets deployed as a Rancher service containerized app.
+
+* It enables any other service to be registered to external F5 if the service has exposed a public port and has the label 'io.rancher.service.external_lb_endpoint'
+
+* Value of this label should be equal to the VirtualServer Name on F5 BIG-IP
+
+* The VirtualServer should be pre-configured on F5
+
+* The rancher hosts on which the containers of the service are running, will be added to the F5 setup as nodes
+
+* A new F5 pool will be created for the service, having the Rancher host_ip:port as pool members
+
+* This F5 pool created will have a name of the pattern of"service.Name"_"environment_uuid"_"rancher.internal"  - The suffix "rancher.internal" is configurable while launching the catalog template.
+
+* This pool will be assigned to the F5 virtual server provided to Rancher via the above label
+
+* After the F5 configuration is complete, the service on Rancher can be reached using the F5 vip:port
+
+* Rancher’s F5 service will keep on synching new services to F5 and remove/scale up-scale down as changes are made on Rancher.
@@ -0,0 +1,10 @@
+external-lb:
+  image: rancher/external-lb:v0.1.1
+  command: -provider=f5_BigIP
+  expose: 
+   - 1000
+  environment:
+    F5_BIGIP_HOST: ${F5_BIGIP_HOST}
+    F5_BIGIP_USER: ${F5_BIGIP_USER}
+    F5_BIGIP_PWD: ${F5_BIGIP_PWD}
+    LB_TARGET_RANCHER_SUFFIX: ${LB_TARGET_RANCHER_SUFFIX}
@@ -0,0 +1,34 @@
+.catalog:
+  name: "F5 LB"
+  version: "v0.1.1-rancher1"
+  description: "Rancher External LB service powered by F5 BIG-IP."
+  questions:
+    - variable: "F5_BIGIP_HOST"
+      label: "Host Address"
+      description: "IP Address of the F5 BIG-IP Device"
+      type: "string"
+      required: true
+    - variable: "F5_BIGIP_USER"
+      label: "Username"
+      description: "Username of the F5 admin"
+      type: "string"
+      required: true
+    - variable: "F5_BIGIP_PWD"
+      label: "Password"
+      description: "Password of the F5 admin"
+      type: "string"
+      required: true
+    - variable: "LB_TARGET_RANCHER_SUFFIX"
+      label: "Suffix for F5 pool names"
+      description: "A suffix added to the Pool names on F5 BIG-IP to identify the pools added by Rancher"
+      type: "string"
+      required: true
+      default: rancher.internal
+external-lb:
+  health_check:
+    port: 1000
+    interval: 2000
+    unhealthy_threshold: 3
+    request_line: GET / HTTP/1.0
+    healthy_threshold: 2
+    response_timeout: 2000