ecs-tool tries to eliminate common caveats for your day-to-day work with Elastic Container Service (ECS).
Project description
ECS Tool
aws-ecs on steroids.
ecs-tool tries to eliminate common caveats for your day-to-day work with Elastic Container Service (ECS).
Dashboards with important information about your services, more intuitive CLI interface and more.
New version (0.10
) is still in Beta.
Screenshots
Summary of functionalities
Cluster
Service
- Listing of all services
- Dashboard, which includes
CPUUtilization
andMemoryUtilization
plots for service (refreshed automatically)
Task
- Run task, returns information about ran task, e.g. logs output from it (refreshed automatically)
- Show task, displays information about running task (refreshed automatically)
More detailed information about available commands below.
Installation & usage
As python package
pip install ecs-tool
ecs
# with aws-vault
aws-vault exec my-aws-profile -- ecs
With docker
# build image
docker build -t ecs-tool
docker run -it --rm --name ecs-tool ecs-tool ecs
# with aws-vault
docker run -it --rm --env-file <(aws-vault exec my-aws-profile -- env | grep "^AWS_") --name ecs-tool ecs-tool ecs
What ecs-tool
can do?
Cluster
List of available clusters
ecs cluster list
Service
List of available services
ecs service list [OPTIONS]
Options:
--cluster TEXT
Dashboard for service
ecs service dashboard [OPTIONS] SERVICE
Options:
--cluster TEXT
Task
Run task
ecs task run [OPTIONS] TASK_DEFINITION [COMMAND]...
Options:
--cluster TEXT
--network-configuration TEXT
--capacity-provider-strategy TEXT
TASK_DEFINITION
- you can either provide full definition e.g. my-definition:123
or just name, my-definition
. If no number is provided, latest version is assumed.
[COMMAND]
- any command that should be executed on ECS task
Examples:
Running with Fargate
ecs task run epsy-dynks --capacity-provider-strategy '{"capacityProvider": "FARGATE"}' --network-configuration '{"awsvpcConfiguration":{"subnets":["subnet-1234567890"],"securityGroups":["sg-123456789"],"assignPublicIp":"DISABLED"}}' -- my_command subcommand --one-option --another-option="test"
Display information about ran task
ecs task show [OPTIONS] TASK_ID
Options:
--cluster TEXT
Can I use grep?
Yes! All commands results (but dashboards) can be filtered with grep
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for ecs_tool-0.10.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b279a7741448ccabe29186accca1561502d111323bd67b51f174e2c7e04117cc |
|
MD5 | f2d3f7b901c0d8a9126ca76f6477d963 |
|
BLAKE2b-256 | 065585deb69ab997bf437babb57f04a3aec578f9d4c216f55d7af67c80ad3cff |