adding example with automatic workload + lb

Author: timveil

README.md

@@ -3,6 +3,7 @@
 ## Examples
 * [NGINX Example](example-nginx/README.md) - Simple 3 node cluster with `NGINX` as the load balancer
 * [HAProxy Example](example-haproxy/README.md) - Simple 3 node cluster with `HAProxy` as the load balancer
+* [HAProxy Example with Workload](example-haproxy-with-workload/README.md) - Simple 3 node cluster with `HAProxy` as the load balancer and a `client` node running the `tpcc` workload
 * [Enterprise Backup Example](example-enterprise-backup/README.md) - CockroachDB Enterprise `BACKUP` to `NGINX` based "File Server"
 * [YCSB Functional Example](example-ycsb/README.md) - Building and running [YCSB](https://github.com/brianfrankcooper/YCSB) against a 3 node CockroachDB cluster
 * [OLTPBench Functional Example](example-oltpbench/README.md) - Building and running a fork of [OLTPBench](https://github.com/timveil-cockroach/oltpbench) against a 3 node CockroachDB cluster

example-haproxy-with-workload/README.md

@@ -0,0 +1,46 @@
+# Basic CockroachDB Cluster with HAProxy
+Simple 3 node CockroachDB cluster with HAProxy acting as load balancer
+
+## Services
+* `crdb-0` - CockroachDB node
+* `crdb-1` - CockroachDB node
+* `crdb-2` - CockroachDB node
+* `workload-client` - CockroachDB node serving as the `workload` client
+* `lb` - HAProxy acting as load balancer
+
+## Getting started
+1) run `./up.sh`
+2) visit the CockroachDB UI @ http://localhost:8080
+2) visit the HAProxy UI @ http://localhost:8081
+3) have fun!
+
+## Helpful Commands
+
+### Execute SQL
+Use the following to execute arbitrary SQL on the CockroachDB cluster.  The following creates a database called `test`.
+```bash
+docker-compose exec crdb-0 /cockroach/cockroach sql --insecure --execute="CREATE DATABASE test;"
+```
+
+### Run the TPC-C Workload
+Use the following command to run the `tpcc` sample `workload` for 10 minutes.  For more details see [this](https://www.cockroachlabs.com/docs/stable/cockroach-workload.html#run-the-tpcc-workload).
+
+```bash
+docker-compose exec workload-client /cockroach/cockroach workload run tpcc --duration=10m "postgresql://root@lb:5432?sslmode=disable"
+```
+
+### Open Interactive Shells
+```bash
+docker exec -ti crdb-0 /bin/bash
+docker exec -ti crdb-1 /bin/bash
+docker exec -ti crdb-2 /bin/bash
+docker exec -ti workload-client /bin/bash
+docker exec -ti lb /bin/sh
+```
+
+### Stop Individual nodes
+```bash
+docker-compose stop crdb-0
+docker-compose stop crdb-1
+docker-compose stop crdb-2
+```

example-haproxy-with-workload/docker-compose.yml

@@ -0,0 +1,46 @@
+version: '3.5'
+
+services:
+
+  crdb-0:
+    container_name: crdb-0
+    hostname: crdb-0
+    image: cockroachdb/cockroach:latest
+    command: start --logtostderr=WARNING --log-file-verbosity=WARNING --insecure
+
+  crdb-1:
+    container_name: crdb-1
+    hostname: crdb-1
+    image: cockroachdb/cockroach:latest
+    command: start --logtostderr=WARNING --log-file-verbosity=WARNING --insecure --join=crdb-0
+    depends_on:
+      - crdb-0
+
+  crdb-2:
+    container_name: crdb-2
+    hostname: crdb-2
+    image: cockroachdb/cockroach:latest
+    command: start --logtostderr=WARNING --log-file-verbosity=WARNING --insecure --join=crdb-0
+    depends_on:
+      - crdb-0
+
+  lb:
+    container_name: lb
+    hostname: lb
+    build: haproxy
+    ports:
+      - "5432:5432"
+      - "8080:8080"
+      - "8081:8081"
+    links:
+      - crdb-0
+      - crdb-1
+      - crdb-2
+
+  workload-client:
+    container_name: workload-client
+    hostname: workload-client
+    image: cockroachdb/cockroach:latest
+    entrypoint: ["tail", "-f", "/dev/null"]
+    depends_on:
+      - lb

example-haproxy-with-workload/down.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+
+docker-compose down --remove-orphans --volumes

example-haproxy-with-workload/haproxy/Dockerfile

@@ -0,0 +1,9 @@
+FROM haproxy:alpine
+
+LABEL maintainer="[email protected]"
+
+COPY haproxy.cfg /usr/local/etc/haproxy/haproxy.cfg
+
+EXPOSE 5432
+EXPOSE 8080
+EXPOSE 8081

example-haproxy-with-workload/haproxy/haproxy.cfg

@@ -0,0 +1,37 @@
+global
+    log stdout format raw local0 info
+    maxconn 4096
+
+defaults
+    log                 global
+    timeout connect     10s
+    timeout client      30m
+    timeout server      30m
+    option              clitcpka
+    option              tcplog
+
+listen cockroach-jdbc
+    bind :5432
+    mode tcp
+    balance roundrobin
+    option httpchk GET /health?ready=1
+    server crdb-0 crdb-0:26257 check port 8080
+    server crdb-1 crdb-1:26257 check port 8080
+    server crdb-2 crdb-2:26257 check port 8080
+
+listen cockroach-ui
+    bind :8080
+    mode tcp
+    balance roundrobin
+    option httpchk GET /health
+    server crdb-0 crdb-0:8080 check port 8080
+    server crdb-1 crdb-1:8080 check port 8080
+    server crdb-2 crdb-2:8080 check port 8080
+
+listen stats
+    bind :8081
+    mode http
+    stats enable
+    stats hide-version
+    stats realm Haproxy\ Statistics
+    stats uri /

example-haproxy-with-workload/prune.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+
+docker system prune -a -f --volumes

example-haproxy-with-workload/up.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+
+docker-compose build --no-cache
+
+docker-compose up -d
+
+sleep 10
+
+docker-compose exec workload-client /cockroach/cockroach workload init tpcc "postgresql://root@lb:5432?sslmode=disable"
+docker-compose exec workload-client /cockroach/cockroach workload run tpcc --duration=30m "postgresql://root@lb:5432?sslmode=disable"