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

# Docker Compose

[![Docker Automated buil](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".

## 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`](./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.

## 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
* 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`

Add badges to README 2017-01-29 14:15:32 +01:00			`[![Docker Automated buil](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)`

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

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

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

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

			`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`

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