AWS SQS & SNS Node.js Client

What is this?

Node.js web client that excercises the AWS SNS & SQS functionality

Screenshots

Contains:

• app.js = main app & webserver. Launch this
• /controllers = HTTP routes and sns/sqs API functionality
• /config = example aws creds config file and example endpoint override (optional) config file
• /public = stylesheet
• views = main index.ejs
• views/partials = partials for menu navigation, sns and sqs forms

SQS Functionality:

• Create SQS queues
• List SQS queues
• Get queue URL
• Get queue attributes
• Send message to queue
• Get (receive) message from queue
• Delete message from queue
• Purge all messages from queue
• Delete queues
• Set queue attributes (namely policy for SNS subcription)

SNS Functionality:

• Create topics
• Add queue subscription
• Add email subscription
• Send message to topic
• List topics
• Delete topics
• List subscriptions
• Delete subscriptions

Acknowledgements

Based on code from AWS SQS examples at: https://www.youtube.com/watch?v=4Z74luiE2bg\ and https://github.com/andrewpuch/aws-sqs-node-js-examples

Mark Allen’s SNS code here: https://github.com/markcallen/snssqs/blob/master/create.js

CSS template inspired from: https://www.sanwebe.com/2014/08/css-html-forms-designs

Installation overview

install Node.js: https://nodejs.org/en/

clone the repo and install modules:

git clone https://github.com/ajyounguk/aws-sqs-sns-client
cd aws-sqs-sns-client
npm install

AWS Credentials

Copy the configuration details and add your AWS creds.

please take care and don’t commit your creds back to git

cd config
cp aws-config-sample.json aws-config.json

Overrride Amazon SNS/SQS endpoints

If you need to route your request to a proxy, or want to route SQS/SNS requests to a local pseudo AWS service (e.g. goaws or localStack) you can override endopoints by creating a aws-override.json config file:

cd config
cp aws-override-sample.json aws-override.json

and edit the endpoints

For IAM user, add group policy = AmazonSQSFullAccess, AmazonSNSFullAccess

How to run it

run the webserver:

node app.js

point your browser at the local/remoteIP port 3000 to load the HTML forms, click the SNS/SQS buttons to select the required functionality.

For more information on AWS SNS and SQS:

https://aws.amazon.com/sns/
https://aws.amazon.com/sqs/

goaws and localstack links:

https://github.com/p4tin/goaws
https://github.com/localstack/localstack