https://github.com/docker-archive/compose-cli

Easily run your Compose application to the cloud with compose-cli
https://github.com/docker-archive/compose-cli

aci amazon-ecs amazon-web-services azure azure-aci cli docker docker-compose docker-desktop docker-engine ecs fargate moby

Last synced: 4 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/docker-archive/compose-cli
• Owner: docker-archive
• License: apache-2.0
• Archived: true
• Created: 2020-04-06T14:31:18.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2023-11-27T11:12:15.000Z (about 1 year ago)
• Last Synced: 2024-09-23T16:02:39.315Z (4 months ago)
• Topics: aci, amazon-ecs, amazon-web-services, azure, azure-aci, cli, docker, docker-compose, docker-desktop, docker-engine, ecs, fargate, moby
• Language: Go
• Homepage:
• Size: 8.57 MB
• Stars: 957
• Watchers: 30
• Forks: 253
• Open Issues: 100
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-repositories - docker-archive/compose-cli - Easily run your Compose application to the cloud with compose-cli (Go)
• jimsghstars - docker-archive/compose-cli - Easily run your Compose application to the cloud with compose-cli (Go)

README

        
## :warning: Retirement Date Pending

Docker Compose's integration for ECS and ACI retired in November 2023. For now, our main priority in this repository are critical security fixes.

ECS users can consider using [compose-ecs](https://github.com/docker/compose-ecs).

# Docker Compose "Cloud Integrations"

[![Actions Status](https://github.com/docker/compose-cli/workflows/Continuous%20integration/badge.svg)](https://github.com/docker/compose-cli/actions)

[![Actions Status](https://github.com/docker/compose-cli/workflows/Windows%20CI/badge.svg)](https://github.com/docker/compose-cli/actions)

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](https://aws.amazon.com/ecs))

- Microsoft Azure Container Instances

([ACI](https://azure.microsoft.com/services/container-instances))

- 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](https://github.com/docker/compose/tree/v2) 

## Getting started

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

* macOS, Windows, or Windows WSL2: The current release of

  [Docker Desktop](https://www.docker.com/products/docker-desktop)

* Linux:

  [Install script](INSTALL.md)

* An [AWS](https://aws.amazon.com) or [Azure](https://azure.microsoft.com)

  account in order to use the Compose Cloud integration

Please create [issues](https://github.com/docker/compose-cli/issues) to leave feedback.

## Examples

* ECS: [Deploying Wordpress to the cloud](https://www.docker.com/blog/deploying-wordpress-to-the-cloud/)

* ACI: [Deploying a Minecraft server to the cloud](https://www.docker.com/blog/deploying-a-minecraft-docker-server-to-the-cloud/)

* ACI: [Setting Up Cloud Deployments Using Docker, Azure and Github Actions](https://www.docker.com/blog/setting-up-cloud-deployments-using-docker-azure-and-github-actions/)

## Development

See the instructions in [BUILDING.md](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](CONTRIBUTING.md)

which includes conventions used in this project.