aws

Serverless AWS Documentation

Check out the Getting started guide and the CLI reference for an introduction to Serverless.

Setup and configuration

Please follow these setup instructions to start using AWS Lambda and serverless together

Provider configuration

Following are examples and descriptions of all available AWS specific provider configuration settings.

provider:
  name: aws # Set the provider you want to use, in this case AWS
  runtime: nodejs4.3 # Runtime used for all functions in this provider
  stage: dev # Set the default stage used. Default is dev
  region: us-east-1 # Overwrite the default region used. Default is us-east-1
  deploymentBucket: com.serverless.${self:provider.region}.deploys # Overwrite the default deployment bucket
  variableSyntax: '\${{([\s\S]+?)}}' # Overwrite the default "${}" variable syntax to be "${{}}" instead. This can be helpful if you want to use "${}" as a string without using it as a variable.

Deployment S3Bucket

The bucket must exist beforehand and be in the same region as the deploy.

Additional function configuration

functions:
  hello:
    name: ${self:provider.stage}-lambdaName # Deployed Lambda name
    description: Description of what the lambda function does # Description to publish to AWS
    handler: handler.hello # handler set in AWS Lambda
    memorySize: 512 # optional, default is 1024
    timeout: 10 # optional, default is 6

General Configuration

• Configuring IAM resources
• VPC configuration
• Cloudformation Resource naming reference

AWS events

• API Gateway
• S3
• Schedule
• SNS
• Kinesis Streams
• Dynamodb Streams

Examples

See the examples folder for all AWS serverless examples

• hello-world
• using-external-libraries
• web-api

To add examples, fork this repo and submit a pull request