Diving Into the New AWS SDK for Ruby (TLS305) | AWS re:Invent 2013

© 2013 Amazon.com, Inc. and its affiliates. All rights reserved. May not be copied, modified, or distributed in whole or in part without the express consent of Amazon.com, Inc.

Trevor Rowe & Loren Segal

November 13, 2013

Diving Into the New AWS SDK for Ruby

Friday, November 15, 13

Goals


GoalsIntroduce Core


GoalsIntroduce CoreHands on Experience


GoalsIntroduce CoreHands on ExperienceExtending the SDK


GoalsIntroduce CoreHands on ExperienceExtending the SDKContributing


gem install aws-sdk


2.0Friday, November 15, 13

Why Version 2.0?


Why Version 2.0?

Validation


Why Version 2.0?

ValidationStructured Responses


Why Version 2.0?

ValidationStructured ResponsesBetter Documentation


Why Version 2.0?

ValidationStructured ResponsesBetter DocumentationExtensibility


Why Version 2.0?

ValidationStructured ResponsesBetter DocumentationExtensibilityConsistency


gem install aws-sdk-core


aws-sdk

Version 1


aws-sdk

Version 1 Version 2

aws-sdk-core


aws-sdk

Version 1 Version 2

aws-sdk-core

work-in-progress


CodeFriday, November 15, 13

Key Differences


Key Differences

New Namespace


Key Differences

New NamespaceMemoization Everywhere


Key Differences

New NamespaceMemoization EverywhereRuby 1.9+


Key Differences

New NamespaceMemoization EverywhereRuby 1.9+Flexible Dependencies


Key Differences

New NamespaceMemoization EverywhereRuby 1.9+Flexible DependenciesStructured Responses


What’s Coming?


What’s Coming?

Resources


What’s Coming?

ResourcesEnumeration


What’s Coming?

ResourcesEnumerationPagination


What’s Coming?

ResourcesEnumerationPaginationHelpers


What’s Coming?

ResourcesEnumerationPaginationHelpersService Gems


Developer Preview


Developer PreviewPublic


Developer PreviewPublicFeedback


Developer PreviewPublicFeedbackStability


ExtendingThe SDK


Request Response


Request Response

Validate


Request Response

Validate

Serialize


Request Response

Validate

Serialize

Send


Request Response

Validate

Serialize

Send

Parse


Request Response

Validate

Serialize

Send

Parse

Middleware


Request Response

Validate

Serialize

Send

Parse

Middleware

Application


Writing Plugins* The entire SDK is written as a series of plugins


Writing PluginsIdeas:

* The entire SDK is written as a series of plugins



Data Integrity Checks




Data Integrity ChecksExtended Retry Logic




Data Integrity ChecksExtended Retry LogicDefault Values




Data Integrity ChecksExtended Retry LogicDefault ValuesCross Service Hooks



Plugins, Handlers and Context, Oh My!



Plugin

Configuration

Handlers



Plugin

Configuration

Handlers

Configuration

Options

Defaults



Plugin

Configuration

Handlers

Configuration

Options

Defaults

Handlers

#call method

Build request

Parse response


Plugin• provides a DSL• easy to add/remove

Handler• stacked• similar to rack middleware

Context• operation name• configuration• request parameters• http request• http response• response data• response error



Plugin• provides a DSL• easy to add/remove

Handler• stacked• similar to rack middleware

Context• operation name• configuration• request parameters• http request• http response• response data• response error


Let’s Build Something!


Best Practices• Depend on major versions of the SDK

• gem “aws-‐sdk-‐core”, “~> 2.0”

• API Locking• Lock your clients to a specific API version• Aws::DynamoDB.new(api_version: ‘2012-‐08-‐10’)

• Secure Credential Management• Rotate credentials

• Use IAM roles for EC2 instances when possible• ENV variables (Heroku, etc.)• From a file on disk (outside source control)• Never check your credentials into source control!


Contributing


Open Source


Open Source

GitHub issues


Open Source

GitHub issuesPull Requests


Open Source

GitHub issuesPull RequestsTest Coverage


Open Source

GitHub issuesPull RequestsTest CoverageDocs/Guides


Open Source

GitHub issuesPull RequestsTest CoverageDocs/GuidesSamples


Open Source

GitHub issuesPull RequestsTest CoverageDocs/GuidesSamples3rd Party Gems


Links of Interest


https://github.com/aws/aws-sdk-core-ruby

Links of Interest




http://ruby.awsblog.com/


Links of Interest








https://forums.aws.amazon.com/forum.jspa?forumID=125

Links of Interest











Links of Interest

@awsforruby










https://twitter.com/awsforruby

https://twitter.com/awsforruby

Please give us your feedback on this presentation

As a thank you, we will select prize winners daily for completed surveys!

TLS305 Thank You


Diving Into the New AWS SDK for Ruby (TLS305) | AWS re:Invent 2013

Technology

Transcript of Diving Into the New AWS SDK for Ruby (TLS305) | AWS re:Invent 2013