github.com-tmaier-docker-co.../README.md

# Docker Compose

[![Docker Automated build](https://img.shields.io/docker/automated/tmaier/docker-compose.svg)](https://hub.docker.com/r/tmaier/docker-compose/)
[![Docker Pulls](https://img.shields.io/docker/pulls/tmaier/docker-compose.svg)](https://hub.docker.com/r/tmaier/docker-compose/)
[![GitHub issues](https://img.shields.io/github/issues/tmaier/docker-compose.svg)](https://github.com/tmaier/docker-compose/issues)
[![GitHub stars](https://img.shields.io/github/stars/tmaier/docker-compose.svg?style=social&label=Star)](https://github.com/tmaier/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](https://hub.docker.com/_/docker) has now Docker Compose included.
This has been introduced by [docker-library/docker#361](https://github.com/docker-library/docker/pull/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`](./DOCKER_AND_COMPOSE_VERSION_MATRIX).

Please open an issue or a pull request (preferred) [at GitHub](https://github.com/tmaier/docker-compose), 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.

```yaml
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).

`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 <https://github.com/tmaier/docker-compose/issues/21#issuecomment-578780163>

## Author

[Tobias L. Maier](http://tobiasmaier.info) for [BauCloud GmbH](https://www.baucloud.com)
Add README.md 2017-01-04 01:52:31 +01:00			`# Docker Compose`

Remove unsupported docker/docker-compose versions 2022-11-01 02:02:40 +01:00			`[![Docker Automated build](https://img.shields.io/docker/automated/tmaier/docker-compose.svg)](https://hub.docker.com/r/tmaier/docker-compose/)`
Add badges to README 2017-01-29 14:15:32 +01:00			`[![Docker Pulls](https://img.shields.io/docker/pulls/tmaier/docker-compose.svg)](https://hub.docker.com/r/tmaier/docker-compose/)`
			`[![GitHub issues](https://img.shields.io/github/issues/tmaier/docker-compose.svg)](https://github.com/tmaier/docker-compose/issues)`
			`[![GitHub stars](https://img.shields.io/github/stars/tmaier/docker-compose.svg?style=social&label=Star)](https://github.com/tmaier/docker-compose)`

Add versions based on different docker versions 2017-01-26 16:56:29 +01:00			This docker image installs docker-compose on top of the `docker` image.
Pin docker-compose versions to the time of release - Otherwise the docker-compose version is the latest available at time of build, which may not be compatible or expected - The latest `COMPOSE_VERSION` can be taken by setting the argument blank (or leaving it as is in the case of `latest`) - pip requires the `.*` to denote that we want the latest patch level, eg. just putting `docker-compose==1.11` installs `1.11.0` instead of `1.11.2` - The extra `${COMPOSE_VERSION:+==}` is because pip errors out with `docker-compose==` Fixes #4 2018-04-18 16:44:10 +02:00			`This is very useful for CI pipelines, which leverage "Docker in Docker".`
Add versions based on different docker versions 2017-01-26 16:56:29 +01:00
Add deprecation notice https://github.com/docker-library/docker/pull/361 made this repository obsolete :) 2022-11-01 03:10:44 +01:00			`## This Docker image is DEPRECATED`

Fix gramma 2022-11-01 03:15:36 +01:00			This image is deprecated, since the [`docker` image](https://hub.docker.com/_/docker) has now Docker Compose included.
Add deprecation notice https://github.com/docker-library/docker/pull/361 made this repository obsolete :) 2022-11-01 03:10:44 +01:00			`This has been introduced by [docker-library/docker#361](https://github.com/docker-library/docker/pull/361).`

Update README - update versions - add hint to open Github issues or pull requests 2017-09-07 13:22:26 +02:00			`## Docker versions supported`

Change approach for tagging the docker image Past: docker version Now: docker compose version Reasoning: We need to do larger changes to the Dockerfile to support Docker Compose v2 2022-11-01 02:29:23 +01:00			`The Docker Compose versions supported here use the most recent docker version compatible with it.`
Pin docker-compose versions to the time of release - Otherwise the docker-compose version is the latest available at time of build, which may not be compatible or expected - The latest `COMPOSE_VERSION` can be taken by setting the argument blank (or leaving it as is in the case of `latest`) - pip requires the `.*` to denote that we want the latest patch level, eg. just putting `docker-compose==1.11` installs `1.11.0` instead of `1.11.2` - The extra `${COMPOSE_VERSION:+==}` is because pip errors out with `docker-compose==` Fixes #4 2018-04-18 16:44:10 +02:00
Add note in README Document DOCKER_AND_COMPOSE_VERSION_MATRIX 2018-04-29 17:25:01 +02:00			All available Docker Engine versions and the respective Docker Compose versions are defined in [`DOCKER_AND_COMPOSE_VERSION_MATRIX`](./DOCKER_AND_COMPOSE_VERSION_MATRIX).

Update README - update versions - add hint to open Github issues or pull requests 2017-09-07 13:22:26 +02:00			`Please open an issue or a pull request (preferred) [at GitHub](https://github.com/tmaier/docker-compose), if a version is missing.`
Add badges to README 2017-01-29 14:15:32 +01:00
Reorder README 2022-11-01 02:56:30 +01:00			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.`

Add simple usage instructions for GitLab CI 2017-10-04 09:48:32 +02:00			`## Usage instructions for GitLab CI`

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

			```yaml
			`image: tmaier/docker-compose:latest`

			`services:`
			`- docker:dind`

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

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

Add a small instruction on how to add a new docker version 2018-07-28 08:54:46 +02:00			`## 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).

Fix README 2021-04-08 07:56:54 +02:00			`DOCKER_AND_COMPOSE_VERSION_MATRIX` specifies in the first column the docker version.
Add a small instruction on how to add a new docker version 2018-07-28 08:54:46 +02:00			`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:`

Update README.md 2022-11-01 01:12:00 +01:00			`- https://github.com/docker/docker-ce/releases or https://hub.docker.com/_/docker`
Fix README 2021-04-08 07:56:54 +02:00			`- https://github.com/docker/compose/releases`
Add common issues to README 2020-04-12 12:46:41 +02:00
			`## Common issues and possible fixes`

Update README.md 2020-04-12 12:46:57 +02:00			### `ERROR: error during connect: Get http://docker:2375/v1.40/info: dial tcp: ...`
Add common issues to README 2020-04-12 12:46:41 +02:00
			`> 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>`

Add badges to README 2017-01-29 14:15:32 +01:00			`## Author`

			`[Tobias L. Maier](http://tobiasmaier.info) for [BauCloud GmbH](https://www.baucloud.com)`