---
id: ecs-deploy
version: "1.16.3"
license: BSD-3-Clause
license_treatment: permissive
maintenance: active
---

# ecs-deploy — Powerful CLI tool to simplify Amazon ECS deployments, rollbacks & scaling

License: permissive · Maintenance: active · Downloads: 124.9K/mo

## What it is and what it does

ecs-deploy wraps the AWS ECS API into a command-line interface that handles the repetitive and error-prone parts of container deployments on Amazon ECS. It lets you redeploy services with new image tags, scale task counts up or down, update environment variables across containers, run one-off tasks, and manage scheduled tasks—all without writing boto3 code or navigating the AWS console. The tool builds on boto3 and click, so it integrates naturally with AWS credential management and shell scripting.

You point it at a cluster and service name, optionally specify new image tags or environment variables, and it creates a new task definition revision and updates the service in one command. It can also monitor deployments in New Relic if configured. The package is actively maintained, has no known vulnerabilities, and supports modern Python versions (3.10+).

Use it for:

- Deploy a new application version to ECS by updating image tags across all or specific containers in a task definition.
- Scale a service up or down by adjusting the desired task count without manually editing the AWS console.
- Redeploy the current task definition to pull fresh image digests without code changes.
- Update environment variables or docker labels in running services without rewriting task definitions by hand.
- Run one-off administrative or batch tasks from the CLI using an existing task definition as a template.
- Automate scheduled task (cron) updates by modifying both the task definition and the EventBridge rule in a single command.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

ecs-deploy is a CLI tool that simplifies Amazon ECS deployments, scaling, and task management by wrapping complex AWS API operations into straightforward commands.

Yes. ecs-deploy is a solid fit if you deploy to Amazon ECS regularly and want to avoid repetitive AWS API calls or console navigation. It has low install friction, active maintenance, no security vulnerabilities, a permissive license, and a straightforward CLI interface. The main prerequisite is proper AWS IAM configuration, which is documented. Use it if your team already manages AWS credentials and wants faster, scriptable deployments.

## Install

pip install ecs-deploy
uv add ecs-deploy
poetry add ecs-deploy

## Installing ecs-deploy

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release; last commit was 2026-08-10 and the project has 905 GitHub stars, indicating stable ongoing support.

License in practice: Licensed under BSD-3-Clause (permissive), so you can use, modify, and distribute the package freely in both open-source and commercial contexts without significant legal constraints.

Quickstart:

pip install ecs-deploy

ecs deploy my-cluster my-service --tag 1.2.3

Requires AWS credentials configured (via aws configure, environment variables, or CLI flags) and appropriate IAM permissions for ECS actions (ecs:UpdateService, ecs:RegisterTaskDefinition, etc.).

Verify before relying:

- Whether the package works with Python versions older than 3.10 (classifiers list 3.10+, but requires_python is unspecified).
- Whether New Relic monitoring integration requires additional setup or API keys beyond standard ecs-deploy configuration.

## Package facts

- License: BSD-3-Clause (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 124.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ecs deployment automation, amazon ecs cli tool, aws ecs deploy command, container service scaling, ecs task definition updates, docker container orchestration cli, aws infrastructure deployment, aws-deployment, container-orchestration, devops-cli

[View on SkillFed](https://skillfed.io/packages/ecs-deploy) · [View on PyPI](https://pypi.org/project/ecs-deploy/)