README.md

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".

This Docker image is DEPRECATED

This image is deprecated, since the docker image has now Docker Compose included. This has been introduced by docker-library/docker#361.

Docker versions supported

The Docker Compose versions supported here use the most recent docker version compatible with it.

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.

Note: In the past. this docker image (tags) focused on the docker version (e.g. latest, 20.10, 19.03 and 19). But as the docker releases got less disruptive, the approach changes to use the docker compose version as tags.

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 or https://hub.docker.com/_/docker
• 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 #21 (comment)

Author

Tobias L. Maier for BauCloud GmbH