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
andsudo cp gxd-cli /usr/local/bin
orsudo 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 git@github.com: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 git@github.com: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.