Javaで実装したプログラムをAWS Lambdaにデプロイして実行する方法

この記事はこんな人にオススメ

AWS Lambdaに興味のある人
AWSを使用したサーバーレスコンピューティングに興味のある人
Javaで開発したプログラムをAWS Lambdaで運用したい人

どうも、Shinyaです。

この記事では、Javaで開発したプログラムをAWS Lambdaにデプロイして実行する方法について書いていきます。

AWS Lambdaは、AWS（Amazon Web Services）から提供されているコンピューティングサービスの一つで、簡単にサーバーレスコンピューティングを実現することができます。そのため、サーバーなどのインフラに関する専門的な知識がなくても、実装したプログラムをクラウド上のサーバーにデプロイして簡単に運用することが可能です。

また、AWS LambdaはAWSの各サービスと簡単に組み合わせることができます。例えば、AWS LambdaにデプロイしたプログラムをAmazon EventBridgeと組み合わせて決められたスケジュールで定期的に実行することや、Amazon API Gatewayと組み合わせてWeb APIとして外部アプリから実行することも可能です。

こうした特性から、AWS Lambdaは様々な開発に応用できる非常に汎用性の高いAWSのサービスです。AWS Lambdaを使いこなせるようになると、AWSを活用して開発できるアプリケーションの幅が非常に広がるでしょう。

事前準備
利用料金について
AWS Lambdaにデプロイするプログラムを実装する
作成したJarファイルをAWS Lambdaにデプロイする
デプロイしたJavaプログラムを実行してみる

事前準備

この記事ではAWS Lambdaを使用するため、なによりAWSアカウントが必要になります。そのため、まだAWSアカウントを作成していない方は、公式AWSサイトからAWSアカウントを作成してください。

また、この記事ではAWS LambdaにデプロイするプログラムをJavaで実装していくので、事前に使用するPCにJDKをインストールしておく必要があります。先日、OpenJDKの一つでAmazon/AWSから完全無償で提供されているAmazon Correttoのインストール方法について書きましたので、まだJDKをインストールしていない方は以下の記事を参考にインストールしてみてください

利用料金について

AWS Lambdaは、他のAWSのサービスと同様に、使用した分だけ利用料金が発生する従量課金制となっています。

しかし、AWS Lambdaには超太っ腹な無料利用枠が用意されており、なんと1ヶ月あたり100万件のリクエストと40万GB-秒のコンピューティング時間を無料で利用することができます。

1ヶ月あたり100万件のリクエストと40万GB-秒のコンピューティング時間というと、高トラフィックのWebアプリやモバイルアプリを運営していたり、大量データを高頻度で計算するようなバッチアプリケーションを運用していない限りなかなか超えられないような枠です。

そのため、個人開発で使用する場合はもちろんのこと、クラウドベースでプロトタイプのサービスを構築したいスタートアップにもオススメのサービスとなっています。

AWSが提供しているサービスの利用料金は頻繁に変更されるため、古い情報を掲載し続けないようにこの記事では利用料金の詳細には触れません。

AWS Lambdaの利用料金については、AWS Lambda公式の料金ページで最新の情報を確認するようにしてください。

AWS Lambdaにデプロイするプログラムを実装する

早速、AWS Lambdaにデプロイするための検証用の簡単なプログラムをJavaでサクッと実装していきましょう。

この記事の例では、JavaプログラムをMavenプロジェクトとしてプログラムを作成していきます。Maven以外のGradleなどのビルド管理ツールを使用したい場合は、依存ライブラリの追加方法などをそれぞれのビルド管理ツールに読み替えてください。

使用するライブラリ

AWS LambdaにデプロイするためのJavaプログラムを作成するためには、次の公式ライブラリが必要になります。

AWS Lambda Java Core Library
- https://mvnrepository.com/artifact/com.amazonaws/aws-lambda-java-core

<!-- https://mvnrepository.com/artifact/com.amazonaws/aws-lambda-java-core -->
<dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-lambda-java-core</artifactId>
    <version>1.3.0</version>
</dependency>

今回の例では、この記事を書いている時点で最新バージョンの「1.3.0」を使用していきます。

ライブラリをPOMに追加する

先に確認した公式ライブラリを次のようにPOMのdependenciesタグの中に追加します。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>dev.shinyakato.lambda</groupId>
    <artifactId>lambda</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>21</maven.compiler.source>
        <maven.compiler.target>21</maven.compiler.target>
    </properties>

    <dependencies>
        <!-- https://mvnrepository.com/artifact/com.amazonaws/aws-lambda-java-core -->
        <dependency>
            <groupId>com.amazonaws</groupId>
            <artifactId>aws-lambda-java-core</artifactId>
            <version>1.3.0</version>
        </dependency>
    </dependencies>
</project>

POMの依存性に公式ライブラリを追加したら、次のMavenコマンドを実行してライブラリをインストールしておきましょう。

mvn clean install

Lambdaハンドラーの実装

それでは、ライブラリのインストールも終わったので、実際にAWS LambdaにデプロイするJavaプログラムを作成していきましょう。AWS LambdaにデプロイするためのJavaプログラムを作成するのはとても簡単で、基本的に次の手順で実装するだけです。

RequestHandlerインターフェースをimplementsする
- ジェネリクスの第一引数はLambda実行時に受け取る入力の型を指定
- ジェネリクスの第二引数はLambda実行時に返却する出力の型を指定
handleRequestメソッドを実装する
- Lambda実行時の処理を定義
- 第一引数はRequestHandlerのジェネリクスで指定した入力の型を指定
- 返却型はRequestHandlerのジェネリクスで指定した出力の型を指定

上記の手順を踏まえて、Lambda実行時に「Hello, World!」という文字列を返す単純なLambdaハンドラーを実装すると以下のようになります。

package dev.shinyakato.lambda;

import com.amazonaws.services.lambda.runtime.Context;
import com.amazonaws.services.lambda.runtime.RequestHandler;

public class SayHelloHandler implements RequestHandler<Object, String> {

    @Override
    public String handleRequest(Object input, Context context) {
        return "Hello, World!";
    }
}

AWS LambdaにJavaプログラムをデプロイできるように実装するためには、RequestHandlerインターフェースとhandleRequestメソッドを実装するだけで作業は完了です。

そのため、依存するシステムなどをひとまず隅に置いておいて単純に考えると、もし既にオンプレミスのサーバーなどで稼働しているバッチアプリケーションなどをAWS Lambdaに移行したいような場合は、オンプレミスのサーバーで実際に実行しているJavaクラスを個々の目的に合わせて実装したLambdaハンドラークラスのhandleRequestメソッドの中で実行するようにするだけです。

AWS Lambdaにデプロイする際にはJarファイルが必要なので、次のMavenコマンドを実行してビルドしておきましょう。