This package provides a custom runtime for AWS Lambda.
This repository provides two libraries:
lambda-runtime
provides a runtime and API for AWS Lambda and API Gateway.- the
vercel
library depends onlambda-runtime
and provides an interface to the Vercel service that resembles a request / response exchange.
The libraries in this repo are released to the OPAM package registry.
You can depend on them via:
- esy:
esy add @opam/lambda-runtime
and / oresy add @opam/vercel
- OPAM:
opam install lambda-runtime vercel
.
See the examples
folder.
Note: Based on the instructions in this blog post and the Rust custom runtime repository
For a custom runtime, AWS Lambda looks for an executable called bootstrap
in
the deployment package zip. Rename the generated basic
executable to
bootstrap
and add it to a zip archive.
The Dockerfile (in conjunction with the build.sh
script) in this
repo does just that. It builds a static binary called bootstrap
and drops it
in the target directory.
$ ./build.sh && zip -j ocaml.zip bootstrap
Now that we have a deployment package (ocaml.zip
), we can use the AWS
CLI to create a new Lambda function. Make sure to
replace the execution role with an existing role in your account!
$ aws lambda create-function --function-name OCamlTest \
--handler doesnt.matter \
--zip-file file:https://./ocaml.zip \
--runtime provided \
--role arn:aws:iam::XXXXXXXXXXXXX:role/your_lambda_execution_role \
--tracing-config Mode=Active
You can now test the function using the AWS CLI or the AWS Lambda console
$ aws lambda invoke --function-name OCamlTest \
--payload '{"firstName": "world"}' \
output.json
$ cat output.json # Prints: {"message":"Hello, world!"}
Copyright © 2018 António Nuno Monteiro
Distributed under the 3-clause BSD License (see LICENSE).