AWS Golang Lambda With API Gateway

This example lives in the pulumi/examples repository. Check out just this directory to use it:

$ git clone --filter=blob:none --sparse https://github.com/pulumi/examples pulumi-examples
$ git -C pulumi-examples sparse-checkout set aws-go-lambda-gateway
$ cd pulumi-examples/aws-go-lambda-gateway

This example creates a lambda that does a simple ToUpper on the path input of an API request and returns it.

Deploying the App#

To deploy your infrastructure, follow the below steps.

Prerequisites#

1. Install Pulumi
2. Configure AWS Credentials
3. Clone aws-go-lambda

Steps#

After cloning this repo, run these commands from the working directory:

1. Build the handler:

   • For developers on Linux and macOS:

     make build

   • For developers on Windows:

     • Get the build-lambda-zip tool:

       set GO111MODULE=on
       go.exe get -u github.com/aws/aws-lambda-go/cmd/build-lambda-zip

     • Use the tool from your GOPATH:

       set GOOS=linux
       set GOARCH=amd64
       set CGO_ENABLED=0
       go build -o handler\handler handler\handler.go
       %USERPROFILE%\Go\bin\build-lambda-zip.exe -o handler\handler.zip handler\handler

2. Create a new Pulumi stack, which is an isolated deployment target for this example:

   pulumi stack init

3. Set the required configuration variables for this program:

   $ pulumi config set aws:region us-west-2

4. Execute the Pulumi program to create our lambda:

   $ pulumi up
   Previewing update (dev):
     Type                           Name               Plan
   +   pulumi:pulumi:Stack            go-lambda-dev      create
   +   ├─ aws:apigateway:RestApi      UpperCaseGateway   create
   +   ├─ aws:iam:Role                task-exec-role     create
   +   ├─ aws:apigateway:Resource     UpperAPI           create
   +   ├─ aws:iam:RolePolicy          lambda-log-policy  create
   +   ├─ aws:apigateway:Method       AnyMethod          create
   +   ├─ aws:lambda:Function         basicLambda        create
   +   ├─ aws:lambda:Permission       APIPermission      create
   +   ├─ aws:apigateway:Integration  LambdaIntegration  create
   +   └─ aws:apigateway:Deployment   APIDeployment      create
   
   Resources:
     + 10 to create
   
   Do you want to perform this update? yes
   Updating (dev):
     Type                           Name               Status
   +   pulumi:pulumi:Stack            go-lambda-dev      created
   +   ├─ aws:apigateway:RestApi      UpperCaseGateway   created
   +   ├─ aws:iam:Role                task-exec-role     created
   +   ├─ aws:apigateway:Resource     UpperAPI           created
   +   ├─ aws:iam:RolePolicy          lambda-log-policy  created
   +   ├─ aws:apigateway:Method       AnyMethod          created
   +   ├─ aws:lambda:Function         basicLambda        created
   +   ├─ aws:apigateway:Integration  LambdaIntegration  created
   +   ├─ aws:lambda:Permission       APIPermission      created
   +   └─ aws:apigateway:Deployment   APIDeployment      created
   
   Outputs:
     invocation URL: "https://<gateway-id>.execute-api.us-west-2.amazonaws.com/prod/{message}"
   
   Resources:
     + 10 created
   
   Duration: 29s

5. Call our lambda function from the cli:

   curl https://<gateway-id>.execute-api.us-west-2.amazonaws.com/prod/helloworld
   HELLOWORLD%

6. From there, feel free to experiment. Simply making edits, rebuilding your handler, and running pulumi up will update your lambda.

7. Afterwards, destroy your stack and remove it:

   pulumi destroy --yes
   pulumi stack rm --yes