awsで作るサーバレスapiアプリケーション

JAWSで作るサーバレスAPIアプリケーション

AWS モバイル/IoTサービス徹底攻略!!

- Developers.IO Meetup番外編 -

2015-11-21 クラスメソッド株式会社五十嵐良輔

自己紹介• 五十嵐良輔• クラスメソッド株式会社• モバイルアプリサービス部• 現在の仕事はRailsとAWSが中心

• ブログではRailsとJAWSネタを書いていますhttp://dev.classmethod.jp/author/igarashi-ryosuke/

アジェンダ• JAWSの紹介 *

• AWSMの紹介 *

• サンプルプロジェクトの解説• まとめ* 10/30に弊社で行われた「モバイルバックエンド勉強会 In 秋葉原」で発表したものとほぼ同じ内容です。http://dev.classmethod.jp/server-side/framework/jaws-awsm-users/

JAWSの紹介Just AWS Without Servers

現状の問題• LambdaやAPI Gatewayを使って開発をしようとすると・・・

Lambdaにnpmを使いたいんだけど・・・

Lambdaにnpmを使いたいんだけど・・・ Lambdaのデプロイは関

連するファイルをzipしてs3にアップして・・・

LambdaのCFn書いて・・・

LambdaのCFn書いて・・・ API GatewayはCFnま

だ対応してない・・・

だ対応してない・・・必要なIAMを作ってなかった・・・

だ対応してない・・・必要なIAMを作ってなかった・・・ローカルでテストした

い・・

Lambdaに機微な情報を書きたくない・・

い・・

Lambdaに機微な情報を書きたくない・・

いろいろと大変！！

https://github.com/jaws-framework/JAWS

JAWSが解決します！！

JAWSとは• AWS LambdaとAPI GatewayをベースにAWS上でサーバレスなアプリケーションを作るフレームワーク

• 実態はCLIツール（今のところ）

• Lambdaの雛形を作ったり、必要なリソースのCloudFormationテンプレートなどを自動生成・デプロイしてくれる

• オープンソース• v1.3 ベータ（2015-11-21時点）

アーキテクチャ（最小構成）

API Gateway Lambda

http://dev.classmethod.jp/cloud/aws/getting-started-with-api-gateway-lambda-integration/

JAWSがカバーする範囲

プロジェクト構成• aws_modules機能の単位であり、複数のLambdaとリソースを構成するためのCFnの定義からなる

• cloudformation プロジェクトに必要なリソース全てを構成するためのCFnの定義

• その他環境変数やプロジェクトの構成ファイル

デプロイ構成• 複数ステージ• 複数リージョン• 3つのCloudFormationスタック• Resources• Lambdas• API Gateway

AWSMの紹介AWS Module

AWS Module（AWSM）とは• JAWSプロジェクトにおける機能の単位• リソースもまとめて管理• LambdaとAPI Gateway

• S3やDynamoDBなどその他のAWSサービス

• npmと同じ構成• 再利用可能• 現在はNode.jsのみ（他の言語にも対応予定）

AWSM一覧• awsm-images画像を編集（リサイズなど）するREST APIを生成する

• awsm-usersDynamoDBを使ってユーザを作成・認証する

• awsm-cloudfrontS3の前にCloudFrontを配置して、API Gatewayでエンドポイ

ントを作成する

AWSM一覧• awsm-middleware• awsm-loggly• awsm-twilio• awsm-stripe-webhook• awsm-slack-webhook• awsm-mailer• awsm-s3tokenvendor• joumae-users / joumae-resources• など

サンプルプログラムの解説

作ったもの• GithubへのコメントをSlackに通知する

Webhook API• やりたかったこと• PRへのCommentだけをSlackに通知

• Githubのユーザ名をSlackのユーザ名に変換

作ったもの• GithubへのコメントをSlackに通知する

Webhook API• やりたかったこと• PRへのCommentだけをSlackに通知

• GithubのAPIはIssueとPRの区別がない

• Githubのユーザ名をSlackのユーザ名に変換

作ったもの• イメージ図

Webhook

作ったもの• イメージ図

Webhook

API Gateway

HTTPリクエストJSON JSON

Lambda

JSONをごにょごにょ

プロジェクトの作成

プロジェクトの作成$ jaws project create ____ _____ __ __ _________ | | / _ \/ \ / \/ _____/ | |/ /_\ \ \/\/ /\_____ \ /\__| / | \ / / \ \________\____|__ /\__/\__/ /_________/ v1 (BETA) *** The Server-Less Framework *** JAWS: Enter a project name: (jaws-E1XgDRPWx) demo JAWS: Enter a project domain (You can change this at any time: (myapp.com) JAWS: Enter an email to use for AWS alarms: (you@yourapp.com) JAWS: Enter a stage for this project: (dev) JAWS: Select a region for your project: us-east-1 us-west-2 eu-west-1 > ap-northeast-1 JAWS: Select an AWS profile for your project: > default JAWS: Creating CloudFormation Stack for your new project (~5 mins)...

project createコマンドでプロジェクトを作成開始

プロジェクト名

プロジェクトドメイン

通知用メールアドレス

デフォルトの環境名

デフォルトのリージョン

使用するプロファイル

何分かすると最低限必要のリソース（LambdaとAPI GatewayのIAM）が作成されます。

プロジェクトとAWSMの雛形を作成

プロジェクトの雛形.├── README.md

├── admin.env

├── aws_modules

├── cloudformation

├── jaws.json

├── lib

├── node_modules

├── package.json

└── tests

├── admin.env

├── jaws.json

├── lib

└── tests

使用するプロファイルの設定など

├── admin.env

├── jaws.json

├── lib

└── tests

AWSMのディレクトリ

├── admin.env

├── jaws.json

├── lib

└── tests

CloudFormationテンプレートのディレクトリ

├── admin.env

├── jaws.json

├── lib

└── tests

プロジェクトの環境設定

├── admin.env

├── jaws.json

├── lib

└── tests

プロジェクトが使用するソースコードのディレクトリ

├── admin.env

├── jaws.json

├── lib

└── tests

プロジェクトが使用するnpmのディレクトリ

├── admin.env

├── jaws.json

├── lib

└── tests

プロジェクトの基本設定や依存関係のあるnpmを定義

├── admin.env

├── jaws.json

├── lib

└── tests

テストディレクトリ

AWSMの作成$ jaws module create awsm-github-webhook slack

モジュール名機能名

AWSMの作成$ jaws module create awsm-github-webhook slackaws_modules└── awsm-github-webhook ├── awsm.json └── slack ├── awsm.json ├── event.json ├── handler.js └── index.js

これらが雛形として作られる

API Gatewayと対比すると$ jaws module create awsm-github-webhook slack

aws_modules└── awsm-github-webhook ├── awsm.json └── slack ├── awsm.json ├── event.json ├── handler.js └── index.js

この先にLambda Function

Resource

Action

AWSMの構成aws_modules└── awsm-github-webhook ├── awsm.json └── slack ├── awsm.json ├── event.json ├── handler.js └── index.js

AWSMの環境設定や、AWSM全体に必要なリソース

awsm.json（全体）{ "name": "github-webhook", "version": "0.0.1", "location": "https://github.com/...", "author": "", "description": "", "resources": { "cloudFormation": { "LambdaIamPolicyDocumentStatements": [], "ApiGatewayIamPolicyDocumentStatements": [], "Resources": {} } } }

LambdaのIAMロールポリシー

API GatewayのIAMロールポリシーその他必要なリソース

個別のアクションに必要な設定

awsm.json（個別）{ "lambda": { "envVars": [], "deploy": true, "package": { "optimize": { "builder": "browserify", "minify": true, "ignore": [], "exclude": [ "aws-sdk" ], "includePaths": [] }, "excludePatterns": [] }, "cloudFormation": { "Description": "", "Handler": "aws_modules/github-webhook/slack/handler.handler", "MemorySize": 1024, "Runtime": "nodejs", "Timeout": 6 } },

環境変数

パッケージ設定

Lambdaの設定

awsm.json（個別） "apiGateway": { "deploy": true, "cloudFormation": { "Type": "AWS", "Path": "github-webhook/slack", "Method": "GET", "AuthorizationType": "none", "ApiKeyRequired": false, "RequestTemplates": {}, "RequestParameters": {}, "Responses": { "400": { "statusCode": "400" }, "default": { "statusCode": "200", "responseParameters": {}, "responseModels": {}, "responseTemplates": { "application/json": "" } } } } } }

API Gatewayの設定

ローカルでテストするときのテストデータ

event.json{}

Lambda のエントリーポイント

handler.js'use strict';

/** * AWS Module: Action: Lambda Handler * "Your lambda functions should be a thin wrapper around your own separate * modules, to keep your code testable, reusable and AWS independent" */

require('jaws-core-js/env');

// Modularized Code var action = require('./index.js');

// Lambda Handler module.exports.handler = function(event, context) { action.run(event, context, function(error, result) { return context.done(error, result); }); };

環境変数を読み込んだりする

実際の処理を記述する

Lambdaのエントリーポイント

実際の処理部分

index.js/** * AWS Module: Action: Modularized Code */

// Export For Lambda Handler module.exports.run = function(event, context, cb) { return cb(null, action()); };

// Your Code var action = function() { return {message: 'Your JAWS lambda executed successfully!'}; };

handler.jsから呼ばれる部分

実際の処理実装を書く部分

ここから編集

HTTP Methodを変更する# aws_modules/awsm-github-webhook/slack/awsm.json

"apiGateway": { "cloudFormation": { "Type": "AWS", "Path": "awsm-github-webhook/slack", + "Method": "POST", "AuthorizationType": "none", "ApiKeyRequired": false, "RequestTemplates": {},

MethodをPOSTに変更

npmを追加する$ npm install request --save

# package.json

"dependencies": { "jaws-core-js": "~0.0.2" + "request": "^2.65.0" }

requestを追加

SlackのWebhookへPOSTする# aws_modules/awsm-github-webhook/slack/index.js

+var request = require('request');

module.exports.run = function(event, context, cb) { + // Slackのincoming-webhook URL + // TODO: Varsから取得する + var webhookUrl = 'https://hooks.slack.com/services/XXXXXXXX'; + + // SlackへPOSTするパラメータを作成 + var text = event.comment.body + '<' + event.comment.html_url + '>'; + text = text.replace("@cm-igarashi-ryosuke", "@cm-igarashi"); + var params = { text: text }; + + // Slackのincoming-webhook URLにパラメータをつけてPOSTする + request.post(webhookUrl, { form: { payload: JSON.stringify(params) } }, + function (err, res, body) { + return cb(null, {message: body}); + } + ); };

テスト# aws_modules/awsm-github-webhook/slack/event.json

{ "comment": { "html_url": "https://github.com/xxx/xxx/issues/124#issuecomment-156993922", "body": "@cm-igarashi-ryosuke てすと" } }

$ cd aws_modules/awsm-github-webhook/slack

$ jaws run

JAWS: {"message":"ok"}

テストデータを追加

$ jaws env set dev ap-northeast-1 WEBHOOK_URL \

https://hooks.slack.com/services/XXXXXXXX

環境変数の設定# aws_modules/awsm-github-webhook/slack/awsm.json

{ "lambda": { - "envVars": [], + "envVars": [ + "WEBHOOK_URL" + ],

環境変数名環境変数の値

環境変数の参照# aws_modules/awsm-github-webhook/slack/index.js

module.exports.run = function(event, context, cb) { // Slackのincoming-webhook URL - // TODO: Varsから取得する - var webhookUrl = 'https://hooks.slack.com/services/XXXXXXXX'; + var webhookUrl = process.env.WEBHOOK_URL;

環境変数から値を取得するよう修正

ヘッダー情報を参照する# aws_modules/awsm-github-webhook/slack/awsm.json

"ApiKeyRequired": false, - "RequestTemplates": {}, + "RequestTemplates": { + "application/json": "{\"x_github_event\": \"$input.params('X-GitHub-Event')\", \"body\": $input.json('$')}" + }, "RequestParameters": {},

リクエストHeaderの’X-GitHub-Event’の値を、Lambdaのパラメータ（event.x_github_event）に渡す

リクエストbodyをevent.bodyに渡す

ヘッダー情報を参照する# aws_modules/awsm-github-webhook/slack/index.js

module.exports.run = function(event, context, cb) {

+ // X-GitHub-Eventの値が「issue_comment」でない場合は処理を終了 + if(event.x_github_event != 'issue_comment') { + return cb(null, action()); + }

- var text = event.comment.body + '<' + event.comment.html_url + '>'; + var text = event.body.comment.body + '<' + event.body.comment.html_url + '>';

デプロイ$ jaws dash

JAWS: Dashboard for project "demo"

-------------------------------------------

Project Summary

-------------------------------------------

Stages:

dev ap-northeast-1

Lambdas: 1

Endpoints: 1

-------------------------------------------

Select Resources To Deploy

-------------------------------------------

awsm/slack

L) lAwsmGithubWebhookSlack

E) /awsm-github-webhook/slack - POST

- - - - -

> Deploy Selected -->

デプロイするリソースを選択

jaws dashコマンド

実行例

GithunのIssueにコメントすると・・・

実行例

GithunのIssueにコメントすると・・・

Slackに通知される！（メンションの名前が変わっています）

NPMとして公開する

AWSMをNPMにするときの構造awsm-github-webhook

awsm.json

package.json

awsm.json

handler.js

index.js

event.json

modularcode.js

npmの設定

Lambdaの部分はawsmディレクトリに入れるここにあるコードはカスタマイズして使われる想定

libディレクトリにはカスタマイズして欲しくないコードを入れる

NPM初期化$ cd aws_modules/awsm-github-webhook$ npm initname: (awsm-github-webhook)version: (1.0.0)description:entry point: (index.js)test command:git repository:keywords:author:license: (ISC)About to write to /Users/igarashi.ryosuke/temp/jaws/test/aws_modules/awsm-github-webhook/package.json:

$ mkdir awsm && mv slack awsm/slack80

対話的にnpmの初期設定

awsmディレクトリに移動

package.jsonが作られる

package.jsonの設定# aws_modules/awsm-github-webhook/package.json

"scripts": { + "postinstall": "jaws postinstall awsm-github-webhook npm" },

"dependencies": { "jaws-core-js": "~0.0.2", + "request": "^2.65.0" }

npm install 時に実行されるコマンドjaws postinstall コマンドが JAWSプロジェクトのaws-modulesディレクトリにawsmフォルダ内のファイルをコピーする。

依存モジュールも忘れずに。

NPMに公開$ npm publish

$ npm install https://github.com/bisque33/awsm-github-webhook --save

このサンプルは、実際にはnpmでは公開していません。

試してみたい場合は、Githubからinstallしてください。

https://github.com/bisque33/awsm-github-webhook

AWSMをプロジェクトにインポートする

AWSMのインポート・デプロイ$ npm install [awsm_name] --save

$ jaws env set [stage] [region] [変数名] [値]

$ jaws deploy resource

$ jaws dash

[JAWS] AWSMを使って認証・認可APIを作る｜ Developers.IO

http://dev.classmethod.jp/server-side/framework/jaws-awsm-users/

AWSMのダウンロード

環境変数の設定（必要があれば）

LambdaとAPI Gatewayのデプロイ

リソースのデプロイ（必要があれば）

まとめ

まとめ• インフラからデプロイまで、実際のアプリケーションを開発する上で不足している部分を補ってくれて便利！

• AWSMはnpmにして再利用可能にしよう！• まだベータなのでご利用は慎重に！

参考• jaws-framework/JAWS

https://github.com/jaws-framework/JAWS

• (DVO209) JAWS: A Scalable Serverless Frameworkhttp://www.slideshare.net/AmazonWebServices/dvo209-jaws-a-scalable-serverless-framework

• (レポート) DVO209: JAWS: 高度にスケーラブルなサーバーレスフレームワーク #reinvent ｜ Developers.IOhttp://dev.classmethod.jp/cloud/aws/reinvent2015-dvo209/

• JAWSフレームワークで、サーバレスな分散ロックサービス「Joumae」をつくった - Qiita http://qiita.com/mumoshu/items/3cbe31b315be31f510d0

ご静聴ありがとうございました。

awsで作るサーバレスapiアプリケーション

Engineering

aws for windows - media.amazonwebservices.com · amazon...

aws...

presentation title here · 2017-12-20 · 0...

aws black belt online seminar aws elastic...

[awsマイスターシリーズ] aws elastic beanstalk

awsで自作cgiをサーバレス実装してみた...

aws black belt online seminar 2016 aws cloudtrail & aws...

aws lambda を使用したサーバーレスアーキテク...

final fantasy xv pocket edition を支える...

aws-g500 / aws-g500hd sistema de producción de …...

[awsマイスターシリーズ]aws storage gateway

aws...

awsで始めるサーバレスな restful api システム

aws black belt tech シリーズ 2015 aws cloudtrail & aws...

s u m m i t - aws · amazon redshift amazon kinesis aws iot...

aws parallelcluster - aws parallelcluster user guide ·...

[awsマイスターシリーズ] aws cloudformation

aws cloudtrail & aws...

aws 接続環境構築ガイド...mqtt broker...

jaws札幌 re:invent...

awsで作る サーバレスapiアプリケーション

awsで作るサーバレスapiアプリケーション