Add docs for Serverless target

[timneutkens]

I need feedback on if this is clear enough for users.

[timneutkens]

This will have to be replaced by the guide @timothyis is writing

[lfades]

LOTM, it's very clear, only lacking more examples for new users, this opens the door to add micro-serverless, [koa/express]-serverless to the examples folder.

[timneutkens]

@lfades yep, totally, however, micro/koa/express-serverless are massive overkill for the Next.js serverless target, as all it needs is req and res from Node.js to render out a page.

The examples that I'd like to see are: AWS lambda, Google Cloud Functions, Azure and maybe Serverless framework

[timneutkens]

For AWS Lambda using https://github.com/awslabs/aws-serverless-express would be enough:

const awsServerlessExpress = require('aws-serverless-express')
const page = require('./.next/serverless/about.js')
const server = awsServerlessExpress.createServer((req, res) => page.render(req, res))

exports.handler = (event, context) => {
  awsServerlessExpress.proxy(server, event, context)
}

Note that I checked the source and it has nothing to do with express, it's a compat layer between event from AWS Lambda and http.Server

[romainquellec]

Someone is brave enough to make these examples ?

[timneutkens]

Feel free to contribute @romainquellec

[lfades]

I would love to do the examples, @romainquellec are you working on them ? - I feel it like a good opportunity to learn more about serverless

[timneutkens]

@lfades feel free to contribute!

[chirag04]

I wish there was a section about debugging and dev workflows in the doc. Since all the code is minified the serverless build directory, it's really impossible to debug what's going on. thoughts? Also not sure if we can do hot reloading/re-building the target when code changes.

[kamleshchandnani]

For AWS Lambda using awslabs/aws-serverless-express would be enough:

const awsServerlessExpress = require('aws-serverless-express')
const page = require('./.next/serverless/about.js')
const server = awsServerlessExpress.createServer((req, res) => page.render(req, res))

exports.handler = (event, context) => {
  awsServerlessExpress.proxy(server, event, context)
}

Note that I checked the source and it has nothing to do with express, it's a compat layer between event from AWS Lambda and http.Server

But what if I want to add express as a middleware so that I can use multiple middlewares compression, helmet etc. for my app

[fbn4sc]

For AWS Lambda using awslabs/aws-serverless-express would be enough:

const awsServerlessExpress = require('aws-serverless-express')
const page = require('./.next/serverless/about.js')
const server = awsServerlessExpress.createServer((req, res) => page.render(req, res))

exports.handler = (event, context) => {
  awsServerlessExpress.proxy(server, event, context)
}

Note that I checked the source and it has nothing to do with express, it's a compat layer between event from AWS Lambda and http.Server

But what if I want to add express as a middleware so that I can use multiple middlewares compression, helmet etc. for my app

Were you able to find an answer? I'm facing the same problem right now.