API Gateway + Lambda + DynamoDB = Serverless
AWSでサーバーレスを構築するアーキテクチャを考えた時に、もっとも基本的でわかりやすい構成は、API Gateway + Lambda + DynamoDB(ないしはS3)の組み合わせだと思います。
このエントリーで触れること
- Lambda関数の作り方
- API Gatewayでのリソースの作り方
- API GatewayとLambda関数の紐づけ方
- Lambda関数でのDynamoDBのいじり方
AWS SAMには触れないです。
Lambdaで関数を作る
Lambdaで関数を作ってデプロイするのは非常に簡単な作業です。
ランタイムはnode.jsを使います。
関数を作成する方法としては、
- AWSコンソール上で関数を作成する
- ローカルで関数を作成してzip化し、Lambdaにアップロードする
- ローカルで関数を作成してzip化し、S3にアップロードした後に、Lambdaからそれを呼ぶ
- ローカルで関数を作成してzip化し、cliでデプロイする
の4種類の方法があり、もっとも簡便に作るのであれば1で事足ります。
しかし、もっと込み入った内容のロジックが必要なのであれば、2,3,4の方法を選びます。
たとえば、node_modulesを入れてyarnでインストールしてきたライブラリを使いたいとか、lambda上ではできないけどローカルでは用意できるようなものを設定したい時には、2,3,4の方法でデプロイした方が良さそうです。
ここでは1と2,3,4の関数作成方法に分けて簡単に関数を作ってみます。
AWSコンソール上で関数を作成
AWS Lambdaのページからサイドペインの「関数」を選択すると、関数が一覧で表示されます。
この一覧のヘッダー部分に以下のように関数の作成ボタンがあります。
![Screenshot 0031-11-05 at 10.42.09 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2F8eb78021-9af5-85bd-ffc4-42858647d4ab.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=4014b7b4cf57673e8604591a8cc242d4)
ボタンクリック後の設定では、
- 一から作成(選択)
- 関数名(入力)
- ランタイム(ここではnode.js10.x) (選択)
- 基本的なLambdaアクセス宣言で新しいロールを作成(選択)
「関数の作成」からLambda関数を作成します。
すると、作成した関数の詳細ページへ飛び、関数のコードを編集することができます。
![Screenshot 0031-11-12 at 9.37.29 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2Ffe3c84a2-d954-aa55-6c3b-9b5fcd80e23f.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=bc34c7ac4303fc52b9ecff81b768a23c)
デフォルトのコードでは、'Hello from Lambda!'の文字列がstatusCode200で返ってくるようになっています。
ここでrequestを受け取って処理するなどを行うためには、この後説明するAPI Gatewayの設定を行う必要があります。
ローカルで関数を作成してLambdaにアップロード
$ mkdir myFunction | cd myFunction
$ yarn
$ yarn add moment
$ vim index.js
index.jsの中身は適当にこんな感じで
![Screenshot 0031-11-12 at 9.34.11 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2Fc7cf1dc1-d148-af15-7ca1-7cab2f2cea98.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=a401b312e7ca8ddc1e1dbf8c18c5f74f)
コードが書けたらnode_modulesと同じレベルのディレクトリ内でzipコマンドを実行します。
$ tree
.
├── index.js
├── node_modules // 以下省略
├── package.json
└── yarn.lock
$ zip myFunction . -r
$ ls
index.js myFunction.zip node_modules package.json yarn.lock
解凍した時に上記の内容を含んだmyFunctionディレクトリがトップレベルになる必要があるのでzipコマンドには-rオプション(recurse into directory)をつけています。
zipができたらLambdaのコンソールに移動して、以下のコードエントリタイプのドロップダウンから「.zipファイルをアップロード」を選択します。
![Screenshot 0031-11-05 at 11.14.08 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2F4b4780a6-3e4f-f4be-2c57-c77ec09ad690.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=4565ef55e3be916b9b66e681aa01c0f7)
アップロードボタンが出てくるのでそこから上で作成したzipをアップロードしてみましょう。
保存すると、関数コード欄のソースコードがローカルで作成したコードに書き換わります。
インストールしておいたmomentも使えるようになり、エディターのサイドペインにnode_modulesが追加されていると思います。
コンソール上だけだとnode_modulesを利用することができませんが、このようにローカルで作成してからアップロードするとコンソール上でもnode_modulesを扱えるようになります。
![Screenshot 0031-11-05 at 11.23.16 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2F71e2d80b-df1c-5e4a-b33b-e945cf0e7991.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=2c73a04662b21398b78abf7c47c39763)
ローカルで関数を作成してS3にアップロード
Lambdaに直接zipをアップロードすることもできますが、S3にアップロードしたzipを参照することもできます。
Lambda上に表示される注意書きにもありますが、大きなサイズのzipをアップロードする際にはS3経由でLambdaにデプロイするのが望ましいようです(具体的には10MB以上はS3の利用を検討した方が良いらしいです)。
上記で作成したmyFunction.zipを使いまわします。
$ zip myFunction . -r
でmyFunction.zipを作成したのち、S3コンソールを開きます。
適当な名前のバケットを作成して、その中にmyFunction.zipをアップロードします。
![Screenshot 0031-11-12 at 9.43.06 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2Fd9ad7cad-bf41-e842-d453-9998fe387d9f.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=ca7b725ce2b75b2e9bff43e6f471fa7f)
次にLambdaコンソールを開きます。
関数コードの「AmazonS3からのファイルのアップロード」を選択して、S3にアップロードしたzipのオブジェクトURLを入力します。
![Screenshot 0031-11-12 at 9.46.42 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2F068bbdf7-145a-8ec4-0c35-c8239bd9b391.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=f3497dd8dd2f46cb2aee349f0c2c1013)
あとは関数を保存するだけです。
テストを実行すると、レスポンスが返ってきます。
![Screenshot 0031-11-12 at 9.48.54 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2F0c2d5cc8-570f-6dd0-fe15-a4c82d1acec9.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=ea31a89f8cc4e1b42b6088e1d6c02a89)
ローカルで関数を作成してCLIでデプロイ
CLIで関数を作成する場合は、create-functionを利用します。
https://docs.aws.amazon.com/cli/latest/reference/lambda/create-function.html
create-function
--function-name <value>
--runtime <value>
--role <value>
--handler <value>
[--code <value>]
[--description <value>]
[--timeout <value>]
[--memory-size <value>]
[--publish | --no-publish]
[--vpc-config <value>]
[--dead-letter-config <value>]
[--environment <value>]
[--kms-key-arn <value>]
[--tracing-config <value>]
[--tags <value>]
[--layers <value>]
[--zip-file <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]
また、関数を更新する場合には、update-function-codeかupdate-function-configurationを利用します。
https://docs.aws.amazon.com/cli/latest/reference/lambda/update-function-code.html
https://docs.aws.amazon.com/cli/latest/reference/lambda/update-function-configuration.html
update-function-codeはlambda関数のコードを更新するコマンドで、
update-function-configurationはlambda関数の設定(ランタイムや環境変数)を更新するコマンドです。
他のコマンドについてはCLI Command Referenceを参照してください。
さて、デプロイした後はそれだけでは関数は使えませんので、API Gatewayを介して呼び出せるように設定します。
API GatewayからLambda関数を利用する
API GatewayとLambdaの関係性は、
-
API Gateway
クライアントからの通信を受け付けてLambda関数にリクエストを渡す。
また、そこから受け取ったレスポンスをクライアントに返却する。
(API GatewayはLambda以外にも既存のHTTPエンドポイントやSQSやSNSなどのAWSリソースと連携させることもできます) -
Lambda
API Gatewayから受け取ったリクエストを基に処理を実行し、レスポンスを返却する。
![Screenshot 0031-10-27 at 7.58.53 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2Fb1b8a090-738e-6cfe-cb26-08e9b0502d26.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=7754c1d1839f14f3cc4c801566d4e80b)
① メソッドリクエスト
クエリーのパラメータ等を設定する。
② 統合リクエスト
API Gatewayのリソースが呼び出す対象を設定する(ここではlambda関数となる)。
lambdaへ送るbodyパラメーターのテンプレートを設定する。
③ 統合レスポンス
lambdaから返ってきたレスポンスをAPI Gatewayのレスポンス設定にマッピングする。
④ メソッドレスポンス
API Gatewayがクライアントへ返すステータスコードごとのレスポンスヘッダーやボディを設定する。
API Gatewayでエンドポイントを作る
API Gatewayの「APIの作成」からAPIを作っていきます。
今回はプロトコルをRESTとし、名前はmyAPIとします。
![Screenshot 0031-11-12 at 10.05.19 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2F8660ea1d-87d0-416b-657f-087c1c75f575.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=bc2a13b36ad24b1cbf8e758e256e9467)
作成されたmyAPIのリソース画面で、「アクション」のドロップダウンをクリックするとアクション一覧が表示されます。
ここでリソースを作成します。
![Screenshot 0031-11-12 at 10.05.53 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2Fce5b4887-1d89-c7c9-f159-b6b5e8acfab5.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=50273db6f0f3c5756587737a715a3838)
リソース名を入れて「リソースの作成」を行います。
![Screenshot 0031-11-12 at 10.18.59 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2Fd04922eb-c97f-afa0-4e05-8b03c63797a8.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=6fbf66d885da1b60595a76f7133c3317)
そして、作成したリソースにメソッドを追加していきます。
「アクション」ドロップダウンからメソッドの作成を選択し、メソッドの種類を選択します。
ここではGETを選択してチェックします。
![Screenshot 0031-11-12 at 10.19.48 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2Fe386c27c-2b93-b199-a5bc-7ac3409338cc.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=c0f1ba55ff32a2e5479b99a6c2b1764b)
GETメソッドの統合タイプにLambda関数を選択し、
Lambda関数に上記で作成したmyFunction関数を選択します。
![Screenshot 0031-11-12 at 10.21.50 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2Fb5d7a825-a4d0-cb22-294e-0d967b7406cc.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=e79ae14d1334a5da1cfc3a24a3a84843)
保存すると以下のような画面が表示されます。
ここで前述したメソッドリクエスト、統合リクエスト、統合レスポンス、メソッドレスポンスを設定します。
![Screenshot 0031-11-12 at 10.23.11 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2Fa732c020-087b-8e00-e0ac-7628cc8abfe9.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=9d3bcf3a29dde2f41d60601ab2c97ae7)
今回冗長となるのでこれらの細かい説明は省きます。
あとはAPIをデプロイして、作成されるエンドポイント/myresourceにアクセスしてみましょう。
デプロイ時のステージなどは好きなように設定してみてください。
![Screenshot 0031-11-12 at 10.28.12 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2Fd28e4fc7-413f-0ff3-57fb-7454cf01af2c.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=c227a0698fcd8f743d33880fe199ffa8)
すると、先ほど作成したLambda関数のレスポンスがブラウザに表示されるはずです。
![Screenshot 0031-11-12 at 10.29.14 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2F1fa3f61c-e511-f185-bd24-c3668dd3f11a.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=20033a9ee16ad0bd0a9698c66002bb96)
LambdaからDynamoDBに接続する
次はLambdaからDynamoDBの値を取得して、その値をクライアントへ返せるようにします。
DynamoDBにデータを作る
DynamoDBのダッシュボードから「テーブルの作成」をクリックします。
![Screenshot 0031-11-12 at 10.35.39 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2Ff4baaaab-0cdc-c6a7-791e-fe3cb557e75c.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=3968333ac7b43dc6333e99e634e79e5e)
パーティションキー等の設計についてはDynamoDBのベストプラクティスを参考にしてみてください。
作成したテーブルに項目を追加します。
「項目の作成」からパーティションキーの値の他に任意の項目を追加します。
![Screenshot 0031-11-12 at 10.40.10 PM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2Fc746f773-c1b4-30d0-ffa7-984f69489203.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=4bc8b0c315ed3ba86cd6a4b94e9025b4)
これでデータが用意できたので、このテーブルにLambdaから接続して値を取得できるようにします。
以下のようなjsファイルを用意し、zip化します。
const AWS = require('aws-sdk')
const moment = require('moment')
const dynamo = new AWS.DynamoDB.DocumentClient({region: 'ap-northeast-1'})
exports.handler = async (event, context) => {
const params = {
TableName: "testTable",
Key:{
uuid: "7dd1b5f4-bb05-4a87-b464-5ddf88254837"
}
}
await dynamo.get(params, (err, data) => {
if (err) context.fail(err)
context.succeed({
statusCode: 200,
body: data,
time: moment().format('YYYY/MM/DD')
})
}).promise()
}
$ tree
.
├── index.js
├── node_modules // 以下省略
├── package.json
└── yarn.lock
$ zip myFunction . -r
$ ls
index.js myFunction.zip node_modules package.json yarn.lock
直接LambdaにアップロードでもS3にアップロードしてそれを参照するのでも良いです。
アップロード後に保存してテストを実行してみてください。
![Screenshot 0031-11-13 at 12.27.32 AM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2F6f54c387-fe50-da12-8f7f-8971e6e8efcb.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=5f3167150b8df32a1e3159bce68e0e8b)
こんな感じでレスポンスが返ってきたら成功です。
この関数を紐づけたAPI Gatewayのエンドポイントに接続してみてください。
![Screenshot 0031-11-13 at 12.28.57 AM.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F245704%2F38903089-4cb0-72b2-1f46-39e5eb293ba1.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=5a100ba0c7472b79e091e2980b8d08e9)
DynamoDBから取得したデータがブラウザに表示されると思います。
もっと応用的に、リクエストを受け取って任意のデータを取得したいような場合には、統合リクエストのマッピングテンプレート等を設定して、Lambdaに渡るeventの中身を定義する必要がありますが、ここでは省きます。
ここまでで以下の項目について触れてきました。
- Lambda関数の作り方
- API Gatewayでのリソースの作り方
- API GatewayとLambda関数の紐づけ方
- Lambda関数でのDynamoDBのいじり方
上でやったようにコンソールで色々と操作しましたが、AWS SAMを使えばコマンドラインでサーバーレスを構築する構築することもできます。
ローカルでテストができるのは気が楽ですね