AWS Lambda

DockerコンテナとAWS Lambda Web Adapterを使用して、MastraアプリケーションをAWS Lambdaにデプロイします。 このアプローチにより、Mastraサーバーを自動スケーリング機能付きのコンテナ化されたLambda関数として実行できます。

前提条件

AWS Lambdaにデプロイする前に、以下が必要です：

• AWS CLI がインストールされ、設定されていること
• Docker がインストールされ、実行されていること
• Lambda、ECR、IAMの適切な権限を持つAWSアカウント
• 適切なメモリストレージで設定されたMastraアプリケーション

メモリ設定

Lambda関数にはファイルシステムストレージに制限があります。Mastraアプリケーションをインメモリまたは外部ストレージプロバイダーを使用するように設定してください：

オプション1：インメモリ（最もシンプル）

import { LibSQLStore } from "@mastra/libsql";
 
const storage = new LibSQLStore({
  url: ":memory:", // インメモリストレージ
});

オプション2：外部ストレージプロバイダー

Lambda呼び出し間で永続的なメモリを使用するには、TursoでLibSQLStoreを使用するか、PostgreStoreなどの他のストレージプロバイダーを使用してください：

import { LibSQLStore } from "@mastra/libsql";
 
const storage = new LibSQLStore({
  url: "libsql://your-database.turso.io", // 外部Tursoデータベース
  authToken: process.env.TURSO_AUTH_TOKEN,
});

メモリ設定オプションの詳細については、メモリドキュメントを参照してください。

Dockerfileの作成

FROM node:22-alpine
 
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY src ./src
RUN npx mastra build
RUN apk add --no-cache gcompat
 
COPY --from=public.ecr.aws/awsguru/aws-lambda-adapter:0.9.0 /lambda-adapter /opt/extensions/lambda-adapter
RUN addgroup -g 1001 -S nodejs && \
  adduser -S mastra -u 1001 && \
  chown -R mastra:nodejs /app
 
USER mastra
 
ENV PORT=8080
ENV NODE_ENV=production
ENV READINESS_CHECK_PATH="/api"
 
EXPOSE 8080
 
CMD ["node", "--import=./.mastra/output/instrumentation.mjs", ".mastra/output/index.mjs"]

ビルドとデプロイ

export PROJECT_NAME="your-mastra-app"
export AWS_REGION="us-east-1"
export AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)

docker build -t "$PROJECT_NAME" .

aws ecr create-repository --repository-name "$PROJECT_NAME" --region "$AWS_REGION"

aws ecr get-login-password --region "$AWS_REGION" | docker login --username AWS --password-stdin "$AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com"

docker tag "$PROJECT_NAME":latest "$AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/$PROJECT_NAME":latest
docker push "$AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/$PROJECT_NAME":latest

デプロイメントのテスト

デプロイ後、Lambda関数をテストします：

1. LambdaコンソールからFunction URLをコピーします
2. ブラウザでURLにアクセスして、Mastraのサーバーホーム画面を確認します
3. 生成されたAPIエンドポイントを使用してエージェントとワークフローをテストします

利用可能なAPIエンドポイントの詳細については、Serverドキュメントを参照してください。

クライアントの接続

Lambda関数URLを使用するようにクライアントアプリケーションを更新します：

import { MastraClient } from "@mastra/client-js";
 
const mastraClient = new MastraClient({
  baseUrl: "https://your-function-url.lambda-url.us-east-1.on.aws",
});

トラブルシューティング

関数タイムアウトエラー

Lambda関数がタイムアウトする場合：

• Configuration > General configurationでタイムアウト値を増やす
• より高速なコールドスタートのためにMastraアプリケーションを最適化する
• 一貫したパフォーマンスのためにプロビジョンド同時実行の使用を検討する

メモリの問題

メモリ関連のエラーが発生した場合：

• Configuration > General configurationでメモリ割り当てを増やす
• CloudWatch Logsでメモリ使用量を監視する
• アプリケーションのメモリ使用量を最適化する

CORSの問題

ホームページではなくエンドポイントにアクセスする際にCORSエラーが発生する場合：

• MastraサーバーコンフィギュレーションでCORSヘッダーが適切に設定されていることを確認する
• Lambda Function URLのCORSコンフィギュレーションを確認する
• クライアントが正しいURLにリクエストを送信していることを確認する

コンテナイメージの問題

Lambda関数の起動に失敗する場合：

• Dockerイメージがローカルで正常にビルドされることを確認する
• DockerfileのCMD命令が正しいことを確認する
• コンテナ起動エラーについてCloudWatch Logsを確認する
• Lambda Web Adapterがコンテナに適切にインストールされていることを確認する

本番環境での考慮事項

本番環境でのデプロイメントについて：

セキュリティ

• CORS originを信頼できるドメインに制限する
• 他のAWSサービスへの安全なアクセスにAWS IAMロールを使用する
• 機密性の高い環境変数をAWS Secrets ManagerまたはParameter Storeに保存する

監視

• Lambda関数のCloudWatch監視を有効にする
• エラーとパフォーマンスメトリクスのCloudWatchアラームを設定する
• 分散トレーシングにAWS X-Rayを使用する

スケーリング

• 予測可能なパフォーマンスのためにプロビジョンド同時実行を設定する
• 同時実行数を監視し、必要に応じて制限を調整する
• より複雑なルーティングニーズにはApplication Load Balancerの使用を検討する

次のステップ

• Mastra Client SDK
• AWS Lambda documentation 
• AWS Lambda Web Adapter