move keepalived from infra and update config

2017-07-28 14:32:52 -04:00
parent 99e1add6b4
commit 9dfcd9be5b
8 changed files with 119 additions and 82 deletions
@@ -0,0 +1,48 @@
+# Keepalived
+
+This catalog recipe enables unicast VRRP based failover for one or more floating IP Addresses. It's intended deployment is for use on a pair edge or ingress nodes where forward-facing load-balancers or other like services will be scheduled.
+
+
+### Form Fields
+
+|        Variable       |   Default   |                                       Description                                      |
+|:---------------------:|:-----------:|:--------------------------------------------------------------------------------------:|
+|  **Host Label Name**  | `vrrp_role` |      Host label key name used to schedule keepalived master and backup instances.      |
+|    **Master Label**   |   `master`  |         The value of the keepalived host Label to signify the master instance.         |
+|    **Backup Label**   |   `backup`  |         The value of the keepalived host Label to signify the backup instance.         |
+|   **Interface Name**  |    `eth0`   |        The host interface that keepalived will monitor and use for VRRP traffic.       |
+| **Virtual Router ID** |     `2`     |           A unique number from 0 to 255 that should identify the VRRP group.           |
+|     **Master IP**     |             |          The IP on the master host that the keepalived daemon should bind to.          |
+|     **Backup IP**     |             |          The IP on the backup host that the keepalived daemon should bind to.          |
+|     **Virtual IP**    |             | Virtual IP to be created. Must be in ip notation: `<ipaddress>/<mask> dev <interface>` |
+
+### Usage
+
+This service is intended to be deployed to edge nodes with a `master` and `backup` deployed respectively. One or more Virtual IPs may then be bound to hosts. These hosts should have an additional label used for load-balancer scheduling e.g. `ingress=true`
+
+#### Adding an HA Load Balancer Service
+
+**Ensure your edge hosts have an additional host label before proceeding**
+
+1. From the Stack menu add a new `Load Balancer`.
+2. Set `Scale` to be `Always run one instance of this container on every host`.
+3. Add an appropriate `Name` and `Description`.
+4. In the `Port Rules` section, click `Show host IP address options.` This enables the Host IP Field.
+5. Update the `Port Rules` with the `Host IP` field set to your `Virtual IP` as defined in the keepalived config. Configure the rest of the fields as needed for your application.
+6. Click on the `Scheduling` tab and click on `Add Scheduling Rule`.
+7. Create a rule where "The host `must` have a `host label` of `<edge node host label>` = `<edge node host label value>`.
+8. Click Create.
+
+#### Adding additional Virtual IPs to the keepalived Service
+
+1. From the Stack menu expand the `keepalived` service.
+2. Select upgrade on the `keepalived-backup` service.
+3. Add a new Environment Variable called `KEEPALIVED_VIRTUAL_IPADDRESS_<number>`. Where `<number>` should be a unique value from 0-999. e.g. `KEEPALIVED_VIRTUAL_IPADDRESS_2`.
+4. Set the value to be a **QUOTED STRING** with an additional virtual IP following the standard ip format of `<ipaddress>/<mask> dev <interface>`. e.g. `10.255.33.102/24 dev eth0`.
+5. Press `Upgrade`.
+6. Repeat the same steps for the `keepalived-master` service.
+
+
+### Troubleshooting
+
+For further help see the main [arc-ts/keepalived git repo](https://github.com/arc-ts/keepalived)
@@ -0,0 +1,41 @@
+version: '2'
+services:
+  keepalived-master:
+    restart: always
+    image: arcts/keepalived:1.1.0
+    network_mode: host
+    cap_add:
+      - NET_ADMIN
+    environment:
+      KEEPALIVED_AUTOCONF: true
+      KEEPALIVED_STATE: MASTER
+      KEEPALIVED_INTERFACE: ${interface}
+      KEEPALIVED_VIRTUAL_ROUTER_ID: ${router_id}
+      KEEPALIVED_UNICAST_SRC_IP: ${master_ip}
+      KEEPALIVED_UNICAST_PEER_0: ${backup_ip}
+      KEEPALIVED_TRACK_INTERFACE_1: ${interface}
+      KEEPALIVED_VIRTUAL_IPADDRESS_1: "\"${virtual_ip}\""
+    labels:
+      io.rancher.scheduler.affinity:host_label: ${host_label}=${master_label}
+    sysctls:
+      - net.ipv4.ip_nonlocal_bind=1
+
+  keepalived-backup:
+    restart: always
+    image: arcts/keepalived:1.1.0
+    network_mode: host
+    cap_add:
+      - NET_ADMIN
+    environment:
+      KEEPALIVED_AUTOCONF: true
+      KEEPALIVED_STATE: BACKUP
+      KEEPALIVED_INTERFACE: ${interface}
+      KEEPALIVED_VIRTUAL_ROUTER_ID: ${router_id}
+      KEEPALIVED_UNICAST_SRC_IP: ${backup_ip}
+      KEEPALIVED_UNICAST_PEER_0: ${master_ip}
+      KEEPALIVED_TRACK_INTERFACE_1: ${interface}
+      KEEPALIVED_VIRTUAL_IPADDRESS_1: "\"${virtual_ip}\""
+    labels:
+      io.rancher.scheduler.affinity:host_label: ${host_label}=${backup_label}
+    sysctls:
+      - net.ipv4.ip_nonlocal_bind=1
@@ -0,0 +1,52 @@
+.catalog:
+  name: "keepalived"
+  version: v1.0.1
+  description: "Keepalived VRRP based HA service."
+  minimum_rancher_version: v0.46.0
+  uuid: keepalived-1
+  questions:
+    - variable: "host_label"
+      description: "Host label key name used to schedule keepalived master and backup instances."
+      label: "Host Label Name:"
+      type: "string"
+      default: "vrrp_role"
+      required: true
+    - variable: "master_label"
+      description: "The value of the keepalived host Label to signify the master instance."
+      label: "Master Label:"
+      type: "string"
+      default: "master"
+      required: true
+    - variable: "backup_label"
+      description: "The value of the keepalived host Label to signify the backup instance."
+      label: "Backup Label:"
+      type: "string"
+      default: "backup"
+      required: true
+    - variable: "interface"
+      description: "The name of the host interface."
+      label: "Interface Name:"
+      type: "string"
+      default: "eth0"
+      required: true
+    - variable: "router_id"
+      description: "The virtual Router ID to assign to the VRRP Pair."
+      label: "Virtual Router ID:"
+      type: "int"
+      default: "2"
+      required: true
+    - variable: "master_ip"
+      description: "Host IP of master node"
+      label: "Master IP:"
+      type: "string"
+      required: true
+    - variable: "backup_ip"
+      description: "Host IP of backup node"
+      label: "Backup IP:"
+      type: "string"
+      required: true
+    - variable: "virtual_ip"
+      description: "Virtual IP to be created. MUST be in ip notation: <IPADDRESS>/<MASK> dev <INTERFACE>"
+      label: "Virtual IP:"
+      type: "string"
+      required: true