compose-cli icon indicating copy to clipboard operation
compose-cli copied to clipboard

Easily run your Compose application to the cloud with compose-cli

Docker Compose "Cloud Integrations"

Actions Status Actions Status

This Compose CLI tool makes it easy to run Docker containers and Docker Compose applications in the cloud using either :

  • Amazon Elastic Container Service (ECS)
  • Microsoft Azure Container Instances (ACI)
  • Kubernetes (Work in progress)

...using the Docker commands you already know.

:warning: Compose v2 (a.k.a "Local Docker Compose") has Moved

This repository is about "Cloud Integrations", the Docker Compose v2 code has moved to github.com/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

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.