arrmac / aws-sdk-rails

Official repository for the aws-sdk-rails gem, which integrates the AWS SDK for Ruby V2 with Ruby on Rails.

AWS SDK for Ruby Rails Plugin

A Ruby on Rails plugin that integrates AWS services with your Rails application using the AWS SDK for Ruby Version 2.

Usage

Simply require this in your Rails project's Gemfile, and AWS SDK features will be added to your Rails environment:

gem 'aws-sdk-rails'

This dependency will automatically pull in version 2 of the AWS SDK for Ruby.

You will have to ensure that you provide credentials for the SDK to use. See the AWS SDK for Ruby V2 Docs for details. If you need to provide your own credentials, you can call client-creating actions manually. For example, to provide your own credentials for using Amazon Simple Email Service as a delivery method for ActionMailer:

require 'json'
# Because you're never going to commit credentials to source. Please.
creds = JSON.load(File.read('secrets.json'))
creds = Aws::Credentials.new(creds['AccessKeyId'], creds['SecretAccessKey'])
Aws::Rails.add_action_mailer_delivery_method(:aws_sdk, credentials: creds, region: 'us-east-1')

If you're running your Ruby on Rails application on Amazon Elastic Compute Cloud, keep in mind that the AWS SDK for Ruby will automatically check Amazon EC2 instance metadata for credentials. Learn more: IAM Roles for Amazon EC2

AWS SDK for Ruby Logging Uses the Rails Logger

Automatically, the AWS SDK for Ruby will be configured to use the built-in Rails logger for any SDK log output.

Using Amazon SES as an ActionMailer Delivery Method

The gem will set this up automatically, with an example of doing this manually above. With the delivery method in place, you simply need to configure Rails to use SES as a delivery method in your environment configuration:

# for e.g.: RAILS_ROOT/config/environments/production.rb
config.action_mailer.delivery_method = :aws_sdk

With this in place, the AWS SDK's SES client will be used by ActionMailer.