Golang AWS SAM Lambda example
This example project shows how to use AWS SAM with two Golang Lambdas.
Files
cmd
holds the executables that can be built and put into AWS Lambdas.cmd/one
andcmd/two
are distinctly different Lambdas that handle different API URL paths.util
is a helper package that exports typed & wrapped HTTP Lambda interfaces to implement. It's helpful to have the input and outputs as typed Go structures, rather than[]byte
.template.yml
is a template used by AWS SAM for local deployments. AWS SAM can also use this template to deploy to production, but that's not covered in this example project.
Lambda one
This Lambda has shows how to handle environment variables and HTTP request metadata like the requester's source IP. It also has an external API request example.
Its HTTP method is GET
.
Example curl
:
$ curl http://localhost:3000/one
{
"customString": "This is a value from an environment variable for Lambda one.",
"randomPokemon": "raikou",
"sourceIP": "127.0.0.1",
"time": "2022-01-13T17:42:22.839696271Z",
"userAgent": "Custom User Agent String"
}
Lambda two
This Lambda shows how to use custom path parameters and how data can be saved across a single Lambda instance's invocations.
Its HTTP method is POST
.
Example curl
:
$ curl --request POST http://localhost:3000/two/monkey
{
"customPath": "monkey",
"prevCustomPath": ""
}
Debugging
Confirm dlv
is installed:
go install github.com/go-delve/delve/cmd/dlv@latest
Go remote debugging must be started shortly before or after AWS SAM gets a request. If a breakpoint is triggered, dlv
or the compatible IDE can control and inspect the execution.
Due to and AWS SAM bug and the lack of support for building Go Lambda in containers, newer operating systems such as Ubuntu 21.04+ and Fedora 35+ will not be able to use AWS SAM's remote debugging feature. This has to do with the glibc
version. See this GitHub issue.
Error: We do not support building Go Lambda functions within a container. Try building without the container. Most Go functions will build successfully.
Troubleshooting
General
The wrong HTTP method was used, but the Lambda still processed the request
AWS API Gateway request routing is pretty flexible, don't expect the request routing rules in template.yml
or an OpenAPI specification to be followed strictly by API Gateway.
Switching the Lambda to use API Gateway V2 makes some parts of the request empty
This is because AWS SAM is only giving the API Gateway V1 format. I think Type: "AWS::Serverless::Function"
needs to be changed in template.yml
to something that indicates it's a Lambda that is triggered by API Gateway V2. It might also be the type of ApiEvent
. I'm not sure if AWS SAM supports that use case yet.
Lambda one
Custom User Agent String
The User Agent returned is always I think this is specific to AWS SAM. I believe the developers didn't include logic to extract that from the request.
trubbish API
The Pokemon returned is always This means the Lambda was unable to successfully get a Pokemon from an external API.
This could be because it failed to connect over the internet. But a more likely scenario is a known bug in AWS SAM. This bug causes AWS SAM to always pass an expired context.Context
to the Lambda handler. Since the context is always expired before the request is sent, it will never send.
Please downgrade AWS SAM to version 1.12.0
. See this GitHub issue.
Lambda two
prevCustomPath
returned by the API is always an empty string or seemingly wrong
The value of This is because AWS SAM spins up and spins down a single Lambda instance for every request. In production AWS will spin up Lambdas until the number of requests per second coming in dictate that instances should be spun down. This is an example of how data can be shared across invocations, but not instances.