Package: dock-upload-test
# dock[![Join the chat at https://gitter.im/bripkens/dock](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/bripkens/dock?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)**dock** is a shell script to help you easily bootstrap databases and othertools that you need for development purposes. Instead of installing somethinglike MongoDB or Redis natively on your machine, you can run it in a Dockercontainer with just a single command `dock mongodb`. The main purpose of**dock** is to make the interaction with Docker dead simple for quick prototypesand hackathons.## Typical usage```$ dock redis jenkins mongodb rabbitmqStarting redis (using /Users/ben/.dock-formulas/formulas/redis)Container startedName:           redisIP:             192.168.59.103Ports:          6379Starting jenkins (using /Users/ben/.dock-formulas/formulas/jenkins)Container startedName:           jenkinsIP:             192.168.59.103Ports:          8472Starting mongodb (using /Users/ben/.dock-formulas/formulas/mongodb)Container startedName:           mongodbIP:             192.168.59.103Ports:          27017Starting rabbitmq (using /Users/ben/.dock-formulas/formulas/rabbitmq)Container startedName:           rabbitmqIP:             192.168.59.103Ports:          5672 15672Admin user:     adminAdmin pw:       A3y6crBkMk8k```For additional usage instructions, run `dock` without arguments.## InstallationFirst make sure that you have [Docker](https://docs.docker.com/) running onyour machine. Then continue with the installation of dock:*As of the time of writing the Homebrew Docker installer is broken. [boot2docker](https://github.com/boot2docker/osx-installer/releases) is currently the easiest way to get a working Docker environment on OS X.**dock versions >= 1.0.0 are compatible with boot2docker 1.3 and beyond. Please use v0.6.3 when you are using an old boot2docker version or upgrade your boot2docker installation.*### Installation on OS X using [Homebrew](http://brew.sh/)```brew tap bripkens/dockbrew install dock```### Upgrade on OS X using Homebrew```brew updatebrew upgrade dock```### Installation on other platformsJust download `dock` and put it somewhere on your $PATH. Then:```chmod +x /path/to/dock   # Make dock executabledock -u                  # Initialise dock```You can automate this with the following one-liner (assuming ~/bin is on your $PATH).```curl https://raw.githubusercontent.com/bripkens/dock/master/dock -so ~/bin/dock && \chmod +x ~/bin/dock && \dock -u && \echo "dock installation successful. Try running 'dock'"```## Supported programsFor a list of supported programs run `dock -l` or check out this repository's[formulas/](https://github.com/bripkens/dock/tree/master/formulas) directory.Feel free to send a pull request for any awesome Docker containers that arestill missing!## Private formulasDock will look for custom formulas in a `.dock-formulas` directory relative toyour current working directory. So if you need a formula for a custom dockerimage that you don't want to make public through docker hub, you can put yourformulas there.## Contributing formulasI will gladly accept your formulas. The following points describe the basicprocess of adding a new formula.- [Fork this repository](https://github.com/bripkens/dock/fork)- `git clone <your fork>`- Add a new file to the `formulas/` directory- Check out existing formulas for the basic formula structure- Try the new formula locally `bash forumlas/<my new formula>`- Commit, push and open a pull request## Creditsdock was written by Ben Ripkens ([@BenRipkens](https://twitter.com/BenRipkens)).Structure and readme are heavily inspired by Simon Whitaker's [gibo](https://github.com/simonwhitaker/gibo).