No Description

Daniel Nephin 66ef2519d3 Merge pull request #2265 from dnephin/volumes_in_guides_doc 10 years ago
bin 620e29b63f Rename binary to docker-compose and config file to docker-compose.yml 10 years ago
compose c439e056a0 Merge pull request #2288 from dnephin/warning_about_vars 10 years ago
contrib ac06366ef9 Add zsh completion for 'docker-compose --x-networking --x-network-driver' 10 years ago
docs c7d164d01c Fixes #1843, #1936 - chown files back to host user in django example. 10 years ago
experimental 52975eca6f Fixes 10 years ago
project 6cd9bab35b Merge pull request #2276 from dnephin/update_networking_docs 10 years ago
script 8306405340 On error print daemon logs 10 years ago
tests c439e056a0 Merge pull request #2288 from dnephin/warning_about_vars 10 years ago
.dockerignore 39cea970b8 alpine docker image for running compose and a script to pull and run it with the 10 years ago
.gitignore bbc76e6034 Convert the README to rst and fix the logo url before packaging it up for pypi. 10 years ago
.pre-commit-config.yaml 9ce1884925 Add upload to bintray from travis. 10 years ago
.travis.yml 9ce1884925 Add upload to bintray from travis. 10 years ago
CHANGELOG.md bd1373f527 Bump 1.4.2 10 years ago
CHANGES.md 478054af47 Rename CHANGES.md to CHANGELOG.md 10 years ago
CONTRIBUTING.md 31e8137452 Running a single test command updated 10 years ago
Dockerfile 07e9f6500c Pipe curl's download directly to extract/execute program to reduce number of commands 10 years ago
Dockerfile.run 4ae2a0e610 Update release scripts for release image. 10 years ago
LICENSE 99064d17dd Docker, Inc. 11 years ago
MAINTAINERS 63941b8f6c Add Mazz to MAINTAINERS 10 years ago
MANIFEST.in bbc76e6034 Convert the README to rst and fix the logo url before packaging it up for pypi. 10 years ago
README.md 379af594da Include link to github for code&issues 10 years ago
ROADMAP.md 41406cdd68 Update roadmap with state convergence 10 years ago
SWARM.md c421d23c34 Update Swarm docs 10 years ago
appveyor.yml 0e9ec8aa74 Add publish to bintray step to appveyor.yml 10 years ago
docker-compose.spec ecea79fd4e Bundle schema files 10 years ago
logo.png 0bdbb33447 include logo in README 10 years ago
requirements-build.txt 0340361f56 Upgrade pyinstaller to 3.0 10 years ago
requirements-dev.txt c1ed1efde8 Use py.test as the test runner 10 years ago
requirements.txt 7c6e7e0dce Update docker-py to 1.5.0 10 years ago
setup.py fe760a7b62 Include additional classifiers 10 years ago
tox.ini d5f5eb1924 Enable use of Docker networking with the --x-networking flag 10 years ago

README.md

Docker Compose

Docker Compose

(Previously known as Fig)

Compose is a tool for defining and running multi-container applications with Docker. With Compose, you define a multi-container application in a single file, then spin your application up in a single command which does everything that needs to be done to get it running.

Compose is great for development environments, staging servers, and CI. We don't recommend that you use it in production yet.

Using Compose is basically a three-step process.

  1. Define your app's environment with a Dockerfile so it can be reproduced anywhere.
  2. Define the services that make up your app in docker-compose.yml so they can be run together in an isolated environment:
  3. Lastly, run docker-compose up and Compose will start and run your entire app.

A docker-compose.yml looks like this:

web:
  build: .
  ports:
   - "5000:5000"
  volumes:
   - .:/code
  links:
   - redis
redis:
  image: redis

Compose has commands for managing the whole lifecycle of your application:

  • Start, stop and rebuild services
  • View the status of running services
  • Stream the log output of running services
  • Run a one-off command on a service

Installation and documentation

Contributing

Build Status

Want to help build Compose? Check out our contributing documentation.

Releasing

Releases are built by maintainers, following an outline of the release process.