lambda memo

lambda memo

src.lambda.ts

• npm install @vendia/serverless-express aws-lambda

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import serverlessExpress from '@vendia/serverless-express';
import { Context, APIGatewayEvent } from 'aws-lambda';
import { INestApplication } from '@nestjs/common';

let cachedServer; // コールドスタート対策のキャッシュ

async function bootstrap(): Promise<INestApplication> {
  const app = await NestFactory.create(AppModule);
  // SwaggerセットアップやCORS設定などを行う
  // 例: const config = new DocumentBuilder().setTitle('Swagger').build();
  // 例: const document = SwaggerModule.createDocument(app, config);
  // 例: SwaggerModule.setup('api-docs', app, document);
  //
  // listenはしない。Lambdaではinit()のみ。
  await app.init();
  return app;
}

export const handler = async (event: APIGatewayEvent, context: Context) => {
  if (!cachedServer) {
    const app = await bootstrap();
    const expressApp = app.getHttpAdapter().getInstance();
    cachedServer = serverlessExpress({ app: expressApp });
  }
  return cachedServer(event, context);
};

Dockerfile

FROM public.ecr.aws/lambda/nodejs:22

WORKDIR /var/task

COPY package*.json ./
RUN npm ci

COPY . .

Nestのビルド
RUN npm run build

CMD ["dist/lambda.handler"]

SAMテンプレート (template.yaml)

このテンプレートでは「Api イベント」を設定しているので、API Gatewayが自動的に作成され、ANY /{proxy+} で全パスを受け取りLambdaへ転送

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: Deploy Nest.js on AWS Lambda (Container Image) with SAM

Globals:
  Function:
    Timeout: 15  # Lambdaのタイムアウト秒数を指定

Resources:
  NestLambdaFunction:
    Type: AWS::Serverless::Function
    Metadata:
      BuildMethod: docker
      DockerContext: .
      Dockerfile: Dockerfile
    Properties:
      PackageType: Image
      ImageConfig:
        Command:
          - dist/lambda.handler
      Events:
        ApiEvent:
          Type: Api
          Properties:
            Path: /{proxy+}
            Method: ANY

ビルド、ECRへのプッシュ

• sam build --use-container
  • Build Failed
    • Error: Building image for NestLambdaFunction requires Docker. is Docker running?
  • WSL2 上に Docker Engine を直接インストールしている場合
    • sudo service docker start や sudo systemctl start docker などで、Docker デーモンを起動する。
    • docker ps などで正常に動いていることを確認
• sam deploy --guided
  • AWS CLI の設定ファイル: ~/.aws/credentials や ~/.aws/config に複数のプロファイルを定義している場合
    • sam deploy --guided --profile <profileName>
      初回はパラメータ（スタック名、リージョン、ECRリポジトリの自動作成など）を聞かれます。
      デプロイ時に自動で「ビルドしたイメージをECRにプッシュ」→「CloudFormationスタックを作成」→「Lambda + API Gateway」がデプロイ、という流れになります。
• アカウント確認
  • aws sts get-caller-identity
  • aws sts get-caller-identity --profile stg

(オプション) --use-container を使わずにビルドしたい場合

もしどうしても Docker を使わずにビルドしたい場合は、SAM によるコンテナビルドを使わずに ローカルビルド した成果物をそのまま Lambda にデプロイする方法もあります。

• sam build で --use-container を外す (ただし、Node.js のバージョンなどがローカル環境と Lambda ランタイムで整合性が取れていないとビルド結果が動かない可能性がある)
• 自分でビルドしたディレクトリを sam deploy --template template.yaml --guided などでデプロイ

しかし、コンテナイメージ形式でデプロイするなら sam build --use-container が望ましく、やはり Docker が必要になります。

Swagger UI 内から API を叩く設定（CORS など）

CORS 設定

• Lambda (Nest.js) 側で app.enableCors() や適切な CORS 設定を行っているか確認してください。
• API Gateway 側でも、必要に応じて CORS を許可する設定が求められる場合がありますが、ANY /{proxy+} + Nest であれば、基本的には Nest 側の CORS 設定を有効にしておけば十分です。

Swagger の servers セクション

• Swagger UI から「Try it out」を押した際に、どのベースURLにリクエストを送るかが決まります。
• デフォルトでは相対パス or localhost:3000 などになっていると、デプロイ先の API を正しく叩けないかもしれません。
• その場合は、DocumentBuilder() の addServer() などで実際のデプロイ URL を指定するか、あるいは相対パスに調整してください。
• 例:

const config = new DocumentBuilder()
  .setTitle('My API')
  .addServer('/') // 相対パスで同じドメインにリクエスト
  // or
  // .addServer('https://xxxxxx.execute-api.ap-northeast-1.amazonaws.com')
  .build();

• 多くの場合は 相対パス指定 にしておくと、Swagger UI を開いている URL と同じドメイン配下にリクエストを送るため、追加の設定なく動きやすいです。