nightly rocket_lamb

A crate to allow running a Rocket webserver as an AWS Lambda Function with API Gateway

8 releases (5 breaking)

0.6.0 Sep 1, 2019
0.5.0 Sep 1, 2019
0.4.0 Aug 24, 2019
0.3.1 Jul 30, 2019
0.1.1 Jul 28, 2019

MIT license

24KB
337 lines

🚀 Rocket Lamb 🐑

Travis (.org) Crates.io

A crate to allow running a Rocket webserver as an AWS Lambda Function with API Gateway, built on the AWS Lambda Rust Runtime.

The function takes a request from an AWS API Gateway Proxy and converts it into a LocalRequest to pass to Rocket. Then it will convert the response from Rocket into the response body that API Gateway understands.

This should also work with requests from an AWS Application Load Balancer, but this has not been tested.

Usage

#![feature(proc_macro_hygiene, decl_macro)]

#[macro_use] extern crate rocket;
use rocket_lamb::RocketExt;

#[get("/")]
fn hello() -> &'static str {
    "Hello, world!"
}

fn main() {
    rocket::ignite()
        .mount("/hello", routes![hello])
        .lambda() // launch the Rocket as a Lambda
        .launch();
}

For a full example including instructions on deploying to Lambda and configuring binary responses, see Example Rocket Lamb API.

Dependencies

~18–25MB
~387K SLoC