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,
});

メモリ設定の詳細については、Memory ドキュメントをご覧ください。

Dockerfile の作成

Mastra プロジェクトのルートディレクトリで 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 エンドポイントの詳細は、サーバーのドキュメントを参照してください。

クライアントの接続

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

import { MastraClient } from "@mastra/client-js";
 
const mastraClient = new MastraClient({
  baseUrl: "https://あなたの-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 の許可元は信頼できるドメインに限定する
• 他の AWS サービスへの安全なアクセスには AWS IAM ロールを使用する
• 機密性の高い環境変数は AWS Secrets Manager または Parameter Store に保存する

監視

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

スケーリング

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

次のステップ

• Mastra クライアント SDK
• AWS Lambda のドキュメント 
• AWS Lambda Web Adapter