Releases: docker/compose
1.1.0-rc1
Fig has been renamed to Docker Compose, or just Compose for short. This has several implications for you:
- The command you type is now
docker-compose
, notfig
. - You should rename your fig.yml to docker-compose.yml.
- The PyPi package is now
docker-compose
.
This is a release candidate for Docker Compose 1.1.0. To try it out, install via curl:
curl -L https://github.com/docker/fig/releases/download/1.1.0-rc1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose; chmod +x /usr/local/bin/docker-compose
(If you install via PyPi, use pip install docker-compose==1.1.0-rc1
.)
Besides the rename, there’s a lot of new stuff:
- 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 thelatest
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 todocker 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
andrestart
options, analogous todocker run
’s--dns-search
,--cap-add
,--cap-drop
and--restart
options. - A number of bugs have been fixed - see the milestone for details: https://github.com/docker/fig/issues?q=milestone%3A1.1.0+
1.0.1
Install/upgrade instructions here.
- Added an
--allow-insecure-ssl
option to allowfig up
,fig run
andfig pull
to pull from insecure registries. - Fixed
fig run
not showing output in Jenkins. - Fixed a bug where Fig couldn't build Dockerfiles with ADD statements pointing at URLs.
1.0.0
Install/upgrade instructions here.
The highlights:
-
Fig has joined Docker. Fig will continue to be maintained, but we'll also be incorporating the best bits of Fig into Docker itself.
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
andDOCKER_TLS_VERIFY
environment variables. -
There is a new
fig port
command which outputs the host port binding of a service, in a similar way todocker 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 variablesDB_PORT_5432_TCP_ADDR
andDB_PORT_5432_TCP_PORT
, you could just use the hostnamedb
and port5432
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 tofig 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.- When starting a service where
volumes_from
points to a service without any containers running, that service will now be started. - Lots of docs improvements. Notably, environment variables are documented and official repositories are used throughout.
Thanks @dnephin, @d11wtq, @marksteve, @rubbish, @jbalonso, @timfreund, @alunduil, @mieciu, @shuron, @moss, @suzaku and @chmouel! Whew.
0.5.2
Install/upgrade instructions here.
- Added a
--no-cache
option tofig build
, which bypasses the cache just likedocker build --no-cache
. - Fixed the
dns:
fig.yml option, which was causing fig to error out. - Fixed a bug where fig couldn't start under Python 2.6.
- Fixed a log-streaming bug that occasionally caused fig to exit.
Thanks @dnephin and @marksteve!
0.5.1
Install/upgrade instructions here. Note that Fig now requires Docker 1.0 or greater.
- If a service has a command defined,
fig run [service]
with no further arguments will run it. - The project name now defaults to the directory containing fig.yml, not the current working directory (if they're different)
volumes_from
now works properly with containers as well as services- Fixed a race condition when recreating containers in
fig up
Thanks @ryanbrainard and @d11wtq!
0.5.0
Install/upgrade instructions here. Note that Fig now requires Docker 1.0 or greater.
Lots of new stuff in this one:
-
Fig now starts links when you run
fig run
orfig up
.For example, if you have a
web
service which depends on adb
service,fig run web ...
will start thedb
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 infig.yml
. All of the volumes from the specified services and containers will be mounted:volumes_from: - service_name - container_name
-
The
net
andworkdir
options are now supported infig.yml
. -
The
hostname
option now works in the same way as the Docker CLI, splitting out into adomainname
option. -
TTY behaviour is far more robust, and resizes are supported correctly.
-
Load YAML files safely.
Thanks to @d11wtq, @ryanbrainard, @rail44, @j0hnsmith, @binarin, @Elemecca and @mozz100 for their help with this release!
0.4.2
This release fixes various encoding errors when using fig run
, fig up
and fig build
.
0.4.1
- Add support for Docker 0.11.0. (Thanks @marksteve!)
- Make project name configurable. (Thanks @jefmathiot!)
- Return correct exit code from
fig run
.
0.4.0
- Fig supports Docker 0.9 and 0.10. Docker 0.8 is no longer supported.
- Progress bars are displayed correctly when pulling images (no more ski slopes).
fig up
now stops all services when any container exits.- fig.yml supports the
privileged
config option (thanks @kvz!) - Log prefixes in
fig up
output are shorter and aligned. - Only containers started with
fig run
link back to their own service. - UTF-8 is handled correctly when streaming
fig build/run/up
output (thanks @mauvm and @shanejonas!) - Some error messages are a bit nicer.
Fig is a tool for creating and running fast, isolated development environments using Docker.
If you've already got an older Fig installed, no sweat - upgrading from a previous version is the same as installing from scratch. Make sure your Docker is up-to-date too (0.9+).
0.3.2
- Added an
--rm
option tofig run
. (Thanks @marksteve!) - Added an
expose
option tofig.yml
.