jbkielis / dockstack Goto Github PK

#DockStack

DockStack is a Docker ambassador based on SmartStack http://nerds.airbnb.com/smartstack-service-discovery-cloud/. It uses zookeeper or etcd (WIP) as discovery service.

DockStack is composed of two tools:

• Nerve, a service registration daemon that performs health checks https://github.com/airbnb/nerve
• Synapse, a transparent service discovery framework that proxyfies the connections. It uses HAProxy to proxy the connections https://github.com/airbnb/synapse

Both tools use a YAML config file, which is not ideal to use with Docker. A wrapper script heavily simplifies the generation of this files via CLI.

##Setup ####Zookeeper You can easily setup Zookeeper on your hosts using https://registry.hub.docker.com/u/thefactory/zookeeper-exhibitor/

####MySQL Any other service will work

• Spawn a MySQL container

host1 $ docker run -d --name mysql -p :3306 -e MYSQL_ROOT_PASSWORD=test mysql

• Create an healt-check user

host1 $ docker exec -ti mysql mysql -u root -p -e 'CREATE USER 'haproxy_check'@'%'; FLUSH PRIVILEGES;'

####Nerve

host1 $ docker run \
	-ti --rm \ # -d
	-v /usr/bin/docker:/usr/bin/docker:ro \
	-v /lib64/libdevmapper.so.1.02:/lib/libdevmapper.so.1.02:ro \
	-v /var/run/docker.sock:/var/run/docker.sock \
	-e SERVICE_HOST=176.31.235.180 \
	asiragusa/nerve \
	-d zk://<zookeeper_hosts comma separated>/nerve \
	-s mysql:tcp:mysql:3306:/test

####Synapse

host2 $ docker run \
	-ti --rm \ # -d
	--name synapse
	asiragusa/synapse
	-d zk://<zookeeper_hosts comma separated>/nerve \
	-s mysql:mysql:/test

####Testing Here the magic happens! (Running a mysql image, as it carries by default mysql-client)

host2 $ docker run -ti --rm --link synapse:db mysql:latest mysql -u root -h db -p

The connection is transparently proxified by HAProxy

##TODO Create more service config files and examples ready to use

##Authors

• Alessandro Siragusa
• Yves-Marie Saout

##Special thanks To Jérôme Petazzoni for the great idea!