Pythonic Microservices on AWS Lambda
Project description
.. image:: https://travis-ci.org/robertdfrench/psychic-disco.svg?branch=master
:target: https://travis-ci.org/robertdfrench/psychic-disco
.. image:: https://coveralls.io/repos/github/robertdfrench/psychic-disco/badge.svg?branch=master
:target: https://coveralls.io/github/robertdfrench/psychic-disco?branch=master
Psychic Disco
-----------------------------------
Pythonic microservices for AWS Lambda. Define Lambda functions as python modules, automatically create and upload deployment packages, register API Gateway methods to trigger your lambdas. Do that thing where your configuration lives in your code.
Install like so::
pip install psychic_disco
Assumptions
-----------
* All your microservices live in python modules
* All your entrypoints are decorated with @lambda_entry_point
Declaring Entrypoints and API methods
-------------------------------------
Make a new entrypoint::
@lambda_entry_point
def handler(event, context):
# important code here
Making a new api method automatically registers the entrypoint::
@api_method("POST", "/cereal"):
def create_cereal(event, context):
# cereal creation logic here
Definitions for your API methods are available in ``psychic_disco.Api``.
Discovering Entrypoints
-----------------------
Do this thing::
psychic_disco discover_entrypoints
Or, if your code lives elsewhere::
psychic_disco --repo path/to/st/elsewhere discover_entrypoints
Creating a Deployment Package
-----------------------------
Do this thing::
psychic_disco bundle
That will make a virtualenv, install your dependencies, and zip it all up for you. This assumes that you have ``psychic_disco.config.default_s3_bucket`` defined in your ``psychic_disco_config.py``
Deploying Lambda Functions
--------------------------
Once a deployment package has been uploaded to Amazon S3, you can install the lambda functions you defined like so::
psychic_disco deploy_lambdas
This assumes that you have ``psychic_disco.config.default_iam_role`` defined in your ``psychic_disco_config.py``
Querying AWS
------------
You can see what has already been configured on AWS by running::
psychic_disoc show_installed_routes <api-name>
:target: https://travis-ci.org/robertdfrench/psychic-disco
.. image:: https://coveralls.io/repos/github/robertdfrench/psychic-disco/badge.svg?branch=master
:target: https://coveralls.io/github/robertdfrench/psychic-disco?branch=master
Psychic Disco
-----------------------------------
Pythonic microservices for AWS Lambda. Define Lambda functions as python modules, automatically create and upload deployment packages, register API Gateway methods to trigger your lambdas. Do that thing where your configuration lives in your code.
Install like so::
pip install psychic_disco
Assumptions
-----------
* All your microservices live in python modules
* All your entrypoints are decorated with @lambda_entry_point
Declaring Entrypoints and API methods
-------------------------------------
Make a new entrypoint::
@lambda_entry_point
def handler(event, context):
# important code here
Making a new api method automatically registers the entrypoint::
@api_method("POST", "/cereal"):
def create_cereal(event, context):
# cereal creation logic here
Definitions for your API methods are available in ``psychic_disco.Api``.
Discovering Entrypoints
-----------------------
Do this thing::
psychic_disco discover_entrypoints
Or, if your code lives elsewhere::
psychic_disco --repo path/to/st/elsewhere discover_entrypoints
Creating a Deployment Package
-----------------------------
Do this thing::
psychic_disco bundle
That will make a virtualenv, install your dependencies, and zip it all up for you. This assumes that you have ``psychic_disco.config.default_s3_bucket`` defined in your ``psychic_disco_config.py``
Deploying Lambda Functions
--------------------------
Once a deployment package has been uploaded to Amazon S3, you can install the lambda functions you defined like so::
psychic_disco deploy_lambdas
This assumes that you have ``psychic_disco.config.default_iam_role`` defined in your ``psychic_disco_config.py``
Querying AWS
------------
You can see what has already been configured on AWS by running::
psychic_disoc show_installed_routes <api-name>
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
psychic_disco-0.7.0.tar.gz
(5.9 kB
view hashes)