go-lambda

README

go-lambda

go-lambda is a multi-purpose tool for creating and managing AWS Lambda instances backed by arbitrary Go code. Since there is no official support of Go, this tool automatically generates a wrappig module in Python 2.7 which is able to pass data back and forth to the Go land. Check out an example function.

Features at glance

• <10ms startup time, feels like native experience;
• Resulting source.zip size is only 1.0M and in most cases has 2 files;
• Easy to use: start writing your own lambdas in Go just in few minutes;
• Relies on the official AWS SDK for Go while making all the requests, security is guaranteed;
• No any boilerplate or "all-in-one" aims: the tool is made to do its job and nothing else. Yes, this is also a feature.

Installation

$ go get github.com/xlab/go-lambda

Keep in mind that if you are using something other than Linux x86_64, this tool will invoke the xlab/go-lambda Docker image in order to create cross-platform modules for AWS. Prepare your Docker setup beforehand.

Reference

Usage: go-lambda [OPTIONS] COMMAND [arg...]

A tiny AWS Lambda manager for Go deployments.

Options:
  --verbose=false            Run in verbose mode.
  -v, --version=false        Show the version and exit
  -r, --region="eu-west-1"   Specify the region.

Commands:
  list         Lists all defined AWS Lambda functions in the region.
  regions      Lists regions available for AWS Lambda service.
  info         Gets info about specific AWS Lambda function (specified by ID or NAME).
  source       Gets .zip of an AWS Lambda function source (specified by ID or NAME).
  delete       Deletes an AWS Lambda function (specified by ID or NAME).
  create       Creates an AWS Lambda function and uploads specified Go package as its source.
  update       Updates source of an AWS Lambda function (specified by ID or NAME).

Run 'go-lambda COMMAND --help' for more information on a command.

Examples

List available lambda functions in default region:

$ ./go-lambda list
╭──────────────────────────────────────────────────────────────────────────────────────────╮
│                           AWS LAMBDA FUNCTIONS: 2 (eu-west-1)                            │
├───┬─────────────────┬─────────────────────┬──────────┬───────────┬─────────┬─────────────┤
│ # │ NAME            │ UPDATED             │ SIZE     │ MEM LIMIT │ TIMEOUT │ DESCRIPTION │
├───┼─────────────────┼─────────────────────┼──────────┼───────────┼─────────┼─────────────┤
│ 1 │ xxx-handler     │ 20 Dec 15 11:24 UTC │ 459.22K  │ 128M      │ 3s      │             │
│ 2 │ yyy-handler     │ 19 Dec 15 09:20 UTC │ 384.10K  │ 128M      │ 3s      │             │
╰───┴─────────────────┴─────────────────────┴──────────┴───────────┴─────────┴─────────────╯

Create a new lambda backed by Go code:

$ go-lambda create --role arn:aws:iam::account-id:role/lambda_basic_execution handler github.com/xlab/go-lambda/example

╭───────────────────────────────────────────────────────────────────────────────────────╮
│                    AWS LAMBDA FUNCTION example-handler (eu-west-1)                    │
├──────────────────────┬────────────────────────────────────────────────────────────────┤
│ SHA256 Hash          │ rcUmH7y39GVzmnwEbeV4aCj9e4vkPdoZIF14oj+nyWM=                   │
│ Code Size            │ 1067.95K                                                       │
│ Description          │                                                                │
│ Amazon Resource Name │ arn:aws:lambda:eu-west-1:account-id:function:example-handler   │
│ Handler              │ example-handler.handler                                        │
│ Last Modified        │ 20 Dec 15 14:00 UTC                                            │
│ Memory Size          │ 128M                                                           │
│ Role                 │ arn:aws:iam::account-id:role/lambda_basic_execution            │
│ Runtime              │ python2.7                                                      │
│ Timeout              │ 3s                                                             │
│ Version              │ 25                                                             │
╰──────────────────────┴────────────────────────────────────────────────────────────────╯

Now you can manage your function in the AWS dashboard, create API endpoints and event handlers.

Update existing function after fixing its Go code:

$ go-lambda update example-handler handler github.com/xlab/go-lambda/example

Roadmap

• Replace JSON marshalling with something efficient (maybe);
• Try to convince AWS staff that we need the native Go support in their cloud.

Please, spread the word about go-lambda — let people use their favourite language for AWS Lambda. 🍻

Useful links

• AWS Serverless Multi-Tier Architectures Whitepaper
• Lambda limits
• The Twelve Days of Lambda
• GoSparta Project Limitations

License

MIT