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 · 2016-05-02 15:06:20 -07:00 · 6e74b3b6af
commit 6e74b3b6af
parent 147709d9a5
5 changed files with 131 additions and 0 deletions
--- a/templates/f5/0/README.md
+++ b/templates/f5/0/README.md
@ -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.
--- a/templates/f5/0/docker-compose.yml
+++ b/templates/f5/0/docker-compose.yml
@ -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}
--- a/templates/f5/0/rancher-compose.yml
+++ b/templates/f5/0/rancher-compose.yml
@ -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
--- a/templates/f5/catalogIcon-f5.svg
+++ b/templates/f5/catalogIcon-f5.svg
@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Generator: Adobe Illustrator 19.1.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="f5logo" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="-302 218 231 161" style="enable-background:new -302 218 231 161;" xml:space="preserve">
+<style type="text/css">
+	.st0{fill:#E6E6E6;}
+	.st1{fill:#0075A8;}
+	.st2{fill:none;stroke:#E6E6E6;stroke-width:2;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;}
+	
+		.st3{fill:none;stroke:#E6E6E6;stroke-width:2;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:10;stroke-dasharray:1.500000e-02,4;}
+	.st4{fill:#E21D38;}
+	.st5{fill:#FFFFFF;}
+</style>
+<g>
+	<path class="st0" d="M-184.4,264.1v68.3c0,15,12.2,27.2,27.2,27.2h-63.5c15,0,27.2-12.2,27.2-27.2v-68.3H-184.4 M-184.4,262.1h-9.2
+		c-1.1,0-2,0.9-2,2v68.3c0,13.9-11.3,25.2-25.2,25.2c-1.1,0-2,0.9-2,2s0.9,2,2,2h63.5c1.1,0,2-0.9,2-2s-0.9-2-2-2
+		c-13.9,0-25.2-11.3-25.2-25.2v-68.3C-182.4,263-183.3,262.1-184.4,262.1L-184.4,262.1z"/>
+</g>
+<g>
+	<path class="st1" d="M-235.9,320l-0.5-3.3c-0.2-1-0.6-1.9-0.9-1.9c-0.3,0-0.6,0.9-0.6,1.9v0.9c0,1.1-0.9,1.9-1.9,1.9h-0.9
+		c-0.1,0-0.1,0-0.2,0v2.3c0.1,0,0.1,0,0.2,0h3.2C-236.5,321.9-235.8,321-235.9,320"/>
+	<path class="st1" d="M-243.6,317.2h-5.2h-0.1h-5.3c-0.1,0-0.1,0-0.2,0v-0.5c0-1.1-0.3-1.9-0.6-1.9s-0.7,0.9-0.9,1.9l-0.5,3.3
+		c-0.2,1,0.6,1.9,1.6,1.9h3.2c0.3,0,0.6-0.1,0.9-0.1c-0.1,0.5-0.6,1-1.2,1h-4.5c-0.7,0-1.3-0.7-1.2-1.4l0.5-2.7
+		c0.1-0.7-0.4-1.4-1.2-1.4h-22.4c-0.5,0-0.9,0.3-1.1,0.7l-4.2,6.4c-0.1,0.1-0.1,0.3,0,0.4l0.8,1c0.1,0.1,0.3,0.1,0.4,0l2.9-2.3v13.7
+		c0,0.7,0.5,1.2,1.2,1.2h6.4c0.7,0,1.2-0.5,1.2-1.2v-4.8c0-0.7,0.5-1.2,1.2-1.2h15.9c0.7,0,1.2,0.5,1.2,1.2v4.8
+		c0,0.7,0.5,1.2,1.2,1.2h6.4c0.7,0,1.2-0.5,1.2-1.2v-5.1h-3.4c-1.1,0-1.9-0.9-1.9-1.9v-3.3c0-0.6,0.3-1.2,0.8-1.5v3.9
+		c0,1.1,0.9,1.9,1.9,1.9h5.2c1.1,0,1.9-0.9,1.9-1.9v-10C-241.7,318.1-242.6,317.2-243.6,317.2"/>
+</g>
+<path class="st2" d="M-223.8,338.7c0,3.3-2.7,6-6,6h-61.1c-3.3,0-6-2.7-6-6"/>
+<polyline class="st3" points="-223.8,338.7 -260.3,260.4 -296.9,338.7 "/>
+<path class="st2" d="M-158.4,372h-61.2c-2.2,0-3.9-1.8-3.9-3.9l0,0c0-2.2,1.8-3.9,3.9-3.9h61.2c2.2,0,3.9,1.8,3.9,3.9l0,0
+	C-154.5,370.2-156.2,372-158.4,372z"/>
+<g>
+	<path class="st0" d="M-183.2,243.4c2.2,0,4,1.8,4,4s-1.8,4-4,4h-11.5c-2.2,0-4-1.8-4-4s1.8-4,4-4H-183.2 M-183.2,241.4h-11.5
+		c-3.3,0-6,2.7-6,6s2.7,6,6,6h11.5c3.3,0,6-2.7,6-6C-177.2,244.1-179.9,241.4-183.2,241.4L-183.2,241.4z"/>
+</g>
+<path class="st2" d="M-79.3,338.7c0,3.3-2.7,6-6,6h-61.1c-3.3,0-6-2.7-6-6"/>
+<polyline class="st3" points="-79.3,338.7 -115.8,260.4 -152.4,338.7 "/>
+<circle id="bg_2_" class="st4" cx="-116" cy="321.2" r="17.2"/>
+<path class="st5" d="M-116.4,322.9c8.4,0.7,11.7,3,11.5,6.2c-0.2,1.7-1.8,3.3-3.9,3.5c-2.5,0.2-3.6-0.9-4.3-1.9c-0.6-1-1.3-2-2-3.1
+	c-0.2-0.3-0.5-0.1-0.7,0.1c-0.5,0.5-1,1-1.5,1.5c-0.3,0.3-0.2,0.5-0.2,0.8c0.5,1.1,0.9,2.2,1.4,3.2c0.8,0.5,4.3,1.1,6.8,0.9
+	c1.8-0.2,3.9-0.9,5.8-2.2c1.8-1.4,3.1-3.2,3.3-6.3c0.1-1.9-0.2-3.8-1.9-5.6c-1.6-1.8-4.4-3.2-10-3.6c0.3-0.9,0.5-1.8,0.9-2.6
+	c3.4,0.2,6.4,0.4,9,0.7c0.2-1,0.3-1.9,0.5-2.9l-0.7-0.8c-1.3-0.2-2.6-0.5-3.9-0.6c-1.8-0.2-3.6-0.4-5.6-0.5
+	C-113.3,313.2-114.8,317.9-116.4,322.9 M-118.7,308.4c-0.6,0-1.5,0.2-2.9,0.5c-3,0.9-6.7,2.9-7.1,6.4c-0.1,0.5-0.1,1.2-0.2,1.7
+	c-0.9,0.1-1.6,0.2-2.4,0.2c-0.1,0.7-0.1,1.3-0.2,2c0.8-0.1,1.5-0.1,2.4-0.2c-0.2,3.6,0,7.3,0.3,10.7c0.1,0.5,0.1,1,0.1,1.3
+	c-0.1,0.3-0.6,0.5-1.4,0.5l1,1.2c2.9,0.5,6.6,0.9,10.6,1c0-0.4,0-0.8,0-1.2c-2.3-0.2-3.4-0.5-3.6-0.9s-0.2-0.9-0.2-1.5
+	c-0.2-3.6-0.2-7.4-0.2-11.4c1.3,0,2.6,0,3.9-0.1c0.7-0.3,1.3-0.6,1.9-0.9c0-0.5,0-0.9,0-1.3c-2,0-3.9,0.1-5.9,0.1
+	c0.1-1.6,0.2-3.2,0.2-4.6c0.1-1,0.8-1.7,1.4-1.7c1.1-0.1,2.1,0.4,3.1,0.9c0.5,0.2,1.1,0.5,1.6,0.8c0.2,0.1,0.5,0.2,0.8-0.1
+	c0.3-0.4,0.6-0.8,0.9-1.1c0.2-0.2,0.1-0.4,0-0.5c-0.7-0.5-1.3-1-2-1.5c-0.4-0.3-1.1-0.3-1.7-0.3
+	C-118.2,308.4-118.4,308.4-118.7,308.4"/>
+<line class="st2" x1="-260.3" y1="258.4" x2="-117.5" y2="258.4"/>
+<g>
+	<path class="st0" d="M-188.8,224.9c3.6,0,6.5,2.9,6.5,6.5s-2.9,6.5-6.5,6.5s-6.5-2.9-6.5-6.5C-195.2,227.8-192.4,224.9-188.8,224.9
+		 M-188.8,222.9c-4.7,0-8.5,3.8-8.5,8.5s3.8,8.5,8.5,8.5s8.5-3.8,8.5-8.5S-184.1,222.9-188.8,222.9L-188.8,222.9z"/>
+</g>
+</svg>
--- a/templates/f5/config.yml
+++ b/templates/f5/config.yml
@ -0,0 +1,5 @@
+name: F5 BIG-IP Balancer
+description: |
+  Rancher External LB service powered by F5 BIG-IP
+version: v0.1.1-rancher1
+category: Load Balancing