はじめに

はじめまして。9月にバックエンドエンジニアとしてジョインした@yasuyasu002dです。

AWSを使ったサーバーレスアーキテクチャは、その効率性とスケーラビリティから多くの企業や開発者に採用されています。しかし、インフラコードの管理やリアルタイム開発が課題になることもあります。
Serverless Stack (SST) は、これらの課題を解決し、効率的にサーバーレスアプリケーションを構築できるフレームワークです。

本記事では、Serverless Stack (SST) v3 を使って、簡単にサーバーレスシステムを構築する方法をご紹介します。

SSTを使ったプロジェクトのセットアップ
AWS LambdaとS3を利用したサーバーレスシステム構築
SSTのリアルタイム開発機能「Live Lambda Debugging」の体験

SST とは

Serverless Stack (SST) の概要

Serverless Stack (SST) は、AWS上でサーバーレスアプリケーションを簡単に構築できるフレームワークです。SST v3 では、新たに Plumi を基盤として、従来のAWS CDKベースから進化しました。

SSTの特長

シンプルで直感的にクラウド構築
IaCツールである pulumi をベースのため軽量で簡潔なコードが記述が可能。(v2 までは AWS CDK利用していました）
フロントエンド統合が容易
Next.jsといったモダンフレームワークと統合可能で、sst.aws.StaticSiteやsst.aws.Nextjsを活用して簡単にホスティングができます。
リアルタイム開発
Lambda関数をデプロイせずにデバッグ可能な「Live Lambda Debugging」機能を搭載し、開発効率を大幅に向上。

SSTの活用例

Next.jsでのフロントエンドとバックエンドAPI開発の統合開発
イベント駆動型アーキテクチャの構築 (例: EventBridgeとの連携)

システム構成

以下は、LambdaからS3にJSON形式のデータをアップロードする構成を示しています。Lambda関数は現在時刻を取得し、その結果をS3に保存します。

実装例

事前準備としてNode.js、AWSCliをセットアップが必要です。

1. プロジェクトのセットアップ

SSTの公式テンプレートを利用して、プロジェクトをセットアップします。

githubからテンプレートを git clone し npm install します

(テンプレート利用については以下を参考にしてください)

IaC定義の確認

sst.config.ts

設定情報、リソース定義を行います。

export default $config({
  // アプリ設定情報
  app(input) {
    return {
      name: "monorepo-template",
      removal: input?.stage === "production" ? "retain" : "remove",
      home: "aws",
    };
  },
  // リソース定義
  async run() {
    await import("./infra/storage");
    const api = await import("./infra/api");

    return {
      api: api.myApi.url,
    };
  },
});

./infra/storage , ./infra/api にそれぞれ作成するS3バケット、Lambdaのリソース定義がされています。

infra/api.ts : Lambda function

export const myApi = new sst.aws.Function("MyApi", {
  url: true,
  link: [bucket],
  handler: "packages/functions/src/api.handler"
});

infra/storage.ts : s3バケット

export const bucket = new sst.aws.Bucket("MyBucket");

設定変更

アプリ名を"monorepo-template"→"sst-example"に変更します。

 export default $config({
   app(input) {
     return {
-      name: "monorepo-template", <-- app 名
+      name: "sst-example",
       removal: input?.stage === "production" ? "retain" : --

デプロイ

デプロイ実行してみます。ターミナル上で AWSクレデンシャルをexportし、コマンド実行

$ npx sst deploy --stage <stage名>

Completeと表示されればデプロイ完了です。

npx sst deploy --stage dev
SST 3.3.44  ready!

➜  App:        sst-example
   Stage:      dev

~  Deploy
✓  Complete
   MyApi: https://xxx.lambda-url.ap-northeast-1.on.aws/
   ---
   api: https://xxx.lambda-url.ap-northeast-1.on.aws/

AWSコンソールで確認するとLambdaとS3が「sst-example-dev-MyApiFunction」「sst-example-dev-mybucket-xxxxx」でそれぞれ作成されています。
Lambda関数をテスト実行すると、関連するバケット名が出力されます

{
  "statusCode": 200,
  "body": "Hello, world! Linked to sst-example-dev-mybucket-xxx."
}

2.コード修正(LambdaからS3へファイルアップロード)

セットアップできたので、SST Live機能を利用してS3アップロード変更をローカルで確認してみます。

開発用環境の構築

sst dev コマンドで開発者環境を構築します。(詳細は公式ドキュメント参照)

$ npx sst dev

ターミナルがSST開発モードに切り替わります。

Functions にするとLambdaログ出力されます

コード修正

packages/functions/src/api.ts

export const handler: Handler = async (_event) => {
  
+  const s3 = new S3Client();
+
+  const data = {
+    date: new Date()
+  }
+
+  await s3.send(new PutObjectCommand({
+    Key: "sample.json",
+    Body: JSON.stringify(data),
+    Bucket: Resource.MyBucket.name, // SST が自動注入
+    ContentType: "application/json"
+  }));
+
+  console.log(`S3 upload`)

テスト

AWSコンソール上から Lambdaをテスト実行させInvokeするとローカルにプロキシされローカルのソースコードが実行されます

|  Build       MyApi
|  Invoke      MyApi
|  +218ms      S3 upload
|  Done        took +414ms

S3にもjson保存されていること確認できます

$ aws s3 ls sst-example-pc-name-mybucket-xxxxx
2024-12-09 14:09:43         35 sample.json

ローカルでの検証ができたので sst deployでデプロイを実施し今回のシステムは完了です。

まとめ

今回の記事では、SSTを活用してシンプルなサーバーレスシステムを構築しました。SSTは簡潔なコードと便利なデバッグ機能で、AWSリソースの構築を効率化します。サーバーレスアーキテクチャを学び、応用していく第一歩として、ぜひこのシステムを試してみてください！

最後に、トレブレは、技術を通じて価値を生み出すことを目指し、成長し続けるチームです。新たな挑戦を共に進める仲間をお待ちしています！

参考サイト