Changelog History
Page 10
-
v1.8.1 Changes
September 22, 2016🐛 Bug Fixes
🛠 Fixed a bug where users using a credentials store were not able to access their private images.
🛠 Fixed a bug where users using identity tokens to authenticate were not able to access their private images.
🛠 Fixed a bug where an
HttpHeaders
entry in the docker configuration file would cause Compose to crash when trying to build an image.🛠 Fixed a few bugs related to the handling of Windows paths in volume binding declarations.
🛠 Fixed a bug where Compose would sometimes crash while trying to read a streaming response from the engine.
🛠 Fixed an issue where Compose would crash when encountering an API error while streaming container logs.
🛠 Fixed an issue where Compose would erroneously try to output logs from drivers not handled by the Engine's API.
🛠 Fixed a bug where options from the
docker-machine config
command would not be properly interpreted by Compose.🛠 Fixed a bug where the connection to the Docker Engine would sometimes fail when running a large number of services simultaneously.
🛠 Fixed an issue where Compose would sometimes print a misleading suggestion message when running the
bundle
command.🛠 Fixed a bug where connection errors would not be handled properly by Compose during the project initialization phase.
🛠 Fixed a bug where a misleading error would appear when encountering a connection timeout.
-
v1.8.0 Changes
June 14, 2016💥 Breaking Changes
🐳 As announced in 1.7.0,
docker-compose rm
now removes containers created bydocker-compose run
by default.0️⃣ Setting
entrypoint
on a service now empties out any default command that was set on the image (i.e. anyCMD
instruction in the Dockerfile used to build it). This makes it consistent with the--entrypoint
flag todocker run
.
🆕 New Features
➕ Added
docker-compose bundle
, a command that builds a bundle file to be consumed by the new Docker Stack commands in Docker 1.12.➕ Added
docker-compose push
, a command that pushes service images to a registry.👍 Compose now supports specifying a custom TLS version for interaction with the Docker Engine using the
COMPOSE_TLS_VERSION
environment variable.
🐛 Bug Fixes
🛠 Fixed a bug where Compose would erroneously try to read
.env
at the project's root when it is a directory.🐳
docker-compose run -e VAR
now passesVAR
through from the shell to the container, as withdocker run -e VAR
.👌 Improved config merging when multiple compose files are involved for several service sub-keys.
🛠 Fixed a bug where volume mappings containing Windows drives would sometimes be parsed incorrectly.
🛠 Fixed a bug in Windows environment where volume mappings of the host's root directory would be parsed incorrectly.
🛠 Fixed a bug where
docker-compose config
would output an invalid Compose file if external networks were specified.🛠 Fixed an issue where unset buildargs would be assigned a string containing
'None'
instead of the expected empty value.🛠 Fixed a bug where yes/no prompts on Windows would not show before receiving input.
🛠 Fixed a bug where trying to
docker-compose exec
on Windows without the-d
option would exit with a stacktrace. This will still fail for the time being, but should do so gracefully.🛠 Fixed a bug where errors during
docker-compose up
would show an unrelated stacktrace at the end of the process.🐳
docker-compose create
anddocker-compose start
show more descriptive error messages when something goes wrong.
-
v1.7.1 Changes
May 04, 2016🐛 Bug Fixes
🛠 Fixed a bug where the output of
docker-compose config
for v1 files would be an invalid configuration file.🛠 Fixed a bug where
docker-compose config
would not check the validity of links.🛠 Fixed an issue where
docker-compose help
would not output a list of available commands and generic options as expected.🛠 Fixed an issue where filtering by service when using
docker-compose logs
would not apply for newly created services.🛠 Fixed a bug where unchanged services would sometimes be recreated in in the up phase when using Compose with Python 3.
🛠 Fixed an issue where API errors encountered during the up phase would not be recognized as a failure state by Compose.
🛠 Fixed a bug where Compose would raise a NameError because of an undefined exception name on non-Windows platforms.
🛠 Fixed a bug where the wrong version of
docker-py
would sometimes be installed alongside Compose.🛠 Fixed a bug where the host value output by
docker-machine config default
would not be recognized as valid options by thedocker-compose
command line.🛠 Fixed an issue where Compose would sometimes exit unexpectedly while reading events broadcasted by a Swarm cluster.
📄 Corrected a statement in the docs about the location of the
.env
file, which is indeed read from the current directory, instead of in the same location as the Compose file.
-
v1.7.0 Changes
April 13, 2016💥 Breaking Changes
🐳
docker-compose logs
no longer follows log output by default. It now matches the behaviour ofdocker logs
and exits after the current logs are printed. Use-f
to get the old default behaviour.Booleans are no longer allows as values for mappings in the Compose file (for keys
environment
,labels
andextra_hosts
). Previously this was a warning. Boolean values should be quoted so they become string values.
🆕 New Features
Compose now looks for a
.env
file in the directory where it's run and reads any environment variables defined inside, if they're not already set in the shell environment. This lets you easily set defaults for variables used in the Compose file, or for any of theCOMPOSE_*
orDOCKER_*
variables.🐳 Added a
--remove-orphans
flag to bothdocker-compose up
anddocker-compose down
to remove containers for services that were removed from the Compose file.🐳 Added a
--all
flag todocker-compose rm
to include containers created bydocker-compose run
. This will become the default behavior in the next version of Compose.🐳 Added support for all the same TLS configuration flags used by the
docker
client:--tls
,--tlscert
,--tlskey
, etc.👍 Compose files now support the
tmpfs
andshm_size
options.🐳 Added the
--workdir
flag todocker-compose run
🐳
docker-compose logs
now shows logs for new containers that are created after it starts.The
COMPOSE_FILE
environment variable can now contain multiple files, separated by the host system's standard path separator (:
on Mac/Linux,;
on Windows).You can now specify a static IP address when connecting a service to a network with the
ipv4_address
andipv6_address
options.Added
--follow
,--timestamp
, and--tail
flags to thedocker-compose logs
command.🐳
docker-compose up
, anddocker-compose start
will now start containers in parallel where possible.🐳
docker-compose stop
now stops containers in reverse dependency order instead of all at once.🏗 Added the
--build
flag todocker-compose up
to force it to build a new image. It now shows a warning if an image is automatically built when the flag is not used.🐳 Added the
docker-compose exec
command for executing a process in a running container.
🐛 Bug Fixes
🐳
docker-compose down
now removes containers created bydocker-compose run
.⏱ A more appropriate error is shown when a timeout is hit during
up
when using a tty.🐳 Fixed a bug in
docker-compose down
where it would abort if some resources had already been removed.🛠 Fixed a bug where changes to network aliases would not trigger a service to be recreated.
🖨 Fix a bug where a log message was printed about creating a new volume when it already existed.
🛠 Fixed a bug where interrupting
up
would not always shut down containers.🌲 Fixed a bug where
log_opt
andlog_driver
were not properly carried over when extending services in the v1 Compose file format.🏗 Fixed a bug where empty values for build args would cause file validation to fail.
-
v1.6.2 Changes
February 23, 2016- 🐳 Fixed a bug where connecting to a TLS-enabled Docker Engine would fail with a certificate verification error.
-
v1.6.1 Changes
February 23, 2016🐛 Bug Fixes
🛠 Fixed a bug where recreating a container multiple times would cause the new container to be started without the previous volumes.
🛠 Fixed a bug where Compose would set the value of unset environment variables to an empty string, instead of a key without a value.
👍 Provide a better error message when Compose requires a more recent version of the Docker API.
Add a missing config field
network.aliases
which allows setting a network scoped alias for a service.🛠 Fixed a bug where
run
would not start services listed independs_on
.🔀 Fixed a bug where
networks
andnetwork_mode
where not merged when using extends or multiple Compose files.🛠 Fixed a bug with service aliases where the short container id alias was only contained 10 characters, instead of the 12 characters used in previous versions.
🌲 Added a missing log message when creating a new named volume.
🏗 Fixed a bug where
build.args
was not merged when usingextends
or multiple Compose files.🛠 Fixed some bugs with config validation when null values or incorrect types were used instead of a mapping.
🏗 Fixed a bug where a
build
section without acontext
would show a stack trace instead of a helpful validation message.Improved compatibility with swarm by only setting a container affinity to the previous instance of a services' container when the service uses an anonymous container volume. Previously the affinity was always set on all containers.
🛠 Fixed the validation of some
driver_opts
would cause an error if a number was used instead of a string.Some improvements to the
run.sh
script used by the Compose container install option.🛠 Fixed a bug with
up --abort-on-container-exit
where Compose would exit, but would not stop other containers.⚠ Corrected the warning message that is printed when a boolean value is used as a value in a mapping.
-
v1.6.0 Changes
January 15, 2016Major Features:
🐳 Compose 1.6 introduces a new format for
docker-compose.yml
which lets you define networks and volumes in the Compose file as well as services. It also makes a few changes to the structure of some configuration options.You don't have to use it - your existing Compose files will run on Compose 1.6 exactly as they do today.
Check the upgrade guide for full details: https://docs.docker.com/compose/compose-file#upgrading
👍 Support for networking has exited experimental status and is the recommended way to enable communication between containers.
If you use the new file format, your app will use networking. If you aren't ready yet, just leave your Compose file as it is and it'll continue to work just the same.
By default, you don't have to configure any networks. In fact, using networking with Compose involves even less configuration than using links. Consult the networking guide for how to use it: https://docs.docker.com/compose/networking
The experimental flags
--x-networking
and--x-network-driver
, introduced in Compose 1.5, have been removed.🏗 You can now pass arguments to a build if you're using the new file format:
build: context: . args: buildno: 1
🏗 You can now specify both a
build
and animage
key if you're using the new file format.docker-compose build
will build the image and tag it with the name you've specified, whiledocker-compose pull
will attempt to pull it.There's a new
events
command for monitoring container events from the application, much likedocker events
. This is a good primitive for building tools on top of Compose for performing actions when particular things happen, such as containers starting and stopping.There's a new
depends_on
option for specifying dependencies between services. This enforces the order of startup, and ensures that when you rundocker-compose up SERVICE
on a service with dependencies, those are started as well.
🆕 New Features:
🖨 Added a new command
config
which validates and prints the Compose configuration after interpolating variables, resolving relative paths, and merging multiple files andextends
.Added a new command
create
for creating containers without starting them.🚚 Added a new command
down
to stop and remove all the resources created byup
in a single command.🔧 Added support for the
cpu_quota
configuration option.🚦 Added support for the
stop_signal
configuration option.Commands
start
,restart
,pause
, andunpause
now exit with an error status code if no containers were modified.Added a new
--abort-on-container-exit
flag toup
which causesup
to stop all container and exit once the first container exits.Removed support for
FIG_FILE
,FIG_PROJECT_NAME
, and no longer readsfig.yml
as a default Compose file location.🚚 Removed the
migrate-to-labels
command.🚚 Removed the
--allow-insecure-ssl
flag.
🐛 Bug Fixes:
🛠 Fixed a validation bug that prevented the use of a range of ports in the
expose
field.🛠 Fixed a validation bug that prevented the use of arrays in the
entrypoint
field if they contained duplicate entries.🛠 Fixed a bug that caused
ulimits
to be ignored when used withextends
.🛠 Fixed a bug that prevented ipv6 addresses in
extra_hosts
.🛠 Fixed a bug that caused
extends
to be ignored when included from multiple Compose files.⚠ Fixed an incorrect warning when a container volume was defined in the Compose file.
🛠 Fixed a bug that prevented the force shutdown behaviour of
up
andlogs
.🖨 Fixed a bug that caused
None
to be printed as the network driver name when the default network driver was used.🛠 Fixed a bug where using the string form of
dns
ordns_search
would cause an error.🛠 Fixed a bug where a container would be reported as "Up" when it was in the restarting state.
Fixed a confusing error message when DOCKER_CERT_PATH was not set properly.
🛠 Fixed a bug where attaching to a container would fail if it was using a non-standard logging driver (or none at all).
-
v1.5.2 Changes
December 03, 2015🛠 Fixed a bug which broke the use of
environment
andenv_file
withextends
, and caused environment keys without values to have aNone
value, instead of a value from the host environment.⚠ Fixed a regression in 1.5.1 that caused a warning about volumes to be raised incorrectly when containers were recreated.
🏗 Fixed a bug which prevented building a
Dockerfile
that usedADD <url>
🐳 Fixed a bug with
docker-compose restart
which prevented it from starting stopped containers.🛠 Fixed handling of SIGTERM and SIGINT to properly stop containers
🏗 Add support for using a url as the value of
build
Improved the validation of the
expose
option
-
v1.5.1 Changes
November 12, 2015🏗 Add the
--force-rm
option tobuild
.Add the
ulimit
option for services in the Compose file.🛠 Fixed a bug where
up
would error with "service needs to be built" if a service changed from usingimage
to usingbuild
.🛠 Fixed a bug that would cause incorrect output of parallel operations on some terminals.
🛠 Fixed a bug that prevented a container from being recreated when the mode of a
volumes_from
was changed.🛠 Fixed a regression in 1.5.0 where non-utf-8 unicode characters would cause
up
orlogs
to crash.🛠 Fixed a regression in 1.5.0 where Compose would use a success exit status code when a command fails due to an HTTP timeout communicating with the docker daemon.
🛠 Fixed a regression in 1.5.0 where
name
was being accepted as a valid service option which would override the actual name of the service.When using
--x-networking
Compose no longer sets the hostname to the container name.0️⃣ When using
--x-networking
Compose will only create the default network if at least one container is using the network.🔊 When printings logs during
up
orlogs
, flush the output buffer after each line to prevent buffering issues from hiding logs.Recreate a container if one of its dependencies is being created. Previously a container was only recreated if it's dependencies already existed, but were being recreated as well.
⚠ Add a warning when a
volume
in the Compose file is being ignored and masked by a container volume from a previous container.Improve the output of
pull
when run without a tty.🔀 When using multiple Compose files, validate each before attempting to merge them together. Previously invalid files would result in not helpful errors.
Allow dashes in keys in the
environment
service option.Improve validation error messages by including the filename as part of the error message.
-
v1.5.0 Changes
November 03, 2015💥 Breaking changes:
👍 With the introduction of variable substitution support in the Compose file, any Compose file that uses an environment variable (
$VAR
or${VAR}
) in thecommand:
orentrypoint:
field will break.Previously these values were interpolated inside the container, with a value from the container environment. In Compose 1.5.0, the values will be interpolated on the host, with a value from the host environment.
To migrate a Compose file to 1.5.0, escape the variables with an extra
$
👀 (ex:$$VAR
or$${VAR}
). See 🐳 https://github.com/docker/compose/blob/8cc8e61/docs/compose-file.md#variable-substitutionMajor features:
🏁 Compose is now available for Windows.
👀 Environment variables can be used in the Compose file. See https://github.com/docker/compose/blob/8cc8e61/docs/compose-file.md#variable-substitution
Multiple compose files can be specified, allowing you to override settings in the default Compose file. See https://github.com/docker/compose/blob/8cc8e61/docs/reference/docker-compose.md for more details.
👍 Compose now produces better error messages when a file contains invalid configuration.
up
now waits for all services to exit before shutting down, rather than shutting down as soon as one container exits.🐳 Experimental support for the new docker networking system can be enabled with the
--x-networking
flag. Read more here: https://github.com/docker/docker/blob/8fee1c20/docs/userguide/dockernetworks.md
🆕 New features:
You can now optionally pass a mode to
volumes_from
, e.g.volumes_from: ["servicename:ro"]
.🐳 Since Docker now lets you create volumes with names, you can refer to those volumes by name in
docker-compose.yml
. For example,volumes: ["mydatavolume:/data"]
will mount the volume namedmydatavolume
at the path/data
inside the container.If the first component of an entry in
volumes
starts with a.
,/
or~
, it is treated as a path and expansion of relative paths is performed as necessary. Otherwise, it is treated as a volume name and passed straight through to Docker.Read more on named volumes and volume drivers here: https://github.com/docker/docker/blob/244d9c33/docs/userguide/dockervolumes.md
🏗
docker-compose build --pull
instructs Compose to pull the base image for each Dockerfile before building.🐳
docker-compose pull --ignore-pull-failures
instructs Compose to continue if it fails to pull a single service's image, rather than aborting.🐳 You can now specify an IPC namespace in
docker-compose.yml
with theipc
option.🐳 Containers created by
docker-compose run
can now be named with the--name
flag.If you install Compose with pip or use it as a library, it now works with Python 3.
👍
image
now supports image digests (in addition to ids and tags), e.g.image: "busybox@sha256:38a203e1986cf79639cfb9b2e1d6e773de84002feea2d4eb006b52004ee8502d"
👍
ports
now supports ranges of ports, e.g.ports: - "3000-3005" - "9000-9001:8000-8001"
🐳
docker-compose run
now supports a-p|--publish
parameter, much likedocker run -p
, for publishing specific ports to the host.🐳
docker-compose pause
anddocker-compose unpause
have been implemented, analogous todocker pause
anddocker unpause
.🔧 When using
extends
to copy configuration from another service in the same Compose file, you can omit thefile
option.🐳 Compose can be installed and run as a Docker image. This is an experimental feature.
🐛 Bug fixes:
🐳 All values for the
log_driver
option which are supported by the Docker daemon are now supported by Compose.🏗
docker-compose build
can now be run successfully against a Swarm cluster.