Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/philipmw/ada-messaging

A program demonstrating AWS SQS for Ada Developers Academy
https://github.com/philipmw/ada-messaging

Last synced: 3 days ago
JSON representation

A program demonstrating AWS SQS for Ada Developers Academy

Host: GitHub
URL: https://github.com/philipmw/ada-messaging
Owner: philipmw
License: mit
Created: 2015-09-12T19:54:53.000Z (about 9 years ago)
Default Branch: master
Last Pushed: 2015-09-16T16:11:30.000Z (about 9 years ago)
Last Synced: 2023-02-27T18:11:25.305Z (over 1 year ago)
Language: Ruby
Size: 134 KB
Stars: 1
Watchers: 2
Forks: 3
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# SQS demo for Ada Developers Academy

This program supports two modes: *speaker* and *listener*.

## Setup

Set AWS environment variables:

```
export AWS_REGION=us-west-2
export AWS_ACCESS_KEY_ID=
export AWS_SECRET_ACCESS_KEY=
```

Install dependencies: `bundle`

## Run as speaker

```
rake speaker
```

## Run as listener

```
rake listener
```

## Cost

The only AWS technology in use here is Simple Queue Service (SQS).
There are two factors to consider: the number of messages, and amount of data
entering and leaving AWS.

Assuming one message every second, 24x7, that's up to 2,678,400 messages per month.
Further, assume each message is 500 bytes.

The first 1M messages per month are free, then 50¢ per 1M. For the quantity
of messages, our cost is about 84¢.

For data transfer, we estimate about 1.34 GB. Data transfer _in_ is free, and
_out_ is 9¢ per gigabyte after the first gigabyte. Thus, that's about 4¢ for
data transfer.

In total, we estimate we'd pay 88¢ per month for our estimated AWS usage.

## Set up your own queue and users

This demo uses an existing queue and users in Philip's AWS account, but here's
how to set up your own. I include two sets of instructions: the simpler case
of just one user that can both write to and read from the queue, and the case of
two users, one for reading and one for writing.

### One user for reading and writing

### A user for writing, a user for reading

1. Log in to the AWS console and go to its SQS section.
2. Create a new SQS queue. Note its ARN.
3. Copy your new queue's ARN into the `QUEUE_ARN` constant of `queue.rb`.
4. Go to the IAM section of AWS console.
5. Create a new policy for _reader_ user; use the Policy Generator.
1. Effect: Allow
2. AWS Service: AWS SQS
3. Actions: `ChangeMessageVisibility`, `ChangeMessageVisibilityBatch`, `DeleteMessage`,
`DeleteMessageBatch`, `ReceiveMessage`.
4. ARN: the ARN of your new queue (from step 2)
6. Create a new policy for _writer_ user; use the Policy Generator.
1. Effect: Allow
2. AWS Service: AWS SQS
3. Actions: `PurgeQueue`, `SendMessage`, `SendMessageBatch`.
4. ARN: the ARN of your new queue (from step 2)
6. Create a new _reader_ and _writer_ users; write down their access and secret keys.
7. To each user of your two new users, attach the correct policy.

Now you can run this program in _speaker_ or _listener_ mode after setting the
environment variables to the correct user's access and secret keys.

## Contributing

[![Build Status](https://travis-ci.org/philipmw/ada-messaging.svg)](https://travis-ci.org/philipmw/ada-messaging)

Please feel free to contribute fixes and enhancements.

Run unit tests with `rake spec`.

## References

* [AWS SDK for Ruby](https://aws.amazon.com/sdk-for-ruby/)
* [AWS SDK for Ruby - SQS client API](http://docs.aws.amazon.com/sdkforruby/api/Aws/SQS.html)
* [AWS SQS Pricing](https://aws.amazon.com/sqs/pricing/)
* [AWS Simple Monthly Calculator](http://calculator.s3.amazonaws.com/index.html)