SW.Serverless

SW.Serverless is an open-source .NET framework for building and running serverless adapters and services. It provides a runtime environment for executing .NET applications as serverless functions with process isolation and communication through stdin/stdout.

NuGet Packages

Package	Version	Downloads
SimplyWorks.Serverless
SimplyWorks.Serverless.Sdk

What's Included

• SW.Serverless: Core serverless service library with dependency injection extensions for ASP.NET Core
• SW.Serverless.Sdk: SDK for developing serverless adapters with the Runner class and logging utilities
• SW.Serverless.SampleWeb: Example ASP.NET Core web application showing integration
• SW.Serverless.Installer: Command-line tool for packaging and deploying adapters to cloud storage

Quick Start

Install NuGet Packages

dotnet add package SimplyWorks.Serverless
dotnet add package SimplyWorks.Serverless.Sdk

Add to ASP.NET Core

// In Startup.cs or Program.csservices.AddServerless();

Create an Adapter

usingSW.Serverless.Sdk;classHandler{publicasyncTask<string>ProcessData(stringinput){// Your serverless logic herereturn$"Processed: {input}";}}classProgram{staticasyncTaskMain(string[]args)=>awaitRunner.Run(newHandler());}

Features

• Process Isolation: Each adapter runs in its own process with timeout management
• Cloud Storage Integration: Support for AWS S3, Azure Storage, and Oracle Cloud
• Dependency Injection: Built-in integration with ASP.NET Core DI container
• Logging: Structured logging support through AdapterLogger
• Caching: Adapter metadata caching with configurable duration
• Version Management: Semantic versioning support for adapter deployments

Architecture

The framework consists of:

1. ServerlessService: Manages adapter lifecycle, installation, and invocation
2. Runner: Entry point for adapter applications with command processing
3. Installer: CLI tool for building and deploying adapter packages
4. Cloud Storage: Abstraction layer for different cloud storage providers

Support

For issues, questions, or contributions, please visit the GitHub repository.