gxd-cli is gawainx' docker client

Create docker containers by writing a TOML config file!

Inspired by docker-compose.

Support

• Edit .toml file rather than type a long long command to create your service comtainers.
• Support multi ports binding. e.g.: -p 8080:80
• Support multi volumes bingding. e.g.: -v /use/bin:/code
• Modify your own container name.
• Cross platform,work well in macOS and Linux.
• Support PWD when mounting volumes. 2018-05-31 updated
• Create multi-services in just one *.toml file. 2018-05-31 updated
• Create Network support. 2018-06-27 updated
• Use golang/dep to manage dependencies. 2018-06-27 updated

Not support and TODOs

• No Windows .exe file. And may never support.
• Not support interactive containers(e.g.:bash in your container)
• [TODO] detach option not take effect.
• [TODO] Set Launch order when create more than one containers.

How to install

• Download package from Releases gawainx/gxd-cli
• mv gxd-cli-{system}-{version} gxd-cli and sudo cp gxd-cli /usr/local/bin or sudo mv gxd-cli-{system}-{version} /usr/local/bin/gxd-cli
• Enjoy it.

How to use

• Install gxd-cli
• change dir to your work dir.
• type gxd-cli init to create example toml. Or you can create your own toml file.
• gxd-cli up {service.toml} to make it work.

How to build

To build from source you need to install golang, Mage :: Mage and Masterminds/glide: Package Management for Golang.

Attention: glide.yaml is just used for help install dependencies. DO NOT run glide up in the project dir or you may meet strange problem.

git clone [email protected]:gawainx/gxd-cli.git
cd gxd-cli
glide up #download dependencies.
mage build # build for both linux and macOS
mage darwin # build for macOS only

Or you can just

git clone [email protected]:gawainx/gxd-cli.git
dep ensure -update
go install

than type gxd-cli in your terminal.

More

If you meet any issues welcome to contact me.

Thanks

• urfave/cli: A simple, fast, and fun package for building command line apps in Go
• magefile/mage: a Make/rake-like build tool using Go
• moby/moby: Moby Project - a collaborative project for the container ecosystem to assemble container-based systems