MacroLambda

AWS Lambda API Gateway Support for Macro and MacroExpress (and all things built on-top).

It allows deployment of arbitrary Macro applications as AWS Lambda functions, including MacroApp endpoints.

Blog article: Deploying Swift on AWS Lambda.

The module is split into the MacroLambda module, which provides the Express runner (Lambda.run(express-app)) and MacroLambdaCore which only links against http and provides the lambda.createServer (the peer to http.createServer).

There is a tutorial on getting started with those things: Create your first HTTP endpoint with Swift on AWS Lambda.

Note: The Swift Lambda Runtime requires Swift 5.2.

Example

import MacroLambda

let app = Express()

app.use(bodyParser.text())

app.post("/hello") { req, res, next in
  console.log("Client posted:", req.body.text ?? "-")
  res.send("Client body sent: \(req.body.text ?? "~nothing~")")
}

app.get { req, res, next in
  res.send("Welcome to Macro!")
}

Lambda.run(app)

Deployment

Using swift lambda (brew install SPMDestinations/tap/swift-lambda):

$ swift lambda deploy -d 5.2

Tutorial available: Deploying Swift on AWS Lambda.

Environment Variables

• macro.core.numthreads
• macro.core.iothreads
• macro.core.retain.debug
• macro.concat.maxsize
• macro.streams.debug.rc

Links

• Deploying Swift on AWS Lambda
• WWDC 2020: Use Swift on AWS Lambda with Xcode
• Tutorial: Create your first HTTP endpoint with Swift on AWS Lambda
• Swift AWS Lambda Runtime
• Amazon Web Services API Gateway
• µExpress
• SwiftNIO

Who

Macro is brought to you by the Always Right Institute and ZeeZide. We like feedback, GitHub stars, cool contract work, presumably any form of praise you can think of.

There is a #microexpress channel on the Noze.io Slack. Feel free to join!