Fig has been renamed to Docker Compose, or just Compose for short. This has several implications for you:
docker-compose, not fig.docker-compose, so install it with pip install docker-compose.Besides that, there’s a lot of new stuff in this release:
We’ve made a few small changes to ensure that Compose will work with Swarm, Docker’s new clustering tool (https://github.com/docker/swarm). Eventually you'll be able to point Compose at a Swarm cluster instead of a standalone Docker host and it’ll run your containers on the cluster with no extra work from you. As Swarm is still developing, integration is rough and lots of Compose features don't work yet.
docker-compose run now has a --service-ports flag for exposing ports on the given service. This is useful for e.g. running your webapp with an interactive debugger.
You can now link to containers outside your app with the external_links option in docker-compose.yml.
You can now prevent docker-compose up from automatically building images with the --no-build option. This will make fewer API calls and run faster.
If you don’t specify a tag when using the image key, Compose will default to the latest tag, rather than pulling all tags.
docker-compose kill now supports the -s flag, allowing you to specify the exact signal you want to send to a service’s containers.
docker-compose.yml now has an env_file key, analogous to docker run --env-file, letting you specify multiple environment variables in a separate file. This is great if you have a lot of them, or if you want to keep sensitive information out of version control.
docker-compose.yml now supports the dns_search, cap_add, cap_drop, cpu_shares and restart options, analogous to docker run’s --dns-search, --cap-add, --cap-drop, --cpu-shares and --restart options.
Compose now ships with Bash tab completion - see the installation and usage docs at https://github.com/docker/compose/blob/1.1.0/docs/completion.md
A number of bugs have been fixed - see the milestone for details: https://github.com/docker/compose/issues?q=milestone%3A1.1.0+
Thanks @dnephin, @squebe, @jbalonso, @raulcd, @benlangfield, @albers, @ggtools, @bersace, @dtenenba, @petercv, @drewkett, @TFenby, @paulRbr, @Aigeruth and @salehe!
--allow-insecure-ssl option to allow fig up, fig run and fig pull to pull from insecure registries.fig run not showing output in Jenkins.The highlights:
This means the GitHub repository has moved to https://github.com/docker/fig and our IRC channel is now #docker-fig on Freenode.
Fig can be used with the official Docker OS X installer. Boot2Docker will mount the home directory from your host machine so volumes work as expected.
Fig supports Docker 1.3.
It is now possible to connect to the Docker daemon using TLS by using the DOCKER_CERT_PATH and DOCKER_TLS_VERIFY environment variables.
There is a new fig port command which outputs the host port binding of a service, in a similar way to docker port.
There is a new fig pull command which pulls the latest images for a service.
There is a new fig restart command which restarts a service's containers.
Fig creates multiple containers in service by appending a number to the service name (e.g. db_1, db_2, etc). As a convenience, Fig will now give the first container an alias of the service name (e.g. db).
This link alias is also a valid hostname and added to /etc/hosts so you can connect to linked services using their hostname. For example, instead of resolving the environment variables DB_PORT_5432_TCP_ADDR and DB_PORT_5432_TCP_PORT, you could just use the hostname db and port 5432 directly.
Volume definitions now support ro mode, expanding ~ and expanding environment variables.
.dockerignore is supported when building.
The project name can be set with the FIG_PROJECT_NAME environment variable.
The --env and --entrypoint options have been added to fig run.
The Fig binary for Linux is now linked against an older version of glibc so it works on CentOS 6 and Debian Wheezy.
Other things:
fig ps now works on Jenkins and makes fewer API calls to the Docker daemon.--verbose displays more useful debugging output.volumes_from points to a service without any containers running, that service will now be started.Thanks @dnephin, @d11wtq, @marksteve, @rubbish, @jbalonso, @timfreund, @alunduil, @mieciu, @shuron, @moss, @suzaku and @chmouel! Whew.
--no-cache option to fig build, which bypasses the cache just like docker build --no-cache.dns: fig.yml option, which was causing fig to error out.Thanks @dnephin and @marksteve!
fig run [service] with no further arguments will run it.volumes_from now works properly with containers as well as servicesfig upThanks @ryanbrainard and @d11wtq!
fig run or fig up.
For example, if you have a web service which depends on a db service, fig run web ... will start the db service.
Environment variables can now be resolved from the environment that Fig is running in. Just specify it as a blank variable in your fig.yml and, if set, it'll be resolved:
environment:
RACK_ENV: development
SESSION_SECRET:
volumes_from is now supported in fig.yml. All of the volumes from the specified services and containers will be mounted:
volumes_from:
- service_name
- container_name
A host address can now be specified in ports:
ports:
- "0.0.0.0:8000:8000"
- "127.0.0.1:8001:8001"
The net and workdir options are now supported in fig.yml.
The hostname option now works in the same way as the Docker CLI, splitting out into a domainname option.
TTY behaviour is far more robust, and resizes are supported correctly.
Load YAML files safely.
Thanks to @d11wtq, @ryanbrainard, @rail44, @j0hnsmith, @binarin, @Elemecca, @mozz100 and @marksteve for their help with this release!
fig run, fig up and fig build.fig run.fig up now stops all services when any container exitsprivileged config option in fig.yml (thanks @kvz!)fig up outputfig run link back to their own servicefig build/run/up output (thanks @mauvm and @shanejonas!)--rm option to fig run. (Thanks @marksteve!)expose option to fig.yml.fig rm throwing an error.fig ps on Docker 0.8.1 when there is a container with no command.-f flag to specify alternate fig.yml filesThanks @marksteve, @Gazler and @teozkr!
fig up not printing log outputThanks to @barnybug and @dustinlacewell for their work on this release.
.yaml extension. (#58)Big thanks to @cameronmaske, @mrchrisadams and @damianmoore for their help with this release.
REDIS_1_PORT_6379_TCP_ADDR. (#54)-T option to fig run to disable pseudo-TTY. (#34)fig up requiring the ubuntu image to be pulled to recreate containers. (#33) Thanks @cameronmaske!fig run. (#34, #39, #40)fig up, ensuring config is up-to-date with fig.yml (#2)fig scale command (#9)DOCKER_HOST environment variable to find Docker daemon, for consistency with the official Docker client (was previously DOCKER_URL) (#19)fig ps (#18)fig.yml is missing (#4)fig build logging (#3)Big thanks to @tomstuart, @EnTeQuAk, @schickling, @aronasorman and @GeoffreyPlitt.
tcp://localdocker:4243 and a UNIX socket in addition to localhost.fig up behaviourfig rmfig build commandInitial release.