galaxy is a micro-paas designed for running 12-factor style, stateless, microservices within Docker containers while being lightweight and simple to operate. It handles the deployment, configuration and orchestration of Docker containers across multiple hosts.
It is ideally suited for running Docker containers:
- Alongside existing applications while transitioning to containers
- On clusters of 10's-100's of hosts
- On existing or new infrastructure you are already using
- For HTTP based micro-services
- Minimal dependencies (two binaries and redis)
- Automatic service registration, discovery and proxying of registered services.
- Virtual Host HTTP(S) proxying
- Container scheduling and scaling across hosts
- Heroku style config variable interface
- Container contraints (CPU/Mem)
There are two sub-projects: commander and shuttle.
- Commander - Container deployment and service discovery.
- Shuttle - An HTTP/TCP proxy that can be configured through a HTTP based API.
(These assume that Docker is running on your local host. If you're
running it remotely, or via something like boot2docker, you'll need to
GALAXY_REGISTRY_URL below and provide the
To setup a single host environment, run the following:
$ docker run -d --name redis -p 6379:6379 redis $ export GALAXY_REGISTRY_URL=redis://127.0.0.1:6379 $ export GALAXY_ENV=local $ export GALAXY_POOL=web $ commander agent
To create a new app for nginx:
$ commander app:create nginx
To deploy a latest official nginx image to our nginx app:
$ commander app:deploy nginx nginx
Finally, we need to assign this app to our default
$ commander app:assign nginx
You should see nginx started by the
commander agent process.
To expose the nginx app, we need to run shuttle to handle request routing:
$ shuttle -http 0.0.0.0:8080
This starts a shuttle with an admin server on 127.0.0.1:9090 (the default) and an HTTP server on 0.0.0.0:8080.
Next, stop your old commander agent and restart it, pointing to the shuttle admin address:
$ commander -shuttle-addr 127.0.0.1:9090 agent
Assign a service port to nginx:
$ commander runtime:set -port 8888 nginx
You should now be able to access the nginx app on host port 8888:
$ curl localhost:8888
Add a virtual host:
$ commander runtime:set -vhost my.domain nginx $ curl -v my.domain:8080
You need to have a docker 1.4.1+ and golang 1.4.
- Install glock
- make deps