serverless swift

A ⚡ Serverless framework ⚡ plugin for Swift applications

📦 Install

Install the plugin with npm

$ npm i -D serverless-swift

💡 This serverless plugin assumes you are building Swift lambdas targeting the AWS Lambda "provided" runtime.

Add the following to your serverless project's serverless.yml file

service: demo

provider:
  name: aws
  runtime: swift

plugins:
  - serverless-swift

functions:
  test:
    # handler value syntax is `{your-executable-binary}.{bin-name}`
    # or `{your-executable-binary}` for short when you are building a
    # default bin for a given package.
    handler: <your-executable-binary>

The build needs to generate a swift executable. The name of the executable will either be the Swift project parent folder name by default or specified in the Package.swift file. Remember to place that instead of above.

On every deploy a prebuilt AWS Lambda Layer is attached automatically to every swift functions. The layer adds required dependencies to run a compiled Swift executables in a Lambda.

🙌 Acknowledgements

This project has been possible thanks to the following people:

• Doug Tangren : https://github.com/softprops/serverless-rust
• Andrea Scuderi : https://github.com/swift-sprinter/aws-lambda-swift-sprinter-core
• Fabian Fett: https://github.com/fabianfett/swift-lambda-runtime