docker-builder

README

Welcome to Bob!

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

Other Topics

• Original Motivation for Docker Builder
• Docker Builder Server
• Writing a Bobfile

Quick Start

Steps to quick start:

# install docker-builder
go get github.com/rafecolton/docker-builder

$GOPATH/bin/docker-builder --help

More Reasonably-Paced Start

1. Install docker-builder
2. Explore the Writing a Bobfile doc
3. Rundocker-builder --help
4. Run docker-builder help build

Installing docker-builder

Easiest

go get github.com/rafecolton/docker-builder

From pre-compiled binaries

# on Mac OS X
curl -sL https://github.com/rafecolton/docker-builder/releases/download/v0.9.2/docker-builder-v0.9.2-darwin-amd64 \
  -o /usr/local/bin/docker-builder && chmod +x /usr/local/bin/docker-builder

# on Linux, note: you may need sudo
curl -sL https://github.com/rafecolton/docker-builder/releases/download/v0.9.2/docker-builder-v0.9.2-linux-amd64 \
  -o /usr/local/bin/docker-builder && chmod +x /usr/local/bin/docker-builder

NOTE: Checksums available on the release page

From source

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

Using with TLS

If you are using a version of docker with TLS enabled (supported in docker v1.3.0 and up, enabled by default with boot2docker), you will need to use docker-builder v0.9.2 or greater.

Additionally, you must set the following environment variables:

# all values are the boot2docker defaults
export DOCKER_CERT_PATH="$HOME/.boot2docker/certs/boot2docker-vm"
export DOCKER_TLS_VERIFY=1
export DOCKER_HOST="tcp://127.0.0.1:2376"

NOTE: docker-builder will automatically set the correct url scheme for TLS if you are using port 2376. If you are using another port and wish to enable TLS, you must set the following additional environment variable:

export DOCKER_HOST_SCHEME="https"

Contributing

Pull requests welcome!