A CLI for Garden
Gaol is a simple, fast, and composable CLI for the Garden container server. It is designed to be used with other command line tools. It is suitable for use in scripts and other headless operations.
Download the latest binary from the releases page, make it executable, and put it somewhere in your path.
All of the commands are documented in the help and usage section of the CLI. You can see this by running:
gaol --help
Some of the more common commands are:
# creating a container
$ gaol create
conabc123
# run a command inside a container
$ gaol run conabc123 --attach --command "date"
Sat 7 Feb 2015 15:14:17 GMT
# run a process in the background and then attach to it
$ gaol run conabc123 --command 'sh -c "while true; do date; sleep 1; done"'
5
$ gaol attach conabc123 --pid 5
Sat 7 Feb 2015 15:14:45 GMT
Sat 7 Feb 2015 15:14:46 GMT
Sat 7 Feb 2015 15:14:47 GMT
# open a shell inside a new container
$ gaol shell $(gaol create)
# copying files into a container
$ tar c file.txt | gaol stream-in conabc123 --destination /etc/file.txt
# copying files from one container to another
$ gaol stream-out abc -s ./foo | gaol stream-in def -d ./foo
# destroy all containers
$ gaol list | xargs gaol destroy
Garden https://github.com/cloudfoundry/garden
Gaol Definition http://en.wiktionary.org/wiki/gaol