Metadata-Version: 2.1
Name: aeropress
Version: 0.0.30
Summary: Helper for deploying Docker images to AWS ECS.
Home-page: https://github.com/muraty/aeropress
Author: Omer Murat Yildirim
Author-email: omermuratyildirim@gmail.com
License: BSD License
Keywords: aws ecs deploy aeropress docker image container containerization
Platform: UNKNOWN
Requires-Python: >=3.5.2
Requires-Dist: boto3 (>=1.9)


aeropress
=========

``aeropress`` is a CLI program for deploying Docker images to AWS ECS. It receives a folder path that includes
ECS task and service definitions and then does the jobs respectively;

  - Register ECS task definitions
  - Create Cloudwatch metrics for scaling policies
  - Create or update scaling policies for ECS services
  - Create or update alarms on Cloudwatch
  - Create or update ECS services

Installation
------------
``aeropress`` works with Python3.

::

 pip3 install aeropress

Usage
-----

::

  $ aeropress --help
  usage: cli.py [-h] [--logging-level {debug,info,warning,error}] [--version]
                {deploy,clean} ...

  aeropress AWS ECS deployment helper

  positional arguments:
    {deploy,clean}        sub-command help
      deploy              Deploy docker image to ECS.
      clean               Clean commands for stale entitites on AWS.

  optional arguments:
    -h, --help            show this help message and exit
    --logging-level {debug,info,warning,error}
                          Print debug logs
    --version             show program's version number and exit

Example
-------

You must have defined an ECS cluster first. Then, you can define ECS tasks and services in a yaml file and run
``aeropress`` with required arguments.
::

  aeropress deploy --path 'example/foo.yaml' --image-url 'registry.hub.docker.com/library/python' --service-name service-foo

