ecs_composex 0.21.1

Manage, Configure and Deploy your services and AWS services and applications from your docker-compose definition

The no-code CDK for docker-compose & AWS ECS

Deploy your services to AWS ECS from your docker-compose files in 3 steps

• Step 1. Install ECS Compose-x

• Step 2. Use your existing docker-compose files. Optionally, add Compose-X extensions.

• Step 3. Deploy to AWS via CloudFormation.

What does it do?

• Help developers/SRE/Cloud engineers to deploy applications to AWS using docker-compose syntax

  • Generates CloudFormation templates out of the Compose Files

  • Links services and AWS Resources together via IAM / Networking / Configuration

  • Detects mis-configurations and autocorrects wherever possible

• Use/Re-use existing docker-compose files and compose specifications

  • Supports docker-compose specification 3.7+

  • Performs JSON validation of input to improve reliability

  • Enable/disable features to run in AWS Fargate automatically

• Expand the definitions with AWS CloudFormation resources

  • For supported resources, supports full CloudFormation properties

  • For existing resources, will detect them and allow to use the Return Values with other components

• Allows to use existing resources in your AWS Account

• Can be extended with custom modules/hooks

Useful Links

• Documentation

• Labs

• Feature requests

• Issues

• Compatibility Matrix

Installation

# Inside a python virtual environment
python3 -m venv venv
source venv/bin/activate
pip install pip -U
pip install ecs-composex

# For your user only
pip install ecs-composex --user

Usage

# Get all the options
ecs-compose-x -h

# Simple example using docker-compose file and an extension with your AWS Settings
ecs-compose-x render -d templates -n my-new-stack -f docker-compose.yaml -f aws-settings.yaml