No Description

Gary Rennie b06d37f885 Documentation: Include notes on mapping ports 11 years ago
docs b06d37f885 Documentation: Include notes on mapping ports 11 years ago
fig c07e96cf2b Merge pull request #120 from marksteve/link-name 11 years ago
script 07fd01ad46 Exit deploy docs script on Fig error 11 years ago
tests bf47aa97b4 Fix tests importing six 11 years ago
.gitignore 690a7d6dd7 Add /build to gitignore 11 years ago
.travis.yml 049a10136c Test Docker 0.8.0 on Travis 11 years ago
CHANGES.md d368e2fca9 Ship 0.2.2 11 years ago
Dockerfile b20190da98 Add basic Dockerfile 11 years ago
LICENSE 84ea31dc92 Add license 12 years ago
MANIFEST.in 229b59bd6e remove tests from distribution build 11 years ago
README.md b06d37f885 Documentation: Include notes on mapping ports 11 years ago
requirements-dev.txt 5d71c33cd7 Only install unittest2 on Python 2.6 11 years ago
requirements.txt 8e42d6fbb3 Remove six from requirements 11 years ago
setup.py 274728e5fb Update homepage in setup.py 11 years ago
tox.ini bf8875d930 Added tox file 11 years ago

README.md

Fig

Build Status PyPI version

Fast, isolated development environments using Docker.

Define your app's environment with Docker so it can be reproduced anywhere:

FROM orchardup/python:2.7
ADD . /code
WORKDIR /code
RUN pip install -r requirements.txt
CMD python app.py

Define the services that make up your app so they can be run together in an isolated environment:

web:
  build: .
  links:
   - db
  ports:
   - "8000:8000"
   - "49100:22"
db:
  image: orchardup/postgresql

Note When mapping ports in the format HOST:CONTAINER you may experience erroneous results when using a container port lower than 60. This is due to YAML parsing numbers in the format "xx:yy" as sexagesimal (base 60) for this reason it is recommended to define your port mappings as strings.

(No more installing Postgres on your laptop!)

Then type fig up, and Fig will start and run your entire app:

example fig run

There are commands to:

  • start, stop and rebuild services
  • view the status of running services
  • tail running services' log output
  • run a one-off command on a service

Fig is a project from Orchard, a Docker hosting service. Follow us on Twitter to keep up to date with Fig and other Docker news.

Installation and documentation

Full documentation is available on Fig's website.

Running the test suite

$ script/test