AWS Lambda function template in Go

Overview

This AWS Lambda function template in Go

• implements HTTP routing using Gorilla/Mux
• reads configuration from environment variables
• it can also be run as a stand-alone web server
• the standalone web server can also read configuration from a file
• uses viper to allow YAML, JSON and other configuration file types.

How to start developing with the template

The template runs as-is as a "Hello world" application. Add your custom code at the "// Todo:" comments to make it useful.

• Build your functionality for the / page in the MainHandler function.
• Create additional web Handler functions and register them as a Gorilla/Mux route in the AddRoutes function.
• Set configuration defaults for unset variables in the main function.
• Set a version number in the main function.

Build

make build

Run

build/aws-lambda-go-template -webserver

• it will run the local webserver on port 3000 by default.

curl localhost:3000

How to deploy

The terraform folder creates a deployment example to AWS using Hashicorp Terraform.

1. Set up your AWS API credentials.
2. run make build-linux deploy

Terraform will print you the API Gateway link. Try curl -X POST <link> to see it in action.