こんにちは。はやしです！
最近サーバレスなAPIをローカルで開発する際に、以下を実現する良い方法はないかと検証していました。
- ローカル上での動作確認
- ホットリロードを使いながら開発
- 上記をネイティブ機能&軽量なソリューションで実現。

「Serverless Framework」「AWS SAM」「Serverless Express」の検証して、個人的に最も良いと感じた「Severless Express」を今回記事にしたいと思います。

※「AWS SAM」はそもそも2022年12月29日時点ではホットリロードに対応していませんでした。

# Expressのディレクトリ構成
![](https://kokosyna-post-bucket-prd.s3.ap-northeast-1.amazonaws.com/012e8bb8-aac0-4d7b-af56-df4424421d9e.webp)
- middleware/local.ts・・・ローカル実行で使用する
- middleware/lambda.ts・・・Lambdaで実行する際に使用する
- src/app.ts・・・共通で使用するサーバー本体

# 実装
## API Gateway + Lambdaの実装(AWS CDK)
```typescript:agw-express-stack.ts
import * as cdk from "aws-cdk-lib";
import { Construct } from "constructs";
import * as apigateway from "aws-cdk-lib/aws-apigateway";
import * as lambda from "aws-cdk-lib/aws-lambda";
import { NodejsFunction } from "aws-cdk-lib/aws-lambda-nodejs";

export class AgwExpressStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);
    const fn = new NodejsFunction(this, "Fn", {
      runtime: lambda.Runtime.NODEJS_18_X,
      entry: "src/lambda/agw-express/middleware/lambda.ts",
    });
    new apigateway.RestApi(this, "Api", {}).root.addProxy({
      defaultIntegration: new apigateway.LambdaIntegration(fn),
    });
  }
}
```
「NodejsFunction」でデプロイ時にTypeScriptをコンパイルするようにしています。
また全てルーティングパスはLambdaにリクエストされるようにしています。

## Expressの実装
```typescript:middleware/local.ts
import app from "../src/app";
const port = 3000;
app.listen(port, () => {
  console.info(`listening on http://localhost:${port}`);
});
```
```typescript:middleware/lambda.ts
import serverlessExpress from "@vendia/serverless-express";
import app from "../src/app";

export const handler = serverlessExpress({ app });
```
```typescript:src/app.ts
import "source-map-support/register";
import express, { Request, Response } from "express";

const app = express();
app.use(express.json());

app.get("/", async (_: Request, res: Response) => {
  res.status(200).send({
    message: "hello",
  });
});

export default app;
```
```json:package.json
{
  "name": "agw-express",
  "version": "1.0.0",
  "scripts": {
    "dev": "concurrently \"npx tsc --watch\" \"nodemon -q build/middleware/local.js\""
  },
  "license": "ISC",
  "dependencies": {
    "express": "^4.18.2"
  },
  "devDependencies": {
    "source-map-support": "^0.5.21",
    "@types/source-map-support": "^0.5.6",
    "@vendia/serverless-express": "^4.10.1",
    "@types/aws-lambda": "^8.10.109",
    "@types/express": "^4.17.15",
    "concurrently": "^7.6.0",
    "nodemon": "^2.0.20",
    "typescript": "^4.9.4"
  }
}
```
「@vendia/serverless-express」が今回の主役です。
数行でローカル実行とLambda実行の両方を可能にしてくれます。

# 動作確認
## ローカル実行(ホットリロード)
1.「npm run dev」を実行すると以下のようにサーバーがポート3000で起動する。
![](https://kokosyna-post-bucket-prd.s3.ap-northeast-1.amazonaws.com/f894fdd8-5a46-4f2c-a361-49f2afc1a07b.webp)

2.リンクをクリックすると、ブラウザで「hello」が返ってくる。
![](https://kokosyna-post-bucket-prd.s3.ap-northeast-1.amazonaws.com/e0f2c376-a10f-489d-a868-b6e71f36b173.webp)

3.「hello」を「helloworld」にコード修正する。
```typescript:src/app.ts
import "source-map-support/register";
import express, { Request, Response } from "express";

const app = express();
app.use(express.json());

app.get("/", async (_: Request, res: Response) => {
  res.status(200).send({
    message: "helloworld",
  });
});

export default app;
```

4.ブラウザをリロードすると「helloworld」が返却される。
![](https://kokosyna-post-bucket-prd.s3.ap-northeast-1.amazonaws.com/ffb0c258-edf0-48e8-845b-dbf207172671.webp)

## API Gateway + Lambdaで動作確認
API Gatwayで[GET] / のテストを実行すると、「helloworld」が返却される。
![](https://kokosyna-post-bucket-prd.s3.ap-northeast-1.amazonaws.com/6552d896-2c26-4879-8384-2b2f7f085588.webp)

# まとめ
今までサーバレスアーキテクチャのローカル開発で苦労していましたが、Serverless Expressで解消できそうです。
本記事が皆さんにもお役に立てれば幸いです。
では！👋

AWS Lambda