Define and run multi-container applications with Docker https://docs.docker.com/compose/
Find a file
Randy Fay 1ba14202d5 Minor readme.md issues (no more docker desktop stable/edge, etc.)
I noted that some statements in the README.md were outdated, minor updates.

You might want to do still more with the confusion about being v1 here but v2 in docker-compose

Signed-off-by: Randy Fay <randy@randyfay.com>
2021-06-29 07:44:42 -06:00
.github pending label auto-removal on new comment 2021-06-24 09:51:58 +02:00
aci prefer canonical compose.yaml file name 2021-06-22 11:23:57 +02:00
api Move compose v2 implementation under pkg/compose with dependencies 2021-06-15 15:52:48 +02:00
cli Look for docker cli next to the current executable 2021-06-22 10:39:04 +02:00
cmd pass --force and --volumes options to backend 2021-06-25 13:46:34 +02:00
docs Fix references to docker-compose command 2021-06-28 16:45:44 +02:00
ecs Move compose v2 implementation under pkg/compose with dependencies 2021-06-15 15:52:48 +02:00
internal split compose-cli "docker" and composeV2 cli-plugin release processes 2021-05-27 12:46:39 +02:00
kube Move compose v2 implementation under pkg/compose with dependencies 2021-06-15 15:52:48 +02:00
local introduce convergence to hold per-service Containers and prevent race conditions 2021-06-25 13:18:00 +02:00
packaging
pkg introduce convergence to hold per-service Containers and prevent race conditions 2021-06-25 13:18:00 +02:00
scripts split compose-cli "docker" and composeV2 cli-plugin release processes 2021-05-27 12:46:39 +02:00
utils Move compose v2 implementation under pkg/compose with dependencies 2021-06-15 15:52:48 +02:00
.dockerignore
.gitattributes
.gitignore
.golangci.yml build: Update golangci-lint 2021-05-19 15:00:53 +00:00
builder.Makefile move compose-plugin commands under /cmd 2021-06-15 15:52:48 +02:00
BUILDING.md
CONTRIBUTING.md
Dockerfile split compose-cli "docker" and composeV2 cli-plugin release processes 2021-05-27 12:46:39 +02:00
go.mod don't create unecessary resources 2021-06-24 10:11:41 +02:00
go.sum test 2021-06-24 10:11:01 +02:00
import-restrictions.yaml
INSTALL.md
LICENSE
MAINTAINERS
Makefile split compose-cli "docker" and composeV2 cli-plugin release processes 2021-05-27 12:46:39 +02:00
NOTICE
README.md Minor readme.md issues (no more docker desktop stable/edge, etc.) 2021-06-29 07:44:42 -06:00

Docker Compose CLI

Actions Status Actions Status

This Compose CLI tool makes it easy to run Docker containers and Docker Compose applications:

  • locally as a command in the docker CLI, using docker compose ... comands.
  • in the cloud using either Amazon Elastic Container Service (ECS) or Microsoft Azure Container Instances (ACI) using the Docker commands you already know.

Note: Compose CLI is released under the 1.x tag, until "Compose v2" gets a new home

Compose v2 (a.k.a "Local Docker Compose")

The docker compose local command is the next major version for docker-compose, and it supports the same commands and flags, in order to be used as a drop-in replacement. Here is a checklist of docker-compose commands and flags that are implemented in docker compose.

This docker compose local command :

  • has a better integration with the rest of the docker ecosystem (being written in go, it's easier to share functionality with the Docker CLI and other Docker libraries)
  • is quicker and uses more parallelism to run multiple tasks in parallel. It also uses buildkit by default
  • includes additional commands, like docker compose ls to list current compose projects

Note: Compose v2 is released under the 2.x tag, until "Compose v2" gets a new home

Compose v2 can be installed manually as a CLI plugin, by downloading latest v2.x release from https://github.com/docker/compose-cli/releases for your architecture and move into ~/.docker/cli-plugins/docker-compose

Getting started

To get started with Compose CLI, all you need is:

Please create issues to leave feedback.

Examples

Development

See the instructions in BUILDING.md for how to build the CLI and run its tests; including the end to end tests for local containers, ACI, and ECS. The guide also includes instructions for releasing the CLI.

Before contributing, please read the contribution guidelines which includes conventions used in this project.