Skip to content

Latest commit

 

History

History
69 lines (48 loc) · 1.84 KB

README.template.md

File metadata and controls

69 lines (48 loc) · 1.84 KB

${APP}

Work with docker-compose manifests for multiple hosts.

Contents

Get it

Using go get

go get -u github.com/keilerkonzept/${APP}

Pre-built binary

Download a binary from the releases page or from the shell:

# Linux
curl -L https://github.com/keilerkonzept/${APP}/releases/download/${VERSION}/${APP}_${VERSION}_linux_x86_64.tar.gz | tar xz

# OS X
curl -L https://github.com/keilerkonzept/${APP}/releases/download/${VERSION}/${APP}_${VERSION}_osx_x86_64.tar.gz | tar xz

# Windows
curl -LO https://github.com/keilerkonzept/${APP}/releases/download/${VERSION}/${APP}_${VERSION}_windows_x86_64.zip
unzip ${APP}_${VERSION}_windows_x86_64.zip

Usage

${APP} reads project definitions from a ${APP}.yml file, and forwards all positional arguments to docker-compose for each of the projects.

Command-line interface syntax

${APP} [OPTIONS] -- [COMMAND [ARGS...]]
${USAGE}

docker-compose-hosts.yml syntax

Example file with all fields below; see also example/docker-compose-hosts.yml.

version: '1.0'
projects:
  project-name-goes-here:
    compose_file: (path to docker-compose.yml)
    docker_host: (value for DOCKER_HOST, optional)
  another-project-name-goes-here:
    compose_file: (path to docker-compose.yml)
    docker_host: (value for DOCKER_HOST, optional)

All string fields except version support $ENVVARS; A literal $ can be produced using the escape $$.