[AWSマイスターシリーズ] AWS SDK for PHP / Ruby / boto(Python) / JavaScript in Node.js

re:G
ene
rate

AWS マイスターシリーズ
AWS SDK for PHP &
AWS SDK for Ruby &
boto(Python) &
JavaScript in Node.js

2013.12.20
アマゾンデータサービスジャパン株式会社
ソリューションアーキテクト
今井　榎並　蒋
© 2012 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.

ウェビナー(Webセミナー)へようこそ！
!   参加者は、⾃自動的にミュートになっています
!   質問を投げることができます！
§  GoToWebinarの仕組みを使って、書き込んでください
§  ただし環境によっては、⽇日本語の直接⼊入⼒力力ができないので、
お⼿手数ですが、テキストエディタ等に打ち込んでから、
コピペしてください

§  最後のＱ＆Ａの時間で、できるだけ回答させて頂きます
§  書き込んだ質問は、主催者にしか⾒見見えません

!   Twitterのハッシュタグは#jawsugでどうぞ

2

Webセミナー
週刊AWSマイスターシリーズ　re:Generate!
!   AWSマイスターシリーズ

§  12⽉月4⽇日 AWS re:Invent アップデート振り返り
§  12⽉月11⽇日 AWS SDK for Java/.Net
§  申し込みサイト
§  http://aws.amazon.com/jp/event_̲schedule/
§  過去資料料集
§  http://aws.amazon.com/jp/aws-‐‑‒meister/

3


Agenda
!   AWS SDK 概要
!   AWS SDK for PHP
! boto(Python)
!   AWS SDK for Ruby
!   AWS SDK for JavaScript in Node.js
!   まとめ

4


AWS SDK概要

AWS SDKの重要性
!   AWSはプログラマブルなインフラ

•  プログラムから扱うためにはSDKが必要
•  ほぼすべてのサービスはマネジメントコンソールから利利⽤用でき
るが、⾃自動化しようと思ったらプログラムから扱うのが必須
•  ⾃自動化するとAWSは何倍も便便利利になる

!   代表的な⽤用途

•  インフラ構築/運⽤用の⾃自動化

•  EC2やRDSを上げたり下げたり、CloudFormationでスタックをデ
プロイしたり

•  アプリケーション的なサービスの利利⽤用

•  S3にデータをアップしたり、DynamoDBやSQSにデータ⼊入れたり
出したり


AWS SDK
!   AWSのサービスはHTTP/HTTPSでREST/SOAP形式の
APIをサポート。
例例えば
•  EC2 : Start/Stop/Terminate
•  S3 : GetObject/PutObject
•  DynamoDB : Get/Put

!   SDKはこれらのAPIを抽象化し、各⾔言語からの利利⽤用を⾮非
常に簡単にしてくれる

Your code
AWS SDK
API
7

EC2

S3

その他サービス


AWS SDK
!   下記の⾔言語/環境で提供中

Java

Python

JavaScript
in nodeJS

PHP

JavaScript
in the Browser

.NET

iOS

Ruby

Android


AWS SDK
!   今回は下記についてお話します。

Java

Python

JavaScript
in Node.js

PHP

JavaScript
in the Browser

.NET

iOS

Ruby

Android


AWS SDKの使い⽅方
!   必要な⾔言語のSDKをインストール

•  ⾔言語ごとにインストール⽅方法が異異なります。このあとの章で⾔言語ご
とに解説します。

!   Credential(AWS APIの認証情報)を⽤用意する
!   ファクトリーメソッドを利利⽤用してサービス(例例えばS3)のクラ
イアントオブジェクトを⽣生成
•  このときにCredentialを渡す

!   クライアントオブジェクトのメソッドを使ってオペレーショ
ン(例例えばPutObject)
!   ⾔言語によってはより⾼高度度に抽象化されているSDKもあります。

Credentialの取り扱い
!   Credentialの取り扱いについてはいくつかのやり⽅方があ
りますが、IAM Roleもしくは環境変数を使うのがオス
スメです。PHPを例例にそれぞれの実装⽅方法をご案内しま
す。
!   コード内に直接埋め込むパターン(コード内に
Credentialが⼊入り込んでしまうのでやっちゃダメなパ
ターン)
<?php
$s3client = S3Client::factory(array(
'key'
=>
'your-‐‑‒aws-‐‑‒access-‐‑‒key-‐‑‒id',
'secretʻ‘ =>
'your-‐‑‒aws-‐‑‒secret-‐‑‒access-‐‑‒key',
)); 　　



! configファイルでCredentialを設定するパターン

•  PHPとbotoではこの⽅方法が提供されている
•  これもCredentialがファイル化されるので良良くないパターン

$ vim aws-‐‑‒config.php
<?php
return array(
'includes' => array('_̲aws'),
'services' => array(
'default_̲settings' => array(
'params' => array(
'key' => 'your-‐‑‒access-‐‑‒key-‐‑‒id',
'secret' => 'your-‐‑‒secret-‐‑‒access-‐‑‒key',)
)
)
);
$ vim sample.php
<?php
$aws = Aws::factory(ʻ‘aws-‐‑‒config.php');
$s3client = $aws-‐‑‒>get('s3');

!   環境変数でCredentialを設定するパターン

•  AWS_̲ACCESS_̲KEY_̲ID, AWS_̲SECRET_̲KEYという環境変数
を実⾏行行ユーザーで設定しておくことによってコードから
Credentialを追い出せる

$ export AWS_̲ACCESS_̲KEY_̲ID="your-‐‑‒aws-‐‑‒access-‐‑‒key-‐‑‒id"
$ export AWS_̲SECRET_̲KEY="your-‐‑‒aws-‐‑‒secret-‐‑‒access-‐‑‒key”
$vim sample.php
<?php
$s3client = S3Client::factory(); 　　


!   IAM RoleでCredentialを設定するパターン

•  コードが動くのがEC2上であれば、IAM Roleを使うことによっ
て、EC2⾃自体にAWS APIへのアクセス権限を付与できる。よっ
てコードや環境変数にCredentialを持たせずに済む。
例例えばS3フルアクセスの権限を持った
IAM Roleを作成して・・・

EC2にそのRoleを
割り当てると・・・

!   IAM RoleでCredentialを設定するパターン

•  前のページのようにS3アクセス権限を持ったRoleをEC2に割り
当てると、下記を書くだけで利利⽤用可能。
$vim sample.php
<?php
$s3client = S3Client::factory(); 　　

•  これは、SDKが内部でSTS(Security Token Service)を利利⽤用し
ており、AccessKey,SecretAccessKey,Tokenを⾃自動的に


AWS SDK for PHP

AWS SDK for PHP
!
!
!
!
!
!

  Amazon提供のAWS開発⽤用のPHP向けSDK
  現在は、Version2
http://aws.amazon.com/jp/sdkforphp/
  環境：PHP5.3.3以降降
  Guzzle HTTP Client framework上で構築されている
  依存Extension
•  cURL


操作可能サービス
Direct Connect

Elasticache

IAM

EC2

SimpleDB

OpsWorks

ELB

S3

Elastic Transcoder

Auto Scaling

Glacier

SQS

EMR

CloudFront

SNS

Route53

Storage Gateway

SES

VPC

Import/Export

SWF

DynamoDB

Elastic Beanstalk

CloudSearch

RDS

Cloud Formation

Redshift

Cloud Watch


利利⽤用⽅方法
!   Composerによるインストール（推奨）

•  http://docs.aws.amazon.com/aws-‐‑‒sdk-‐‑‒php/guide/latest/
installation.html#installing-‐‑‒via-‐‑‒composer

!   Pharよるインストール

installation.html#installing-‐‑‒via-‐‑‒phar

!   Zipファイルからインストール

installation.html#installing-‐‑‒via-‐‑‒zip

!   PEARによるインストール

installation.html#installing-‐‑‒via-‐‑‒pear


初期設定
!   インストール⽅方法により以下のとおり異異なります
インストール方法

インクルード

Composer

require '/path/to/vendor/autoload.php';

Phar

require '/path/to/aws.phar';

Zip

require '/path/to/aws-autoloader.php';

PEAR

'AWSSDKforPHP/aws.phar';

!   コンフィグレーションファイルの設定

•  クレデンシャル情報などを設定可能
•  factory()の引数として指定することも可能
•  ʻ‘src/Aws/Common/Resources/aws-‐‑‒conﬁg.phpʼ’ を参考に追加


サンプル：S3 -‐‑‒ putObject

API仕様: http://docs.aws.amazon.com/aws-‐‑‒sdk-‐‑‒php/latest/class-‐‑‒
Aws.S3.S3Client.html#_̲putObject

<?php
use AwsCommonAws;
use AwsS3ExceptionS3Exception;
try {
$client = S3Client::factory; ①
$bucket = ʼ’your_̲bucket';
$file = 'test.txt';
$result = $client-‐‑‒>putObject(array(
'Bucket' => $bucket,
'Key' => $file,
'Body' => fopen($file, 'r'),
));
// 結果表⽰示
var_̲dump($result);
} catch (S3Exception $e) {
echo '*** Error ***' . "n";
echo $e-‐‑‒>getMessage();
}

① S3クライアント作成
② putObject実⾏行行

②

　Bucketを指定、Keyは、ファ
イル名、Bodyにアップロードす
るファイルストリームを指定

(*) 事前にBucketが作成されて
いる必要があります。


サンプル：S3 -‐‑‒ getObject

Aws.S3.S3Client.html#_̲getObject

<?php
use AwsCommonAws;
use AwsS3ExceptionS3Exception;
try {
$client = S3Client::factory; ①
$bucket = ʼ’your_̲bucket';
$ﬁle = 'test.txt';
$result = $client-‐‑‒>getObject(array(
'Bucket' => $bucket,
'Key' => $ﬁle,
));
// 結果表⽰示
echo $result['Body']; ③
} catch (S3Exception $e) {
echo '*** Error ***' . "n";
}

② getObject実⾏行行

②

　Bucketを指定、Keyは、ファイル
名
③ 取得したコンテンツを表⽰示



サンプル：SQS -‐‑‒ sendMessage

Aws.Sqs.SqsClient.html#_̲sendMessage

<?php
use AwsCommonAws;
use AwsSqsExceptionSqsException;
try {
$client = SqsClient::factory;
①
$queueUrl = 'https://YourQueue';
$result = $client-‐‑‒>sendMessage(array( ②
'QueueUrl' => $queueUrl,
'MessageBody' => 'Send Message!',
));
// 結果表⽰示
} catch (SqsException $e) {
echo '*** Error ***' . "n";
}

① SQSクライアント作成
② sendMessage実⾏行行
　QueueURLを指定、送りたい
メッセージを指定

(*) 事前にQueueが作成されて


サンプル：SQS -‐‑‒ receiveMessage

Aws.Sqs.SqsClient.html#_̲receiveMessage

<?php
use AwsCommonAws;
use AwsSqsExceptionSqsException;

① コンフィグを指定してインスタン
ス作成

② SQSクライアント作成
try {
$client = SqsClient::factory; ①
③ receiveMessage実⾏行行
$queueUrl = 'https://YourQueue';
$result = $client-‐‑‒>receiveMessage(array( ②
　QueueURLを指定
'QueueUrl' => $queueUrl,
));
// 結果表⽰示
} catch (SqsException $e) {
echo '*** Error ***' . "n";
}


サンプル：DynamoDB -‐‑‒ putItem

Aws.DynamoDb.DynamoDbClient.html#_̲putItem
<?php
use AwsCommonAws;
use AwsDynamoDbExceptionDynamoDbException;
try {
$client = DynamoDbClient::factory; ①
$result = $client-‐‑‒>putItem(array(
'TableName' => ʼ’table_̲name',
'Item' => $client-‐‑‒>formatAttributes(array(
ʼ’id' => 100,
'timestamp' => 130699342,
'message' => 'Good Morning.',
)),
));
// 結果表⽰示
} catch (DynamoDbException $e) {
echo '*** Error ***' . "n";
}

① DynamoDBクライアント作
成

②

② putItem実⾏行行
-‐‑‒  TableName: テーブル名
-‐‑‒  Item: Putするアイテムを
指定
（例例）
id : Hash Key
timestamp : Range Key
message : Attribute

(*) 事前にTableが作成されて


サンプル：DynamoDB -‐‑‒ getItem

API仕様: http://docs.aws.amazon.com/aws-‐‑‒sdk-‐‑‒php/latest/class-‐‑‒Aws.DynamoDb.DynamoDbClient.html#_̲getItem

<?php
use AwsCommonAws;
try {
$client = DynamoDbClient::factory; ①
$result = $client-‐‑‒>getItem(array( ②
'ConsistentRead' => true,
'TableName' => 'table_̲name',
'Key' => array(
ʼ’id' => array('N' => '100'),
'timestamp' => array('N' => '130699342')
)
));
// 結果表⽰示
echo '*** Error ***' . "n";
}

成
② getItem実⾏行行
-‐‑‒  TableName: テーブル名
-‐‑‒  Key:GetするアイテムのKey
を指定
（例例）
id : Hash Key

(*) 事前にTableが作成されてい
る必要があります。


活⽤用法
!   PHPアプリのバックエンドストレージ呼び出し
•  DynamoDB,SQS,S3を簡単に呼び出し可能

!   PHPベースのアプリケーションの拡張

•  WordpressやEC-‐‑‒CubeなどのPHPベースのアプリケーションと
AWSの連携

!   独⾃自の管理理⽤用Webインターフェースの作成

•  定型作業を簡略略化したり、管理理を容易易にするための独⾃自Webイ
ンターフェースの作成


PHP版SDKの便便利利なクラス
! DynamoDBSessionHandler

! DynamoDBを使った、HTTPのセッション共有が可能

EC2

ELB

EC2

EC2

DynamoDB

速い
消えない
管理不要


DynamoDBSessionHandlerの利利⽤用
<?php
require '/home/ec2-‐‑‒user/vendor/autoload.php';
use AwsCommonAws;
use AwsDynamoDbDynamoDbClient;
use AwsDynamoDbSessionSessionHandler;
$aws = Aws::factory(ʼ’aws-‐‑‒conﬁg.php');
$client = $aws-‐‑‒>get('dynamodb');
try {
$sessionHandler = SessionHandler::factory(array(
'dynamodb_̲client' => $client,
'table_̲name' => 'sessions',
));
$sessionHandler-‐‑‒>register();
echo '*** Error ***' . "n";
}
session_̲start();
//セッションにデータ登録
$_̲SESSION['username'] = 'jeremy';
$_̲SESSION['role'] = 'admin';
session_̲commit();


boto(Python)

botoとは
!   Python⽤用のAWS SDKのデファクトスタンダード
!   最新版は2.19.0 (2013年年12⽉月現在)
!   Python 2.6.6, 2.7.3 on Mac OSX and Ubuntu Maverick
で動作確認している。
!   Python 2.5での互換性もなるべく考慮しているが保証外
!   Python 3.x版はDeveloper Preview中


Direct Connect

Elasticache

IAM

EC2

SimpleDB

OpsWorks

ELB

S3

Elastic Transcoder

Auto Scaling

Glacier

SQS

EMR

CloudFront

SNS

Route53

Storage Gateway

SES

VPC

Import/Export

SWF

DynamoDB

Elastic Beanstalk

CloudSearch

RDS

Cloud Formation

Data Pipeline

Redshift

Cloud Watch

CloudTrail

FPS

EBS


botoに関するリソース
!   ソースコードリポジトリ

•  https://github.com/boto/boto

! PyPI

•  http://pypi.python.org/pypi/boto

!   オンラインドキュメント

•  http://docs.pythonboto.org/

!   IRC

•  http://webchat.freenode.net/?channels=boto

© 2012 Amazon.com, Inc. and its aﬃliates. All rights reserved. May not be copied, modiﬁed or distributed in whole or in part without the express consent of
Amazon.com, Inc.

インストール

$ pip install boto

Amazon.com, Inc.

初期設定
!   設定ファイルの作成
!   /etc/boto.cfg -‐‑‒ グローバルな設定を記述
!   ~∼/.boto ユーザー毎の設定を記述
[Boto]
debug = 0
num_̲retries = 10

[DynamoDB]
region = ap-‐‑‒northeast-‐‑‒1

Amazon.com, Inc.

サンプル：S3 – set_̲contents_̲from_̲string
>>> from boto.s3.connection import S3Connection
>>> conn = S3Connection()
>>> bucket_̲name = ”yourBucket"
>>> bucket = conn.get_̲bucket(bucket_̲name)
>>> from boto.s3.key import Key
>>> k = Key(bucket)
>>> k.key = "test.txt"
>>> k.set_̲contents_̲from_̲string("Hello World!")



サンプル：S3 – get_̲contents_̲as_̲string
>>> from boto.s3.connection import S3Connection
>>> conn = S3Connection()
>>> bucket_̲name = "yourBucket"
>>> bucket = conn.get_̲bucket(bucket_̲name)
>>> from boto.s3.key import Key
>>> k = Key(bucket)
>>> k.key = "test.txt"
>>> k.get_̲contents_̲as_̲string()



サンプル：SQS – write
>>> import boto.sqs
>>> conn = boto.sqs.connect_̲to_̲region("ap-‐‑‒northeast-‐‑‒1")
>>> q = conn.get_̲queue('YourQueue')
>>> from boto.sqs.message import Message
>>> m = Message()
>>> m.set_̲body('Hello World!!')
>>> q.write(m)



サンプル：SQS – get_̲messages
>>> import boto.sqs
>>> conn = boto.sqs.connect_̲to_̲region("ap-‐‑‒northeast-‐‑‒1")
>>> q = conn.get_̲queue('YourQueue')
>>> rs = q.get_̲messages()
>>> m = rs[0]
>>> m.get_̲body()
'Hello World!!'



サンプル：DynamoDB – putItem
>>> from boto.dynamodb2.items import Item
>>> from boto.dynamodb2.table import Table
>>> table = Table('table_̲name')
>>> item = Item(table , data={
... ʼ’id': 100,
... 'timestamp': 130699342,
... 'message' : 'Good Morning.',
... })
>>> item.save()
True



サンプル：DynamoDB – getItem
>>> from boto.dynamodb2.table import Table
>>> table= Table('table_̲name')
>>> item = table.get_̲item(id=100,timestamp=130699342)
>>> print item['message']
Good Morning.



その他Tips
!   AWSコマンドラインインタフェース(CLI)もbotoを⼀一部
利利⽤用している


AWS SDK for Ruby

AWS SDK for Rubyとは
!   Amazon提供のAWS開発⽤用のRuby向けSDK
!   現在のバージョン
•  Version 1 (stable)
•  Version 2 (developer preview)

! http://aws.amazon.com/sdkforruby/
!   環境：Ruby 1.8.7 以降降


Direct Connect

Elasticache

IAM

EC2

SimpleDB

OpsWorks

ELB

S3

Elastic Transcoder

Auto Scaling

Glacier

SQS

EMR

CloudFront

SNS

Route53

Storage Gateway

SES

VPC

Import/Export

SWF

DynamoDB

Elastic Beanstalk

CloudSearch

RDS

Cloud Formation

Data Pipeline

Redshift

Cloud Watch


!   Ruby環境のセットアップ
•  Rbenvを利利⽤用する
•  https://github.com/sstephenson/rbenv
•  RVMを利利⽤用する
•  https://rvm.io/
! aws-‐‑‒sdk gemをインストール
$ gem install aws-‐‑‒sdk


設定の初期化
!   デフォルトのリージョンをセッティング
require 'awsʼ’
AWS.conﬁg({
:region => ʻ‘YOUR_̲DEFAULT_̲REGIONʼ’
})


サンプル：S3 -‐‑‒ write
API仕様: http://docs.aws.amazon.com/AWSRubySDK/latest/AWS/S3/S3Object.html#write-‐‑‒
instance_̲method

#!/usr/bin/env ruby
require 'aws'
AWS.config({
:access_̲key_̲id =>
ENV['AWS_̲ACCESS_̲KEY_̲ID'],
:secret_̲access_̲key =>
ENV['AWS_̲SECRET_̲ACCESS_̲KEY'],
:region => ENV['AWS_̲REGION']
})

① コンフィグを指定

①

② S3クライアント作成し、
bucketやkeyを指定
③ putするfile名を指定し、s3に
put

②

s3 = AWS::S3.new
bucket = s3.buckets['your-‐‑‒bucket']
obj = bucket.objects['key']
obj.write(Pathname.new('/path/to/file.txt')) ③



サンプル：S3 -‐‑‒ read
API仕様: http://docs.aws.amazon.com/AWSRubySDK/latest/AWS/S3/S3Object.html#read-‐‑‒
instance_̲method

#!/usr/bin/env ruby
require 'aws'


AWS.conﬁg({
})

①

s3 = AWS::S3.new
bucket = s3.buckets['your-‐‑‒bucket']
obj = bucket.objects['key']

②

obj.read do |chunk|
puts chunk
#=> data of s3://your-‐‑‒bucket/key
end

③

② S3クライアント作成し、
bucketやkeyを指定
③ s3にあるobjectのデータを取
得



サンプル：SQS – send_̲message

API仕様: http://docs.aws.amazon.com/AWSRubySDK/latest/AWS/SQS/
Client.html#send_̲message-‐‑‒instance_̲method

#!/usr/bin/env ruby
require 'aws'
require 'pp'


AWS.conﬁg({
})

①

sqs = AWS::SQS.new

②

queue_̲url = 'https://your_̲queue'
result = sqs.client.send_̲message({
:queue_̲url => queue_̲url,
:message_̲body => 'Send Message!'
})
pp result


③

③ send_̲message実⾏行行
　queue_̲urlを指定、送りたい



サンプル：SQS – receive_̲message

API仕様: http://docs.aws.amazon.com/AWSRubySDK/latest/AWS/SQS/
Client.html#receive_̲message-‐‑‒instance_̲method

#!/usr/bin/env ruby
require 'aws'
require 'pp'


AWS.conﬁg({
})

①

sqs = AWS::SQS.new

②

queue_̲url = 'https://your_̲queue'
result = sqs.client.receive_̲message({
:queue_̲url => queue_̲url
})
pp result


③

③ receive_̲message実⾏行行
　queue_̲urlを指定



サンプル：DynamoDB – put_̲item

API仕様: http://docs.aws.amazon.com/AWSRubySDK/latest/AWS/DynamoDB/Client.html#put_̲item-‐‑‒
instance_̲method
#!/usr/bin/env ruby
require 'aws'
require 'pp'


AWS.conﬁg({
①
:access_̲key_̲id => ENV['AWS_̲ACCESS_̲KEY_̲ID'],
:secret_̲access_̲key => ENV['AWS_̲SECRET_̲ACCESS_̲KEY'],
})
client = AWS::DynamoDB::Client.new
result = client.put_̲item({
:table_̲name => 'table_̲nameʼ’,
:item => {
'id' => {:n => '100'},
'timestamp' => {:n => '130699342'},
'message' => {:s => 'Good Morning'}
}
})
pp result
#=> {"ConsumedCapacityUnits"=>1.0}

②
③

② DynamoDBクライアント作成
③ put_̲item実⾏行行
-‐‑‒  :table_̲name: テーブル名
-‐‑‒  :item: Putするアイテムを指
定
（例例）
id : Hash Key
message : Attribute



サンプル：DynamoDB – get_̲item

API仕様: http://docs.aws.amazon.com/AWSRubySDK/latest/AWS/DynamoDB/Client.html#get_̲item-‐‑‒
instance_̲method
#!/usr/bin/env ruby
require 'aws'
require 'pp'


AWS.conﬁg({
①
:access_̲key_̲id => ENV['AWS_̲ACCESS_̲KEY_̲ID'],
:secret_̲access_̲key => ENV['AWS_̲SECRET_̲ACCESS_̲KEY'],
})
client = AWS::DynamoDB::Client.new
result = client.get_̲item({
:consistent_̲read => true,
:table_̲name => 'table_̲name',
:key => {
:hash_̲key_̲element => {:n => '100'},
:range_̲key_̲element => {:n => '130699342'}
}
})
pp result
#=> {"Item"=>{"id"=>{"N"=>"100"},
"message"=>{"S"=>"Good Morning"},
"timestamp"=>{"N"=>"130699342"}},
"ConsumedCapacityUnits"=>1.0}

②
③

② DynamoDBクライアント
作成
③ get_̲item実⾏行行
-‐‑‒  :table_̲name テーブル名
-‐‑‒  :consistent_̲read ⼀一貫性
-‐‑‒  :key GutするKeyを指定
（例例）
id : Hash Key

(*) 事前にTableが作成され
ている必要があります。


その他Tips
!   新しいRuby SDK (version 2)
• 
• 
• 
• 

Developer Preview
バリデーション、ドキュメント、拡張性など改善
プラグイン⽅方式をとっている
Ruby 1.9以降降が必須

!   以下のように利利⽤用可能
$ gem install aws-‐‑‒sdk-‐‑‒core

AWS::DynamoDB.new(api_̲version: ʻ‘2012-‐‑‒08-‐‑‒10ʼ’)
Re:Inventで発表された新Ruby SDKのスライドはおすすめ


その他Tips
!   RailsのセッションをDynamoDBに保存

•  スケーラブルかつ耐障害に優れたセッションストア
•  Rails 3.x か 4.x から利利⽤用可能
•  Rackベースのアプリも利利⽤用可能

!   以下の⼿手順で利利⽤用可能
gem ʻ‘aws-‐‑‒sessionstore-‐‑‒dynamodbʼ’
$ bundle install
参考：https://github.com/aws/aws-‐‑‒sessionstore-‐‑‒dynamodb-‐‑‒ruby


AWS SDK for JavaScript
in Node.js

AWS SDK for JavaScript in Node.jsとは
!   Amazon提供のAWS開発⽤用のnode.js環境で動くJavaScript
向けSDK
•  http://aws.amazon.com/sdkfornodejs/


! Node.js環境のセットアップ
•  OSのパッケージマネージャーでnpmをインストール
•  Mac の場合：
$ brew install npm

! aws-‐‑‒sdk packageをインストール
$ npm install aws-‐‑‒sdk


サンプル：S3 -‐‑‒ putObject
var AWS = require('aws-‐‑‒sdk');
var fs = require('fs');
var s3 = new AWS.S3();

①

var bodyStream = fs.createReadStream( '/path/ ②
to/ﬁle.txt' );
var params = {
Bucket: 'your-‐‑‒bucket',
Key: 'key',
Body: bodyStream
};
s3.putObject(params, function(err, data) {
if (err)
console.log(err);
else
console.log("Successfully uploaded.");
});


② put時の引数
•  Bucket: s3 bucket
•  Key: s3 key
•  Body: 実際のデータ

③ ③ S3へPUT



サンプル：S3 -‐‑‒ getObject
var s3 = new AWS.S3();

①

var params = {
Bucket: ʼ’your-‐‑‒bucket',
Key: ʼ’key'
};

②

s3.getObject(params, function(err, data) {
if (err)
console.log(err);
else
console.log(data.Body.toString());
});

③


② gut時の引数
•  Bucket: s3 bucket
•  Key: s3 key
③ S3からデータ取得



サンプル：SQS -‐‑‒ sendMessage
var s3 = new AWS.SQS();

①

var params = {
②
QueueUrl: 'https://your_̲queue',
MessageBody: 'Send Message!'
}
sqs.sendMessage(params, function(err, data) {
if (err)
console.log(err);
else
console.log("Successfully sent.");
})


② queue_̲urlを指定、送りたい
③ sendMessage実⾏行行



サンプル：SQS -‐‑‒ receiveMessage
var s3 = new AWS.SQS();

①


var params = {
② ② queue_̲urlを指定
QueueUrl: 'https://your_̲queueʼ’
}
sqs.receiveMessage(params, function(err, data) ③ receiveMessage実⾏行行
{
③
　
if (err)
console.log(err);
else
console.log(data);
})


サンプル：DynamoDB – putItem
var ddb = new AWS.DynamoDB();

①

var params = {
TableName: 'my_̲table',
Item: {
'id': {N: ʻ‘100'},
'timestamp': {N: '130699342'},
'message': {S: 'Good Morning'}
}
};

②

ddb.putItem(params, function(err, data) {
if (err)
console.log(err);
else
console.log(data);
});

③

① DynamoDBクライアント
作成
② パラメータ指定
-‐‑‒  :TableName: テーブル名
-‐‑‒  :Item: Putするアイテムを指
定
（例例）
id : Hash Key
message : Attribute
③ Put実⾏行行

(*) 事前にTableが作成され
ている必要があります。


サンプル：DynamoDB – getItem
var ddb = new AWS.DynamoDB();

①

var params = {
TableName: 'my_̲table',
Key: {
'id': {N: ʻ‘100'},
'timestamp': {N: '130699342'}
}
};

②

ddb.getItem(params, function(err, data) {
if (err)
console.log(err);
else
console.log(data);
});

③

成
② パラメータ指定
-‐‑‒  :TableName: テーブル名
-‐‑‒  :Item: Putするアイテムを
指定
（例例）
id : Hash Key
message : Attribute
③ Get実⾏行行



まとめ

今回のまとめ
!   AWSはプログラマブルなインフラ

•  ほぼすべてのサービスはマネジメントコンソールから利利⽤用でき
るが、⾃自動化しようと思ったらプログラムから扱うのが必須
•  ⾃自動化するとAWSは何倍も便便利利になる

!   AWSのサービスはHTTP/HTTPSでREST/SOAP形式の
APIをサポート。
例例えば
•  EC2 : Start/Stop/Terminate
•  S3 : GetObject/PutObject
•  DynamoDB : Get/Put

!   SDKはこれらのAPIを抽象化し、各⾔言語からの利利⽤用を⾮非
常に簡単にしてくれる

Q&A

68

[AWSマイスターシリーズ] AWS SDK for PHP / Ruby / boto(Python) / JavaScript in Node.js

More Related Content

What's hot (20)

Similar to [AWSマイスターシリーズ] AWS SDK for PHP / Ruby / boto(Python) / JavaScript in Node.js (20)

More from Amazon Web Services Japan (20)

[AWSマイスターシリーズ] AWS SDK for PHP / Ruby / boto(Python) / JavaScript in Node.js