gaudi is a generator of architecture written in Go and using Docker. You can use it to start any type of application, and link them together without knowledge of Docker or system configuration. Using Go, gaudi can build and start your applications in parallel depending on their dependencies.
Check gaudi's website and follows @GaudiBuilder for more information.
Describe any architecture with a simple YAML file (called .gaudi.yml
). For instance, for a PHP+MySQL combo:
applications:
front1:
type: apache
links: [app]
volumes:
.: /var/www
custom:
fastCgi: app
ports:
8080: 8080
app:
type: php-fpm
links: [db]
ports:
9000: 9000
volumes:
.: /var/www
db:
type: mysql
ports:
3306: 3306
Start this environment (with sudo privileges):
gaudi
gaudi will try to find a .gaudi.yml
file in the current folder, and start each application simultaneously, or sequentially if they depend on each other.
gaudi requires Docker to run.
The Cethy/vagrant-gaudi repository describes how to install gaudi with Vagrant.
wget -O - http://gaudi.io/apt/gaudi.gpg.key | sudo apt-key add -
echo "deb http://gaudi.io/apt/ precise main" | sudo tee -a /etc/apt/sources.list
sudo apt-get update
sudo apt-get install gaudi
On other system you need to install Go 1.2 to install gaudi.
go get github.com/marmelab/gaudi
Check that your PATH
includes $GOPATH/bin
:
export PATH=$GOPATH/bin:/$PATH
A puppet module is available to install gaudi.
The gaudi
application starts containers with Docker's commands which requires sudo privileges.
Make sure that the GOPATH
and GOROOT
environment variables are correctly set for the root
user (or other user with root privileges).
gaudi uses Docker to start all applications in a specific container.
It builds Docker files and specific configuration files from different templates.
All templates are listed in the templates/
folder, one for each application type.
You can find an example of how to start a Symfony application in the wiki.
Another examples can be found in the examples
folder.
See gaudi options.
Check How to configure gaudi to build your environment
See all type of applications supported.
gaudi can also runs binaries in the current folder.
A binary is not always attached to an application so gaudi allows to configure them in a different field binaries
.
See all type of binaries supported.
gpg --gen-key
ls / -R
gpg --armor --export [email protected] --output gaudi.gpg.key
make apt
Your feedback about the usage of gaudi in your specific context is valuable, don't hesitate to open GitHub Issues for any problem or question you may have.
All contributions are welcome. New applications or options should be tested with go unit test tool.
gaudi is licensed under the MIT Licence, courtesy of marmelab.