Metadata-Version: 2.1
Name: ecsjobs
Version: 1.0.0
Summary: A scheduled job wrapper for ECS, focused on email reporting and adding docker exec and local command abilities.
Home-page: https://github.com/jantman/ecsjobs
Author: Jason Antman
Author-email: jason@jasonantman.com
License: UNKNOWN
Keywords: aws ecs cron email docker
Platform: UNKNOWN
Classifier: Development Status :: 6 - Mature
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
License-File: LICENSE
Requires-Dist: boto3 (<2.0.0,>=1.0.0)
Requires-Dist: cronex (==0.1.0)
Requires-Dist: docker (<3.0.0,>=2.0.0)
Requires-Dist: jsonschema (<3.0.0,>=2.0.0)
Requires-Dist: PyYAML (>=3.0)
Requires-Dist: requests (<3.0.0,>=2.0.0)

ecsjobs
=======

.. image:: http://www.repostatus.org/badges/latest/active.svg
   :alt: Project Status: Active – The project has reached a stable, usable state and is being actively developed.
   :target: http://www.repostatus.org/#active

* Documentation: `http://ecsjobs.readthedocs.io/en/latest/ <http://ecsjobs.readthedocs.io/en/latest/>`_
* Builds: `https://app.travis-ci.com/github/jantman/ecsjobs <https://app.travis-ci.com/github/jantman/ecsjobs>`_

A scheduled job wrapper for ECS, focused on email reporting and adding docker exec and local command abilities.

This is a very, very esoteric project with a really niche use case.

I've migrated my very small personal AWS infrastructure to a single t2.micro ECS instance. I'm also trying to migrate some of
my personal stuff from my desktop computer to that instance. I need a way to run scheduled tasks and report on their success
or failure, and maybe some output (I have a cron wrapper script that does this on my desktop). But my AWS spend is about $15/month
and I don't want to go over that just because of a bunch of CloudWatch alarms. Also, sometimes the scheduled things I want
to run are really ``docker exec`` into existing task containers.

This is a Python project (distributed as an ECS-ready Docker image) that aims to handle running scheduled things
and then sending an email report on their success or failure. The main shortcomings this intends to address are
the lack of simple built-in failure monitoring for Scheduled ECS Tasks, the lack of a built-in way to execute a
command in a running (ECS Service) container, and the lack of useful email reports.

The generated email reports look like (this one for ``exampleconfig.yml``):

.. image:: https://raw.githubusercontent.com/jantman/ecsjobs/master/docs/source/report.png
   :alt: screenshot of generated HTML email report


