top
(README.md)
# Welcome to Bob!

[![Build Status](https://travis-ci.org/modcloth/docker-builder.svg?branch=master)](https://travis-ci.org/modcloth/docker-builder)
[![GoDoc](https://godoc.org/github.com/modcloth/docker-builder?status.png)](https://godoc.org/github.com/modcloth/docker-builder)

Bob, the `docker-builder`, builds, tags, and pushes multiple Docker images, all
from a friendly `Bobfile` config file.

## Quick Start

Steps to quick start:

```bash
# install docker-builder
go get github.com/modcloth/docker-builder

# create a Bobfile
docker-builder init .

# build the aforementioned Bobfile
docker-builder build Bobfile
```

## More Reasonably-Paced Start
0. Install `docker-builder`
0. Explore the [Writing a Bobfile](docs/writing-a-bobfile.md) doc
0. Run`docker-builder --help`
0. Run `docker-builder help build`

### First, Install `docker-builder`

#### Easiest

```bash
go get github.com/modcloth/docker-builder
```

#### From pre-compiled binaries

```bash
# on Mac OS X
curl -sL https://github.com/modcloth/docker-builder/releases/download/v0.4.1/docker-builder-v0.4.1-darwin-amd64.tar.gz | \
  tar -xzf - -C /usr/local --strip-components=1

# on Linux, note: you may need sudo
curl -sL https://github.com/modcloth/docker-builder/releases/download/v0.4.1/docker-builder-v0.4.1-linux-amd64.tar.gz | \
  sudo tar -xzf - -C /usr/local --strip-components=1
```

These commands will place `docker-builder` at
`/usr/local/bin/docker-builder`, so to use `docker-builder`, make sure
and check that `/usr/local/bin` is in your `$PATH` or change the `-C`
option.

**NOTE:** You may see some junk output when running `tar -xzf`.  This
has something to do with the archives being build on Mac OSX.  The
output is harmless and safe to ignore.

#### From source

To build from source, run `make build`.  You may have to install some
things first, such as `go`.

## Other Docs

* [Why?](docs/why.md)
* [Advanced Usage](docs/advanced-usage.md)

Imports 15 package(s) ΒΆ

  1. github.com/kelseyhightower/envconfig
  2. github.com/modcloth/queued-command-runner
  3. github.com/martini-contrib/auth
  4. github.com/BurntSushi/toml
  5. github.com/modcloth/docker-builder/parser
  6. github.com/Sirupsen/logrus
  7. github.com/modcloth/docker-builder/version
  8. github.com/codegangsta/cli
  9. github.com/modcloth/docker-builder/job
  10. github.com/onsi/gocleanup
  11. github.com/modcloth/kamino
  12. github.com/modcloth/go-fileutils
  13. github.com/modcloth/docker-builder/builder
  14. github.com/modcloth/docker-builder/analyzer
  15. github.com/go-martini/martini