はじめに
はじめまして。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リソースの構築を効率化します。サーバーレスアーキテクチャを学び、応用していく第一歩として、ぜひこのシステムを試してみてください！
最後に、トレブレは、技術を通じて価値を生み出すことを目指し、成長し続けるチームです。新たな挑戦を共に進める仲間をお待ちしています！