Docker Compose

This docker image installs docker-compose on top of the docker image. This is very useful for CI pipelines, which leverage "Docker in Docker".

Docker versions supported

There are versions based on different docker versions, e.g. latest, 17.06, 17.03 and 1.13.

docker-compose matches the latest minor version available when the docker release was made. Eg, 17.06 includes docker-compose 1.15.0. The latest tag always includes the latest docker-compose build.

All available Docker Engine versions and the respective Docker Compose versions are defined in DOCKER_AND_COMPOSE_VERSION_MATRIX.

Please open an issue or a pull request (preferred) at GitHub, if a version is missing.

Usage instructions for GitLab CI

You may use it like this in your .gitlab-ci.yml file.

image: tmaier/docker-compose:latest

services:
  - docker:dind

before_script:
  - docker info
  - docker-compose --version

build image:
  stage: build
  script:
    - docker-compose build

How to add support for a new docker version to this repository?

You must only provide a Pull Request for the file DOCKER_AND_COMPOSE_VERSION_MATRIX.

DOCKER_AND_COMPOSE_VERSION_MATRIX specifies in the first column the docker version. The second column states the most recent release of docker-compose when the docker version has been released.

You can see the latest matching versions of both by checking their release notes:

• https://github.com/docker/docker-ce/releases
• https://github.com/docker/compose/releases

Common issues and possible fixes

ERROR: error during connect: Get http://docker:2375/v1.40/info: dial tcp: ...

As of version 19.03, docker:dind will automatically generate TLS certificates and require using them for communication.

See https://github.com/tmaier/docker-compose/issues/21#issuecomment-578780163

Author

Tobias L. Maier for BauCloud GmbH