API GatewayとLambdaを使ったサーバレスSpringアプリケーション(3)

前回までに、「Spring Cloud Function」でサーバレスアプリケーション実装し、「AWS Lambda」へ登録しました。今回は、「Amazon API Gateway」を設定して、登録したLambda関数を呼び出してみましょう。

Amazon API Gatewayの設定

リクエストを受け付けて、設定したAWS Lambdaを実行するためのAPI Gatewayの設定を行います。AWSコンソールの API Gatewayサービスメニューから、以下を入力して、「APIの作成」ボタンを押下してください。

• Protocol：REST
• 新しいAPIの作成：新しいAPI
• API名：任意の名前を入力
• エンドポイントタイプ：リージョン

API作成後、「アクション」メニューから「リソースの作成」を選択します。

開かれた「新しい子リソース」画面で「リソース名」と「リソースパス」を設定し、「リソースの作成」ボタンを押下します。

作成したリソースを選択し、「アクション」メニューから「メソッドの作成」→「POSTメソッド」を選択して、チェックボタンを押下します。

なお、このとき「GETメソッド」を指定すると、SpringBootApiGatewayRequestHandlerではJSONリクエストボディがなくなるため、エラーになります。本稿執筆時点（2019年1月）で、この問題は「ISSUE」として起票されています。

POSTメソッドのセットアップ

続いて、以下の設定内容に従って、POSTメソッドのセットアップを行い、「保存」ボタンを押下します。

• 統合タイプ：Lambda関数
• Lambdaプロキシ統合の使用：チェックする
• Lambdaリージョン：Lambdaを作成したリージョン
• Lamnda関数：前節で作成したLambda関数名を選択する。
• デフォルトタイムアウトの使用：チェックする

このとき、「Lambdaプロキシ統合の使用」をチェックしないと、Lambda FunctionにSpring Cloud Functionが期待するデータが来ないので、エラーとなります。忘れないようにチェックしておきましょう。

なお、「Lambdaプロキシ統合の使用」をチェックしないとエラーになる理由は、今回ハンドラクラスで継承したSpringBootApiGatewayRequestHandlerが、型パラメータとしてcom.amazonaws.services.lambda.runtime.events.APIGatewayProxyRequestEventを指定しているためです。Lambdaプロキシ統合でなければ、上記の型パラメータクラスに必要な情報が渡って来ないため、NullPointerExceptionでエラーになります。

Lambda関数の動作テスト

では、設定したLambda関数が正しく動くかどうか、動作テストをしてみましょう。それにはまず、「テスト」リンクを押下します。

以下の項目を入力し、「テスト」ボタンを押下します。

• リクエスト本文：{“test”:”TestMessage”}

「レスポンス本文」欄に「Complete!」と表示されれば、アップロードしたサーバレスアプリケーションが正常に実行された結果です。

Lambda関数が正常に実行できることは確認できましたが、外からAPIをコールするためには、APIのデプロイが必要です。それにはまず、「アクション」メニューから「APIのデプロイ」を選択します。

「デプロイされるステージ」欄で「新しいステージ」を選択して任意の名前を入力し、「デプロイ」ボタンを押下します。ステージ名はエンドポイントURLにも反映されるため、「prod」や「dev」などにするのが一般的です。

APIがデプロイされると、エンドポイントのURLが表示されます。このURLにリソース名を加えたものがリソースURLになります。

設定が終わったら、実際に外部のローカルクライアントから、curlコマンドなどでリクエストを送信し、実行結果を確認してみましょう。エンドポイントURLの最後にリソース名を付与するのを忘れないでください。

curl -d '{"test":"TestMessage"}' https://xxxxxxxx.execute-api.ap-northeast-1.amazonaws.com/dev/sample

コマンドを実行した結果、「”Complete!”」というメッセージが返却されるのに加えて、CloudWatch Logsには、実行したLambda関数の結果が表示されます。

Lambda関数の初回起動時は、SpringFrameworkの起動でAPIリクエストを送信してから実行されるまでに少々時間がかかります。2回目以降は実行環境が再利用されるので、即時処理されますが、実行環境は一定時間経つと破棄されるので、そうした制約を考慮しておきましょう。

*　*　*

以上、3回に渡り、AWS LambdaとAPI Gatewayを使ったサーバレス環境下でSpringアプリケーションを構築してきました。

AWS LambdaやAmazon API Gateway、Spring Cloud Functionを利用することにより、ごくごく少量のコーディングで、サーバレスアプリケーションを実行することができます。このサーバレス開発のスタックはとても簡易で、かつ拡張性も高く、エンタープライズ開発でも十分有用です。