Spurious::Ruby::Awssdk::Helper
A ruby helper class for configuring the ruby aws-sdk
to
talk to the spurious services.
Installation
Add this line to your application's Gemfile:
gem 'spurious-ruby-awssdk-helper'
And then execute:
$ bundle
Or install it yourself as:
$ gem install spurious-ruby-awssdk-helper
AWS SDK Versions
- The gem supports using both
~v1
and~v2
of theaws-sdk
gem. - The gem uses
~v1
before it'sv1.0.0
release. - The gem uses
~v2
past it'sv1.0.0+
release.
Usage
You can configure the aws-sdk
two different ways:
- Shelling out to the CLI tool for the current port mappings
- Getting current port mappings from linked docker containers
CLI strategy
Generally you have this setup done at the entry point of your application or in a di container:
require 'spurious/ruby/awssdk/helper'
Spurious::Ruby::Awssdk::Helper.configure
Docker strategy
If you're running you application in a container on the same host as spurious then you can pass in the following linked containers:
docker run ... --link spurious-s3:s3.spurious.localhost --link spurious
-sqs:sqs.spurious.localhost --link spurious-dynamo:dynamodb.spurious.localhost
then inside your application:
require 'spurious/ruby/awssdk/helper'
Spurious::Ruby::Awssdk::Helper.configure :docker
Contributing
- Fork it ( https://github.com/spurious-io/ruby-awssdk-helper/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request