Features

• Application GUI to manage ECS resources

• Use your home aws credentials from ~/.aws/credentials

• Get information and attributes for each task, service or instance container

• Connect through SSH to container instances or docker container

• Show logs for each docker container

• Show ECS events for a service

• Force restart for a service

Requirements

• Python 3.10

• boto3

• click

• tabulate

• PyQt5

• moto

• uxrvt

Installation

You can install Ecs Tasks Ops via pip from PyPI:

$ pip install ecs-tasks-ops

Configuration

[default]
aws_access_key_id = YOUR_KEY
aws_secret_access_key = YOUR_SECRET

[default]
region=us-east-1

{
   "commands": [
      "/bin/sh",
      "/bin/bash",
      "mongo admin -u root -p $(pass mongo/root)"
   ]
}

GUI Usage

You can open the qt5 application, using the following command

ecs-tasks-ops-qt5

CLI Usage

You can open the command line with ecs-tasks-ops command. This is the help menu:

Usage: ecs-tasks-ops [OPTIONS] COMMAND [ARGS]...

   Ecs Tasks Ops.

Options:
   -x, --debug / --no-debug
   -j, --output-json
   --version                 Show the version and exit.
   --help                    Show this message and exit.

Commands:
   clusters             Clusters information.
   container-instances  Container instances defined in a cluster.
   containers           Get docker containers defined in a cluster.
   services             Services defined in a cluster.
   tasks                Set tasks defined in a cluster.

By default, the output format is in a table, but you can get original json format with -j option. You can filter json output with jq tool:

$ ecs-tasks-ops -j clusters | jq "."

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the MIT license, Ecs Tasks Ops is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @cjolowicz’s Hypermodern Python Cookiecutter template.