AWS Lambda で Hono を実行するためのテンプレート。
最大の特徴として、Parameter Store から設定を取得することができます。
デプロイには SAM(aws-sam-cli) を利用していますが、SAM 依存のコードではないため CDK や Terraform でもデプロイできます。
Hono の aws-lambda adapter が素晴らしく、これだけで API Gateway V2 だけでなく、ALB や 旧 API Gateway と連携して使えるようになります。(※)
※
sam local invoke
には対応していません(2024/06 現在)
npm run dev
sam validate --lint
sam build
sam deploy --guided
AWS Systems Manager の Parameter Store から設定を取得することができます。
パラメータを取得するためには、環境変数 AWS_SSM_PARAMETER_PATH
を設定してください。
パラメータ名の最後の部分が環境変数名になります。
例えば、/hono/adapter/lambda/VARIABLE
というパラメータがある場合、
AWS_SSM_PARAMETER_PATH
に /hono/adapter/lambda/
を設定することで、
VARIABLE
という環境変数が設定されます。
-
BASE_PATH
- ルーティングのルートパスを指定します。デフォルトは
/
です。 既存の ALB にアタッチする場合など、パスルーティングする場合などに便利です。
- ルーティングのルートパスを指定します。デフォルトは
-
AWS_SSM_PARAMETER_PATH
- 環境変数を取得するための SSM Parameter Store パス起点。パラメータストアでの設定参照。