SSSSLIDE

AWS LambdaとAPI Gatewayでサー
バレスなシステム構築に踏み出してみる
@makinog3
1

アジェンダ
p AWS Lambdaって？
n おきまりのHello Lambda!
n さらに、イベントドリブンアプリケーション
p S3への書き込みイベントで発動
p SNSでメールも送ってみる
p Amazon API Gatewayって？
n API GatewayからLambdaを叩く
2

AWS Lambdaって？
p 「イベント発⽣生時にお客様のコードを実⾏行行し、
コンピューティングリソースを⾃自動的に管理理す
るコンピューティングサービス」
ユーザ
アプリケーション
イベント
発動
3

イベントって？
Amazon Kinesis
Amazon SNS
ストリームが受信した
から送信された通知
メッセージ
Amazon S3
Amazon DynamoDB
バケットのオブジェクト
テーブルの更新
4

ようは

なんかメッセージが飛んできたり
データの更新とかがあったら
プログラムを実行するしくみ
あぁ、電子メールの.forwardとかRDBのトリガーで動くストアドプロシジャみたいなもんね
5

何がうれしいのか＜教科書的に＞
p ⾯面倒なインフラの構築とかしないでも、スケー
ラブル（！？）でイベントドリブンなアプリ
ケーションを作れる
n 数ミリ秒で起動
n 負荷に応じて勝⼿手にスケール
n 処理理できるリクエストの数に制限なし
p S3、DynamoDBの更更新に合わせたカスタム処
理理ができる
n S3にアップロードされたファイルのメタデータを
DynamoDBに登録するとか
p 完全従量量課⾦金金
n 意外とEC2は⾼高いよね
6

世の中、良良いことばかりじゃない
p 状態を保持できない（ステートレス）
n データ（セッションとか）を保持する必要がある場
合は、DynamoDBなどに書く
n AWS Lambdaが λ（ラムダ関数）たるところ
p （今のところ）Node.jsかJava 8のコードのみ
n Node.jsの関数かJavaのクラスのメソッドを発動
p 発動する関数／メソッドのシグネチャは決まってるので、既
存のコードが＊そのまま＊使えるわけではない
n Java 8のラムダとは無関係 :-‐‑‒P
7

AWS Lambdaの実態？
p コンテナとして実装されてるっぽい
n なので、状態を保持できない
p /tmpへの書き込みはできても、永続化はされない
n なので、起動が速い！
p ImageMagickは使える
n S3に画像ファイルがアップロードされたのを契機に
サムネイルを作るとかが想定されている？
p exec()とかできちゃうっぽい
n 必要なライブラリを全て静的リンクして、gcc動かし
ちゃってる⼈人とか
8

まずは
お決まりのHello Lambda
Lambdaの典型的な利利⽤用
パターンの雛形のコー
ドが⽤用意されている
9

LambdaにNode.js関数を設定
後で使う
API Gatewayが
Tokyoリージョンで
は使えないので、
Oregonあたりにし
ときましょう
Execution
呼び出される
Roleの設定
関数名
（後述）
10

LambdaのRole
p Execution Role
n Lambda関数から
AWSのリソースへ
アクセスするための権限
n 例例えば、Lambda関数の
中からSNSにメッセージ
を投げるならSNSへの
書き込み権限が必要
p Invocation Role（イベントにより異異なる）
n イベントソースがLambda関数を実⾏行行するための権限
n Lambda関数がイベントソースを取得するための権限
11

こんな感じ
イベントの情報
(イベントソースによっ
て内容は異異なる)
CloudWatchに
Lambda関数の
記録される
戻り値
12

Hello LambdaのTEST
13

S3にファイルが追加されたらSNS
でメールを送る
SNS
S3
同じリージョン
にします
Lambda
14

S3にバケットを作る
15

SNSでメールを送る
送信許諾の確認
メールが届きます
16

S3で発動するLambda関数を作る
17

console.log('Loading function');
s3.getObject(params, function(err, data) {

if (err) {
var aws = require('aws-sdk');
console.log(err);
var s3 = new aws.S3({ apiVersion: '2006-03-01' }); var message = "Error getting" +
var sns = new aws.SNS({
" object " + key +
accessKeyId: ‘ACCESS_KEY_ID',
" from bucket " + bucket;
secretAccessKey: ’SECRET_ACCESS_KEY',
console.log(message);
region: ’REGION'
context.fail(message);
});
} else {

sns.publish({
exports.handler = function(event, context) {
Message: 'Got object ' +
//console.log('Received event:',
key + ' (' +
//JSON.stringify(event, null, 2));
data.ContentType +

') from bucket ' + bucket,
// Get the object from the event and
Subject: '[ykcloud] Got object',
// show its content type
TopicArn: ’TOPIC_ARN'
var bucket = event.Records[0].s3.bucket.name; }, function(err, data){
var key = event.Records[0].s3.object.key;
if(err) throw err;
var params = {
else context.fail('Unable’ +
Bucket: bucket,
' to send e-mail');
Key: key
});
};
console.log('CONTENT TYPE:’,
data.ContentType);
context.succeed(data.ContentType);
}
});
};
18

今⽇日のお題を思い出す…
p 「AWS LambdaとAPI Gatewayでサーバレ
スなシステム構築に踏み出してみる」
AWS Lambdaでサーバレスな
Webアプリを作りたい
できなくは
ないけど…
LambdaをWebブラウザから
直接呼び出すのはメンドイ
そこでAmazon API Gateway !
19

Amazon API Gatewayって？
p Lambdaを含むAWSの各サービスやインター
ネット上で公開されているサービスに対して、
REST APIを提供することができる
n AWSのコンソールから簡単につくれる
n スケーラブル
n AWSの認証メカニズム（IAM）が利利⽤用できる
n APIをJavaScriptやAndroid、iOSアプリケーショ
ンから使うためのSDKが作れる
20

APIの構成
Stages
Methods
GET
PUT
/prod/hello
POST
DELETE
/prod/hello
:
/prod/hello
Stages
Resources
本番環境とかテスト環境とかに
使い分けることを想定
Stage毎にCloudWatchの設定
や、キャッシュの設定ができる
作成したAPIはStageにデプロ
イすることで公開される
21

HelloLambdaのAPIを作ってみる
22

HelloLambdaのAPIを作ってみる
23

APIのテスト
24

APIの公開
25

ではWebブラウザから叩いてみる
JSON
JSON
S3にHTMLファイルと置いといて、そこからダウンロードするようにすれば、
EC2とか無しで、Webアプリケーションの運用ができる

※ただし、CORSの設定が必要
http://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-cors.html
26

<!DOCTYPE html>
<body>
<html>
<h1>Post to HelloLambda API Gateway</h1>
<head>
<p>URL: <input type="text" id="url_post" name="url"
<meta charset="UTF-8">
size="100" placeholder="Your API Gateway URL"></p>
<title>Hello Lambda</title>
<p>Key1: <input type="text" id="key1" size="30"
<script type="text/javascript" src="http://ajax.googleapis.com/
placeholder="Key1 value"></p>
ajax/libs/jquery/2.1.0/jquery.min.js"></script>

<script type="text/javascript">
$(function(){
<p><button id="button" type="button">post</button></p>
$("#response").html("Response Values");
<textarea id="response" cols=120 rows=10 disabled></
$("#button").click( function(){
textarea>
var url = $("#url_post").val();
</body>
var JSONdata = {
</html>
key1: $("#key1").val(),

key2: $("#key2").val(),
key3: $("#key3").val()
};
$.ajax({
type : 'post',
url : url,
data : JSON.stringify(JSONdata),
contentType: 'application/JSON',
dataType : 'JSON',
scriptCharset: 'utf-8',
success : function(data) {
// alert(JSON.stringify(data));
$("#response").html(JSON.stringify(data));
},
error : function(data) {
alert("error");
// alert(JSON.stringify(data));
$("#response").html(JSON.stringify(data));
}
});
})
})
</script>
</head>
27

まとめ
p AWS Lambdaで簡単なイベントドリブンアプ
リケーションを作るのは、難しくない
n S3、DynamoDBの更更新に合わせたカスタム処理理
n 複数のサービスとLambdaを組み合わせてチェーン
p Amazon API Gatewayとの組み合わせで、
サーバ／ミドルウェアなど⽤用意せずに、
RESTfulなWebアプリケーションを作れる
n 本格的なモノを作るには、テスト⽅方法の確⽴立立とかが
課題か
n ちょっとした裏裏⽅方、運⽤用を助けるツールとして使う
のが良良い感じ
p LambdaのコンソールからAPIを作った時に上⼿手く動かないのはよくわからない…
28

リファレンス
p AWS Lambda公式ドキュメント（英語のみ）
http://docs.aws.amazon.com/lambda/latest/dg/welcome.html
p Amazon API Gateway公式ドキュメント（英語のみ）
http://docs.aws.amazon.com/apigateway/latest/developerguide/
welcome.html
29

SSSSLIDE

AWS LambdaとAPI Gatewayでサーバレスなシステム構築に踏み出してみる

Takashi Makino さんの他のスライド

関連するスライド

このスライドの内容

SSSSLIDE