Example

This example presents one approach to building serverless event driven architecture. The example demonstrates how to send notifications using Amazon API Gateway and Amazon SNS. A complete solution would most likely include additional AWS services, in this case, the example focuses on how to trigger an email notification using Amazon SNS and Amazon API Gateway. You will need an email account that you have access to.

Setup

You will need to download and install Node.js before you can start using the AWS Cloud Development Kit.

This example is developed using the AWS CDK and Typescript, so you will need to install both Typescript and the CDK using the following commands

npm install -g typescript
npm install -g aws-cdk@latest

Since this CDK project uses 'Assests', you might need to run the following command to provision resources the AWS CDK will need to perform the deployment.

cdk bootstrap

The testing scripts can be executed using Jupyter Notebook. There are a few methods for installing Jupyter Notebooks. These instructions will help you get to started with JupyterLab installation.

You can also install Jupyter Notebooks as part of Anaconda installation.

To download this example, you will need to install Git. After installing git follow these instructions to learn how to clone the repository.

After the repository has been cloned set the command prompt path to the cloned directory and run the following command to install the project dependencies.

npm install

cdk synth executes the application which translates the Typescript code into an AWS CloudFormation template.

cdk synth

After the synth command has generated the template use the cdk deploy command to deploy the template to AWS CloudFormation and build the stack. You will be prompted to confirm the deployment with y/n.

cdk deploy

Test the Stack

We need to install Jest since we are using the Jest framework to test the stack. Testing the stack is optional.

npm install --save-dev jest @types/jest @aws-cdk/assert

Run the Example

Open the Jupyter Notebook in the jupyter_notebook directory follow the instructions.

Cleanup

From the command prompt execute the following command: cdk destroy

Deploy Resources

Identifier	Service	Type
ApigwSnsStack-GatewayExecutionRole...	IAM	Role
restapis/y97h9od2td	ApiGateway	RestApi
account/ApigwS-SNS...	ApiGateway	Account
ApigwSnsStack-SNSApiCloudWatchRole...	IAM	Role
demo_apigw_sns	SNS	Topic