Mathieu Champlon
32ae40f350
Merge pull request #2009 from bounlu/main
|
4 years ago | |
|---|---|---|
| .github | 4 years ago | |
| aci | 4 years ago | |
| api | 4 years ago | |
| cli | 4 years ago | |
| cmd | 4 years ago | |
| docs | 4 years ago | |
| ecs | 4 years ago | |
| internal | 4 years ago | |
| kube | 4 years ago | |
| local | 4 years ago | |
| packaging | 5 years ago | |
| pkg | 4 years ago | |
| scripts | 4 years ago | |
| utils | 4 years ago | |
| .dockerignore | 5 years ago | |
| .gitattributes | 5 years ago | |
| .gitignore | 4 years ago | |
| .golangci.yml | 4 years ago | |
| BUILDING.md | 4 years ago | |
| CONTRIBUTING.md | 4 years ago | |
| Dockerfile | 4 years ago | |
| INSTALL.md | 5 years ago | |
| LICENSE | 5 years ago | |
| MAINTAINERS | 4 years ago | |
| Makefile | 4 years ago | |
| NOTICE | 5 years ago | |
| README.md | 4 years ago | |
| builder.Makefile | 4 years ago | |
| go.mod | 4 years ago | |
| go.sum | 4 years ago | |
| import-restrictions.yaml | 4 years ago |
README.md
Docker Compose CLI
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 lsto 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:
- macOS, Windows, or Windows WSL2: The current release of Docker Desktop
- Linux: Install script
- An AWS or Azure account in order to use the Compose Cloud integration
Please create issues to leave feedback.
Examples
- ECS: Deploying Wordpress to the cloud
- ACI: Deploying a Minecraft server to the cloud
- ACI: Setting Up Cloud Deployments Using Docker, Azure and Github Actions
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.