RFC: Serverless Starters for Azure Functions, AWS Lambda, and Cloudflare Workers

[kamranayub]

Hey all!

Excited to share an early preview of some upcoming serverless starter templates we've been building to make it easier to quickly create new serverless projects on Azure, AWS, and Cloudflare connected to RavenDB.

Supported Integrations

Cloudflare Workers

This is a cool one -- the Cloudflare template will let you create Workers that can talk to RavenDB. One of the major benefits of Cloudflare Workers is that they have zero cold starts, so they're really fast.

The RavenDB Node.js SDK had to be updated to support the unique nature of using mTLS certificates with Cloudflare, so it only works in ravendb@5.2.10 or greater. The template is already set up with everything to make that work out-of-the-box.

Azure Functions (Node.js and C#)

The Azure Functions templates have an HTTP trigger-based example in both Node.js and .NET C# through the Functions v4 host/SDK. They also have an ARM deployment template. By default, they are using Windows-based consumption plans but can support Linux (some documented caveats apply).

AWS Lambda (C#)

The AWS Lambda template is a .NET 6 Minimal Web API function with AWS Lambda hosting. There may be a Cloudformation template added.

GitHub Actions CI/CD

All templates are configured with CI/CD capabilities through GitHub Actions, if you want.

Preview Content

These links below all link to WIP or preview content subject to change; but they're mostly finished.

Video Tutorials

For those who prefer video walkthroughs with step-by-step commentary, the videos will be uploaded to YT and embedded in the docs/templates soon.

GitHub Templates

For those who prefer to jump right in with a little bit of guidance, here are the 2 template repositories:

• Azure & AWS: https://github.com/ravendb/templates
• Cloudflare: https://github.com/ravendb/template-cloudflare-worker

The READMEs for each template have the essential getting started steps, and each template itself also has steps when you boot it up. The format and details of the README will likely be updated as we get closer to finalizing everything.

How-to Guides

For those who prefer a detailed step-by-step written guide, there are several open PRs to the docs with the new contributed integration guides:

• Docs: Using Cloudflare Workers with RavenDB
• Docs: Using Azure Functions with RavenDB (C# & Node.js)
• Docs: Using AWS Lambda with RavenDB (C#)

Each PR lists anything that still needs to be addressed.

Known Issues

These are known enhancements/issues to address for QA:

• Add docs/steps to integrate RavenDB-related plumbing into existing projects for each type
• Update AWS/Azure videos to showcase using PEM certificate through environment when deployed instead of deploying physical PFX files
• Update Azure template to include optional placeholder Key Vault integration to match AWS Lambda Secrets Manager support.
• Update AWS template with Cloudformation or SAM (or both)
• Link up videos/docs for each template's welcome screen

Where to Leave Feedback

You can leave feedback here in the Discussion thread, in the PRs, or in the video review tool. We'd love to hear what you think, and if you try them out, what you liked or what issues you run into!